MCP + GPT Actions

Dados financeiros
direto na IA

Monte carteiras, analise balanços, compare setores e cruze indicadores macro com fundamentos. Funciona no Claude, ChatGPT, Cursor e qualquer cliente MCP. Veja o guia completo de instalação e configuração para detalhes técnicos do servidor MCP.

Claude
ChatGPT
Claude Code
Cursor
Configurar agora Docs

Claude Desktop

via MCP

ChatGPT

via GPT Actions

Claude Code

via MCP

Cursor

via MCP

Configure em minutos

Escolha sua plataforma e siga os passos.

1

Crie sua chave de API

Cadastre-se gratuitamente e gere sua chave no dashboard.

usebolsai.com/dashboard →
2

Instale o pacote

$ pip install bolsai-mcp

Código aberto: github.com/viniciuslazzari/bolsai-mcp · pypi.org/project/bolsai-mcp

3

Configure o Claude

Adicione ao arquivo de configuração do Claude Desktop, Claude Code ou Cursor:

claude_desktop_config.json 
{
  "mcpServers": {
    "bolsai": {
      "command": "uvx",
      "args": ["bolsai-mcp"],
      "env": {
        "BOLSAI_API_KEY": "sk_sua_chave_aqui"
      }
    }
  }
}
1

Crie sua chave de API

Cadastre-se gratuitamente e gere sua chave no dashboard.

usebolsai.com/dashboard →
2

Crie um GPT personalizado

Abra o editor de GPTs no ChatGPT.

chatgpt.com/gpts/editor →
3

Importe o schema de Actions

Na aba Actions, clique em Import from URL e cole:

https://usebolsai.com/gpt-actions-schema.json
4

Configure a autenticação

Ainda na aba Actions, configure autenticação tipo OAuth:

Authorization URL
https://usebolsai.com/api/v1/oauth/authorize

Token URL
https://usebolsai.com/api/v1/oauth/token
5

Salve e publique

Clique em Save e seu GPT estará pronto para usar com dados reais da B3.

Nota: A criação de GPTs personalizados requer o plano ChatGPT Plus (US$ 20/mês).

10 ferramentas

Pergunte em linguagem natural. A IA escolhe a ferramenta certa automaticamente.

screen_stocks

Screening

Filtre ações por métricas fundamentalistas: DY, P/L, ROE e mais.

"Ações com ROE acima de 20% e P/L abaixo de 10 no setor financeiro"

compare_stocks

Comparação

Comparação lado a lado de até 5 ações com métricas selecionáveis.

"Compare os 3 maiores bancos: ITUB4, BBDC4 e BBAS3. Quem tem melhor ROE e margem?"

get_fundamentals

Fundamentos

27+ indicadores: P/L, P/VP, EV/EBITDA, ROE, margens, dívida.

"A Petrobras está barata? Analise os múltiplos e compare com a média do setor"

get_dividends

Dividendos

Histórico de dividendos e JCP com DY, resumo anual e pagamentos.

"Monte uma carteira de dividendos com 5 ações que paguem consistentemente acima de 6% ao ano"

get_financial_statements

Demonstrações financeiras

DRE, balanço patrimonial e fluxo de caixa da CVM.

"Analise a evolução da margem líquida e endividamento da WEGE3 nos últimos 3 anos"

get_fii_details

FIIs

Fundamentos e distribuições mensais de fundos imobiliários.

"Quais FIIs de logística estão abaixo do valor patrimonial e pagam mais de 0.8% ao mês?"

get_price_history

Histórico de preços

Preços OHLCV diários desde 1986 ajustados por splits e dividendos.

"Qual foi o drawdown máximo da VALE3 em 2024? E quanto tempo levou pra recuperar?"

get_macro_indicator

Indicadores macro

SELIC, IPCA, CDI e USD/BRL com séries históricas do BCB.

"Com a SELIC atual, faz sentido investir em ações com DY de 8% ou é melhor renda fixa?"

get_stock_quote

Cotação atual

Preço, variação diária, range 52 semanas e retorno YTD.

"PETR4 está perto da máxima de 52 semanas? Qual o retorno no ano?"

search_companies

Busca de empresas

Encontre empresas por nome ou setor listadas na B3.

