Back to Discover

dados-b3-mcp

connector

Val7h

Brazilian stock (B3) fundamentals: ratios, multiples, dividends, scores. Public methodology.

View on GitHub
0 starsSynced Aug 11, 2026

Install to Claude Code

/plugin marketplace add Val7h/dados-b3-mcp

README

Dados B3 — servidor MCP (bolsa brasileira, fundamentos auditáveis)

Conector MCP que dá ao seu agente de IA (Claude, ChatGPT, Cursor e outros) acesso a dados fundamentalistas de 400+ companhias abertas brasileiras (B3) — inclusive bancos e seguradoras —, de 2010 até hoje, com metodologia 100% pública: ROE, ROIC, margens, crescimento, dívida líquida/EBITDA, múltiplos ponto-no-tempo (P/L, P/VP, EV/EBITDA com o preço do 1º pregão após a publicação real do balanço — sem look-ahead, próprio para backtest), dividendos e dividend yield, scores prontos (Piotroski F-Score e Graham) e histórico de reapresentações de balanço.

Fonte: CVM (dados abertos, ODbL) e B3 (COTAHIST). Cada número carrega a conta CVM de origem; nada é publicado sem uma bateria de testes de invariantes passando (o balanço fecha, a DRE fecha, o preço nunca antecede a publicação). Produto e planos: https://dadosb3.com

Uso 1 — remoto (nada para instalar, recomendado)

Adicione este conector remoto ao seu cliente de IA:

https://dadosb3.com/mcp/

No Claude: Configurações → Conectores → adicionar conector personalizado → cole a URL.

Uso 2 — local (stdio)

pip install -r requirements.txt
python server.py

Config de exemplo para um cliente MCP local:

{
  "mcpServers": {
    "dados-b3": {
      "command": "python",
      "args": ["server.py"],
      "env": { "DADOS_B3_API_KEY": "sua_chave_opcional" }
    }
  }
}

Ferramentas

FerramentaO que fazGrátis?
listar_empresas400+ companhias, incl. bancos/seguradoras (nome, CNPJ, ticker)sim
indicadores_anuaisROE, ROIC, margens, crescimento, DL/EBITDA (16 anos)WEGE3 sim; demais com chave
multiplosP/L, P/VP, EV/EBITDA ponto-no-tempo; P/L TTMWEGE3 sim; demais com chave
dividendosproventos, resumo anual e dividend yield 12mWEGE3 sim; demais com chave
scoresPiotroski F-Score (0-9, cada critério aberto) e critério de GrahamWEGE3 sim; demais com chave
reapresentacoesbalanços republicados — versão antiga × nova lado a ladoWEGE3 sim; demais com chave
fatos_contabeiscontas padronizadas com a conta CVM de origem (anual/trimestral)WEGE3 sim; demais com chave
screenerfiltra as empresas por faixas de indicadorescom chave
dicionariofórmula, conta CVM e base do lucro de cada indicador (JSON)sim
metodologiafórmulas públicas de cada indicadorsim
saudecobertura atual do bancosim

A empresa WEGE3 e a metodologia são abertas para degustação, sem chave. Para as demais, crie uma chave grátis (200 consultas/dia, sem cartão) ou assine o Pro (R$ 49,90/mês) em https://dadosb3.com e passe a chave no argumento chave_api (ou na variável DADOS_B3_API_KEY).

Bancos e seguradoras

Instituições financeiras têm plano de contas próprio (não há EBIT nem receita de venda). O conector as classifica pelo plano de contas real e entrega os indicadores que fazem sentido — ROE, margem, crescimento, P/L, P/VP, dividendos — e não publica ROIC/EBITDA/EV-EBITDA para elas (não se aplicam). Ex.: Itaú, Bradesco, Banco do Brasil, BB Seguridade, IRB.

Por que este e não outro

Metodologia 100% pública, testes de invariantes antes de cada publicação, múltiplos sem vazamento de informação futura, e histórico de reapresentações registrado (quando a empresa republica um balanço, as duas versões ficam lado a lado) — coisas que nenhuma outra API de dados da B3 faz. Comparativo honesto, inclusive onde os concorrentes são melhores: https://dadosb3.com/comparativo

Licença

MIT (este conector). Os dados são públicos (CVM/B3); o serviço adiciona padronização, metodologia e testes.

Rendered live from Val7h/dados-b3-mcp's GitHub README — not stored, always reflects the source repo.

1 Install Method

NameDescriptionCategorySource
streamable-http remoteHosted streamable-http endpointmcp-serverhttps://dadosb3.com/mcp/

0 Comments

Login required
Log in to post a comment or update on this repo.

No comments yet — be the first to share an update.