Dados B3 MCP Server

Dados B3 — MCP server for the Brazilian stock market (B3)

Official site: https://dadosb3.com/?de=github · Remote MCP endpoint: https://dadosb3.com/mcp/ · Methodology · Connection guide · llms.txt

Português abaixo

dadosb3.com is the only official address of the project. The old address on onrender.com is retired; anything that still points there is out of date.

Keywords: B3, Bovespa, Brazilian stock market, Brazilian stocks (ações brasileiras), dividends (dividendos, proventos), FII (Brazilian REITs, fundos imobiliários), ETFs, BDRs, CVM filings, delisted companies (deslistagem), fundamentals, point-in-time multiples, MCP, Model Context Protocol.

At a glance (checked against the live server on 2026-11-06)

Methodology and lineage

Every number carries the CVM account it came from. Each indicator page links down to the line of the CVM file, e.g. ITUB4 ROE 2025. Formulas: methodology and the JSON dictionary. Audit it yourself with your own seed: dadosb3.com/auditoria (or the auditar_amostra tool). Invariant tests run before every release: transparency page.

Example questions

• "How much did PETR4 pay in dividends over the last 12 months, with ex-dates?" → dividendos
• "Which companies left B3 in 2026, and what did they pay before leaving?" → saiu_da_bolsa, dividendos
• "Itaú's 2025 ROE, with the CVM accounts behind it" → indicadores_anuais
• "FIIs with the highest 12-month yield and P/B below 1" → fiis_ranking, fii
• "Was WEGE3 worth it over 5 years, against the Ibovespa and Selic?" → desempenho
• "What did R$ 1,000 in ITUB4 return?" → quanto_rendeu

What it is

An MCP connector that gives your AI agent (Claude, ChatGPT, Cursor and others) access to fundamentals for Brazilian listed companies (B3) — banks and insurers included — from 2010 to today, with a fully published methodology: ROE, ROIC, margins, growth, net debt/EBITDA, point-in-time multiples (P/E, P/B, EV/EBITDA priced at the first trading session on or after the day the filing actually became public — no look-ahead, usable for backtests), dividends and dividend yield, ready-made scores (Piotroski F-Score and Graham) and a record of restated filings.

Sources: CVM open data (ODbL) and B3 (COTAHIST). Every figure carries the CVM account it came from, and nothing is published unless a suite of invariant tests passes — the balance sheet balances, the income statement reconciles, and a price never precedes the filing that justifies it.

Product and plans: https://dadosb3.com/?de=github

Use 1 — remote (nothing to install, recommended)

Add this remote connector to your AI client:

https://dadosb3.com/mcp/

In Claude: Settings → Connectors → add custom connector → paste the URL.

The remote server exposes 36 read-only tools (most of them work without a key). Beyond the table below it also serves bancos, fatos_relevantes, fundos_da_acao, fundos_investimento, listas, producao_petroleo_gas, quanto_rendeu, saiu_da_bolsa, screener_fiis, tarifas_energia, acessos_telecom and tesouro_direto. The local builds in Use 2 and Use 3 run the subset in the table. Open pages without a key: https://dadosb3.com/claude-code?de=github (Claude Code guide) and the list under "Open pages, no key".

Use in Claude Code (plugin)

This repository is a Claude Code plugin marketplace with one plugin, dados-b3. The plugin registers the remote server https://dadosb3.com/mcp and adds a skill that tells Claude when to use it and to cite the dadosb3.com page each answer comes from.

In a Claude Code session (v2.1.275 or later), one command:

/plugin install dados-b3 --marketplace Val7h/dados-b3-mcp

Or in two steps:

/plugin marketplace add Val7h/dados-b3-mcp
/plugin install dados-b3@dados-b3

From your shell, without a session:

claude plugin marketplace add Val7h/dados-b3-mcp
claude plugin install dados-b3@dados-b3

Without the plugin (only the MCP server, no skill):

claude mcp add --transport http dados-b3 https://dadosb3.com/mcp

The free tools need no key. Prices are end-of-day, not real-time quotes, and the answers are past data, not investment advice. Guide: https://dadosb3.com/claude-code?de=github

Use 2 — local (stdio)

pip install -r requirements.txt
python server.py

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

Use 3 — Docker image (one command, no local Python)

docker run -i --rm -e DADOS_B3_API_KEY=your_optional_key ghcr.io/val7h/dados-b3-mcp:latest