"Liste as empresas de energia elétrica e me diga quais são as mais baratas por EV/EBITDA"

Veja na prática

Análise completa de carteira de dividendos em uma conversa.

Quero montar uma carteira de dividendos. Encontre ações com DY acima de 6%, ROE acima de 15% e dívida controlada. Analise os dividendos dos últimos 3 anos pra ver se são consistentes.

screen_stocks → get_dividends → compare_stocks 
# 1. Screening por DY > 6% e ROE > 15%
12 ações encontradas, filtrei 5 com dívida líquida/EBITDA < 2:

# 2. Histórico de dividendos (3 anos)
               2024      2023      2022    Consistência
BBAS3        9.12%     8.40%     7.80%    ✓ crescente
PETR4       12.30%    18.20%     8.90%    ⚠ volátil (depende do petróleo)
TAEE11       8.50%     9.10%     8.80%    ✓ estável
BBSE3        7.20%     6.80%     6.50%    ✓ crescente
CPLE6        6.80%     7.20%     5.90%    ✓ estável

# 3. Comparação de múltiplos
               P/L    P/VP     ROE    Dív/EBITDA
BBAS3         4.56    0.98   21.3%         —
TAEE11        8.23    1.67   19.8%      1.2x
BBSE3         9.10    3.21   35.2%      0.0x
CPLE6         5.89    1.12   18.5%      1.8x

Recomendação: BBAS3, TAEE11, BBSE3 e CPLE6 mostram dividendos consistentes nos últimos 3 anos. Excluí PETR4 — apesar do DY alto, o histórico é volátil e depende do preço do petróleo. BBSE3 se destaca com ROE de 35% e zero dívida.

Com a SELIC atual, faz sentido essa carteira ou é melhor ficar na renda fixa?

get_macro_indicator("selic") → compare com DY da carteira 
SELIC atual: 14.25% a.a. (CDI ~14.15%)

DY médio da carteira:   7.90%
Spread vs CDI:          -6.25 p.p.

Porém: ações têm potencial de ganho de capital.
P/VP médio da carteira: 1.74x
BBAS3 negocia abaixo do valor patrimonial (P/VP 0.98).

Análise: O DY de 7.9% perde para o CDI de 14.15% em retorno puro. Mas BBAS3 está descontado (P/VP 0.98) e os dividendos tendem a crescer. Uma alocação 60% renda fixa + 40% dividendos captura o CDI alto e posiciona para quando a SELIC cair.

O plano gratuito inclui cotações e fundamentos atuais (200 req/dia). Para histórico, dividendos, demonstrações e macro, assine o Pro por R$ 49/mês.

Ver planos

Perguntas frequentes

O que é o MCP (Model Context Protocol)?

MCP é um protocolo aberto que conecta assistentes de IA como Claude a fontes externas de dados e ferramentas. O servidor bolsai-mcp expõe 10 ferramentas de dados financeiros da B3 que o Claude pode chamar durante uma conversa, sem precisar copiar e colar dados manualmente.

Como uso a bolsai no Claude Desktop?

Instale o pacote com pip install bolsai-mcp, gere sua chave de API gratuita no dashboard e adicione a configuração ao arquivo claude_desktop_config.json, conforme o passo a passo acima.

Funciona com ChatGPT?

Sim, via GPT Actions. Importe o schema em https://usebolsai.com/gpt-actions-schema.json ao criar um GPT personalizado e configure a autenticação OAuth com as URLs de autorização e token da bolsai. A criação de GPTs personalizados requer o plano ChatGPT Plus.

Quais dados a IA consegue acessar?

As 10 ferramentas cobrem ações e FIIs da B3: fundamentos (27+ indicadores como P/L, P/VP, ROE, EV/EBITDA), cotações e histórico de preços, dividendos, demonstrações financeiras da CVM, screener por múltiplos, comparação entre ativos e indicadores macro do Banco Central (SELIC, IPCA, CDI).

É gratuito?

O plano gratuito cobre cotações e fundamentos atuais, com 200 requisições por dia. Para histórico de preços, dividendos, demonstrações financeiras e dados macro, é necessário o plano Pro (R$ 49/mês). Veja a página de preços para detalhes.

Leia também