
Dados B3VerifiedFeatured
@Valth Guimarães
About Dados B3
Auditable fundamentals for the Brazilian stock market (B3): ROIC, margins, point-in-time multiples, dividends and REITs. Every figure traces back to the CVM account it came from, every formula is published, and nothing ships until an invariant suite passes.
Connection details
https://dadosb3.com/mcp/Setup
claude mcp add dados-b3 --transport http https://dadosb3.com/mcp/Tools
14Lista as 402 companhias abertas brasileiras disponíveis (nome, CNPJ e ticker quando resolvido). Gratuito, sem chave.
Série anual (2010–hoje) de ROIC, ROE, margens, crescimento e dívida líquida/EBITDA de uma empresa da B3, com flags de qualidade. WEGE3 é gratuita; demais tickers exigem chave_api (grátis ou Pro).
Múltiplos ponto-no-tempo (P/L, P/VP, EV/EBITDA anuais; P/L TTM trimestral) — preço do 1º pregão APÓS a publicação real do balanço, sem vazamento de informação futura. WEGE3 gratuita.
Histórico de proventos em dinheiro (dividendos e JCP) de uma empresa da B3: valor por ação, data de aprovação, data-com e preço na data-com, mais resumo anual e dividend yield 12 meses. WEGE3 é gratuita; demais tickers exigem chave_api (grátis ou Pro).
Scores fundamentalistas prontos com a conta aberta: Piotroski F-Score (0-9, cada um dos 9 critérios auditável) e o critério de Graham (barato se P/L × P/VP ≤ 22,5). Banco não tem Piotroski. WEGE3 gratuita.
Balanços REPUBLICADOS de uma empresa: quando um número do exercício muda entre o arquivo original e a republicação, as duas versões ficam lado a lado (ano, conta CVM, valor antigo × novo, variação). Diferencial do Dados B3 — reapresentação registrada, nunca corrigida em silêncio. WEGE3 gratuita.
Contas padronizadas (receita, EBIT, lucro, PL, dívida, caixa...) com a conta CVM de origem de cada número — auditável de ponta a ponta. Anual ou trimestral (Q1-Q3 isolado). WEGE3 gratuita.
Metodologia pública dos indicadores. Sem argumento, lista as páginas; com nome (ex.: 'roic'), devolve o texto completo. Gratuito.
Metodologia dos indicadores em JSON: fórmula, contas CVM e a BASE do lucro de cada um. IMPORTANTE para comparar corretamente: margem_liquida usa lucro consolidado TOTAL; roe usa lucro dos CONTROLADORES. Gratuito.
Filtra as 402 empresas por faixas de indicadores. `filtros` é um dict tipo {"roic_min": 0.15, "dl_ebitda_max": 2}. Indicadores: roic, roe, margem_bruta, margem_ebit, margem_liquida, dl_ebitda, cresc_receita_1a, cresc_receita_5a_cagr (sufixos _min/_max). Sem `ano` usa o último de cada empresa. Só valores SEM flag entram. Requer chave_api (grátis ou Pro).
Ranking dos fundos imobiliários (FIIs): os mais descontados (menor P/VP), os maiores pagadores (DY 12m) e a mediana de P/VP e DY por segmento. Tudo do informe mensal da CVM + COTAHIST, só valores limpos (sem flag) e fundos líquidos. Requer chave_api (grátis ou Pro); o FII MXRF11 é aberto para degustação nas ferramentas por ticker.
Detalhe de um fundo imobiliário (FII): cadastro, último informe (cotistas/PL/competência), a série histórica de P/VP ponto-no-tempo, o DY 12m corrente e os últimos rendimentos pagos. MXRF11 é o FII aberto para degustação; demais fundos exigem chave_api (grátis ou Pro).
Filtra os FIIs por faixas. `filtros` é um dict tipo {"pvp_max": 0.9, "dy_min": 0.10, "segmento": "Logística", "cotistas_min": 5000}. Válidos: pvp_min, pvp_max, dy_min, dy_max (limites inclusivos), segmento (match exato, sem caixa) e cotistas_min (piso de liquidez). Só entram valores limpos (P/VP e DY sem flag). Ordena por P/VP crescente, teto de 100. Requer chave_api (grátis ou Pro).
Cobertura atual do banco (contagens e última ingestão). Gratuito.
Overview
What is Dados B3?
A remote MCP server that gives your AI assistant auditable fundamentals for the Brazilian stock market (B3) — every listed company the CVM covers, banks and insurers included, from 2010 to today, plus Brazilian REITs (FIIs).
Nothing to install. Point your client at https://dadosb3.com/mcp/ and ask.
Why this one
Every source will hand you a ROIC. None of them will show you which line of which filing it came from. Two properties make this different, and both are checkable rather than claimed.
Point-in-time by construction. A multiple is never computed with a price from before the balance sheet was public — the price used is the first trading session after the filing's real publication date. That makes the series usable for backtests without look-ahead. It is not a disclaimer; it is how the data is built.
Nothing ships until the tests pass. The database is rebuilt from the public source, an invariant suite runs against the new copy, and only then is it swapped in atomically. A failing test blocks the release — the old data stays live instead. every test is listed at dadosb3.com/transparencia with what it checks and why it exists
Tools
| tool | what it returns |
|---|---|
listar_empresas | the companies covered, with name, CNPJ and ticker |
indicadores_anuais | ROIC, ROE, margins, growth, net debt/EBITDA |
multiplos | P/E, P/B, EV/EBITDA and trailing P/E — all point-in-time |
fatos_contabeis | standardised accounts with the originating CVM account code |
dividendos | cash distributions and 12-month dividend yield |
scores | Piotroski F-Score with all nine criteria shown, plus Graham |
reapresentacoes | restated filings, original and revised side by side |
screener | filter the whole market by indicator ranges |
dicionario | formula and CVM accounts behind each indicator |
metodologia | the published methodology behind each indicator |
saude | current coverage and last ingestion date |
fii | one Brazilian REIT in detail: NAV, yield, holders |
fiis_ranking | liquid Brazilian REITs ranked by price-to-book |
screener_fiis | filter Brazilian REITs by indicator ranges |
Access
saude, the whole methodology, WEGE3 (stock) and MXRF11 (REIT) work with no key at all — connect and try before deciding anything.
Other companies need a key, free or paid, from dadosb3.com. The free one takes no card. Pass it as the chave_api argument or the DADOS_B3_API_KEY environment variable.
Sources and licence
CVM open data (ODbL) and B3 (COTAHIST), end-of-day only. Server code is MIT: github.com/Val7h/dados-b3-mcp.
Frequently asked questions
What is the Dados B3 remote MCP server?
The Dados B3 remote MCP server is a hosted Model Context Protocol endpoint at https://dadosb3.com/mcp/, so AI assistants can connect to it without installing or running anything locally.
How do I connect to the Dados B3 MCP server?
Add the endpoint https://dadosb3.com/mcp/ to any MCP-compatible client such as Claude Code, Cursor, or VS Code. The setup snippets on this page configure each client in one step.
Does the Dados B3 MCP server require authentication?
No. Dados B3's MCP server does not require authentication — you can connect directly with the endpoint URL.
Which transport does the Dados B3 MCP server use?
Dados B3 exposes a Streamable HTTP endpoint, the transport used by remote MCP servers and supported by all major MCP clients.
Basic information
Transport
Streamable HTTP
Authentication
None
Category
Finance & Commerce
Author
Valth Guimarães
Submitted by
Valth Menezes Guimarães
More remote MCP servers
AdminLanding
AdminLanding — French rental, frontalier & home-employment compliance tools (FR/EN). Sourced, dated answers from deterministic rule engines and official datasets — no AI, no account needed for the 10 free tools: zone ten
Agent Utility MCP
Production remote MCP server with exactly 100 bounded tools: 85 paid tools and 15 free tools for text, JSON, encoding, identifiers, numbers, dates, URLs, validation, and secure web intelligence. Paid calls are charged on
Adobe Experience Manager
Manage your Adobe Experience Manager content
AdisInsight
Pharmaceutical drug & clinical trial intelligence
Adobe Journey Optimizer
Understand and troubleshoot your Journeys and Campaigns
Comments