{
  "mcpServers": {
    "dados-b3": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/val7h/dados-b3-mcp:latest"]
    }
  }
}

The image is published on every push to main (.github/workflows/publicar-imagem.yml). It exists for two reasons: a one-command install path, and letting MCP directories actually run the server in order to evaluate it.

Tools

trimestres stops at Q3 on purpose. The interim filing (ITR) never carries a standalone fourth quarter — it can be derived as full year − nine months, and some do derive it. We do not: a figure we computed would sit in the same list as the figures the company reported, carrying the error of two filings and erasing the line between what was filed and what we calculated. For the closed year, ask for the annual series.

No key needed for the tools marked "yes": any ticker, one at a time, up to 60 queries/hour and 150/day per IP (AI assistants and this connector: 2,000/hour and 20,000/day). WEGE3 is open in every tool. For the tools that need a key, create a free key at https://dadosb3.com/chave-gratis?de=github (200 queries/day, no card) or subscribe to Pro at https://dadosb3.com/assinar?de=github (10,000/day), and pass it in the chave_api argument or the DADOS_B3_API_KEY environment variable.

The company count is deliberately not written here: the universe grows whenever the CVM publishes, and a number frozen in a README ages without anyone noticing. Call saude for today's figure.

Banks and insurers

Financial institutions file under a different chart of accounts — there is no EBIT and no sales revenue. The connector classifies them by their actual chart of accounts and returns the indicators that mean something for them — ROE, margin, growth, P/E, P/B, dividends — and deliberately does not publish ROIC, EBITDA or EV/EBITDA for them, because those do not apply. Examples: Itaú, Bradesco, Banco do Brasil, BB Seguridade, IRB.

Why this one

A methodology published rather than described, invariant tests gating every release, multiples with no future information leaking in, and restatements kept on the record — when a company republishes a filing, both versions stay side by side. An honest comparison, including where competitors are better: https://dadosb3.com/comparativo?de=github

Prefer plain Python?

pip install dadosb3 — the official client for the same API, with typed errors and one method per tool: https://pypi.org/project/dadosb3/

Open pages, no key

Public pages on the site, readable without an API key or an account:

• Total return of PETR4 (same pattern for any ticker: /quanto-rendeu/<TICKER>)
• Ibovespa or Selic
• REITs by dividend yield
• Companies that left the exchange
• Ibovespa index
• Stocks: PETR4 page, ETFs, BDRs, REITs
• Guide: dividend yield
• llms.txt (index of the site for AI assistants)

Independent project, not affiliated with B3 or the CVM. Informational data, not investment advice.

Licence

MIT (this connector). The underlying data is public (CVM/B3); the service adds standardisation, methodology and tests.

---

Dados B3 — servidor MCP (bolsa brasileira, B3)

Site oficial: https://dadosb3.com/?de=github · Endpoint MCP remoto: https://dadosb3.com/mcp/ · Metodologia · Guia de conexão · llms.txt

dadosb3.com é o único endereço oficial do projeto. O endereço antigo no onrender.com foi aposentado; o que ainda aponta para lá está desatualizado.

Palavras-chave: B3, Bovespa, bolsa brasileira, ações brasileiras, dividendos, proventos, FII (fundos imobiliários), ETFs, BDRs, CVM, deslistagem (empresas que saíram da bolsa), fundamentos, múltiplos ponto-no-tempo, MCP, Model Context Protocol, Brazilian stock market.

Resumo (conferido no servidor vivo em 06/11/2026)

Metodologia e linhagem

Cada número carrega a conta CVM de origem. A página de cada indicador desce até a linha do arquivo da CVM, por exemplo ROE 2025 do ITUB4. Fórmulas: metodologia e o dicionário em JSON. Audite você mesmo, com a sua semente: dadosb3.com/auditoria (ou a ferramenta auditar_amostra). Os testes de invariantes rodam antes de cada publicação: transparência.

Perguntas de exemplo

• "Quanto a PETR4 pagou de dividendos nos últimos 12 meses, com data-com?" → dividendos
• "Quais empresas saíram da bolsa em 2026 e quanto pagaram antes de sair?" → saiu_da_bolsa, dividendos
• "ROE do Itaú em 2025, com as contas CVM" → indicadores_anuais
• "FIIs com maior DY de 12 meses e P/VP abaixo de 1" → fiis_ranking, fii
• "Valeu a pena ter WEGE3 nos últimos 5 anos, contra Ibovespa e Selic?" → desempenho
• "Quanto rendeu R$ 1.000 em ITUB4?" → quanto_rendeu

O que é

Conector MCP que dá ao seu agente de IA (Claude, ChatGPT, Cursor e outros) acesso a dados fundamentalistas das 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 a partir da 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/?de=github

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.

O servidor remoto expõe 36 ferramentas somente de leitura (a maioria grátis, sem chave). Além das da tabela, serve também bancos, fatos_relevantes, fundos_da_acao, fundos_investimento, listas, producao_petroleo_gas, quanto_rendeu, saiu_da_bolsa, screener_fiis, tarifas_energia, acessos_telecom e tesouro_direto. As versões locais (Uso 2 e 3) rodam o subconjunto da tabela. Guia do Claude Code: https://dadosb3.com/claude-code?de=github

Uso no Claude Code (plugin)

Este repositório é um marketplace de plugins do Claude Code com um plugin, dados-b3. O plugin registra o servidor remoto https://dadosb3.com/mcp e traz uma skill que diz ao Claude quando usá-lo e que cite a página do dadosb3.com de onde veio cada resposta.

Numa sessão do Claude Code (v2.1.275 ou mais nova), um comando:

/plugin install dados-b3 --marketplace Val7h/dados-b3-mcp

Ou em dois passos:

/plugin marketplace add Val7h/dados-b3-mcp
/plugin install dados-b3@dados-b3

Sem o plugin (só o servidor MCP, sem a skill):

claude mcp add --transport http dados-b3 https://dadosb3.com/mcp

As ferramentas abertas não pedem chave. O preço é de fechamento, não cotação em tempo real, e a resposta é dado passado, não recomendação de investimento. Guia: https://dadosb3.com/claude-code?de=github

Uso 2 — local (stdio)

pip install -r requirements.txt
python server.py

Uso 3 — imagem Docker (um comando, sem Python local)

docker run -i --rm -e DADOS_B3_API_KEY=sua_chave_opcional ghcr.io/val7h/dados-b3-mcp:latest

A imagem é publicada a cada push na main. Ela existe por dois motivos: dar um caminho de instalação de um comando só, e permitir que diretórios de MCP rodem o servidor para avaliá-lo.

Prefere Python puro?

pip install dadosb3 — o cliente oficial da mesma API, com erros tratados e um método por ferramenta: https://pypi.org/project/dadosb3/

Ferramentas

trimestres para no 3T de propósito. A ITR nunca traz o 4º trimestre isolado — ele sai de exercício cheio − 9 meses, e há quem derive. Nós não: um número calculado por nós entraria na MESMA lista dos que a companhia reportou, carregando o erro de dois arquivos e apagando a fronteira entre "foi publicado" e "nós calculamos". Para o ano fechado, peça a série anual.

Sem chave nas ferramentas marcadas "sim": qualquer ticker, um por vez, até 60 consultas por hora e 150 por dia, por endereço (assistentes de IA e este conector: 2.000 por hora e 20.000 por dia). A WEGE3 é aberta em todas. Para as que pedem chave, crie uma chave grátis em https://dadosb3.com/chave-gratis?de=github (200 consultas/dia, sem cartão) ou assine o Pro em https://dadosb3.com/assinar?de=github (10.000/dia) e passe a chave no argumento chave_api (ou na variável DADOS_B3_API_KEY).

A contagem de empresas não fica escrita aqui de propósito: o universo cresce quando a CVM publica, e um número congelado num README envelheceria sem ninguém ver. Para o número de hoje, chame saude.

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. Comparativo honesto, inclusive onde os concorrentes são melhores: https://dadosb3.com/comparativo?de=github

Páginas abertas, sem chave

Páginas públicas do site, que se leem sem chave de API e sem cadastro:

• Quanto rendeu PETR4 (mesmo padrão para qualquer ticker: /quanto-rendeu/<TICKER>)
• Ibovespa ou Selic
• FIIs por dividend yield
• Empresas que saíram da bolsa
• Índice Ibovespa
• Ações: página da PETR4, ETFs, BDRs, FIIs
• Guia: dividend yield
• llms.txt (índice do site para assistentes de IA)

Projeto independente, sem vínculo com a B3 nem com a CVM. Dados informativos, não são recomendação de investimento.

Licença

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