MCP.so
Sign In

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

14

Lista 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

toolwhat it returns
listar_empresasthe companies covered, with name, CNPJ and ticker
indicadores_anuaisROIC, ROE, margins, growth, net debt/EBITDA
multiplosP/E, P/B, EV/EBITDA and trailing P/E — all point-in-time
fatos_contabeisstandardised accounts with the originating CVM account code
dividendoscash distributions and 12-month dividend yield
scoresPiotroski F-Score with all nine criteria shown, plus Graham
reapresentacoesrestated filings, original and revised side by side
screenerfilter the whole market by indicator ranges
dicionarioformula and CVM accounts behind each indicator
metodologiathe published methodology behind each indicator
saudecurrent coverage and last ingestion date
fiione Brazilian REIT in detail: NAV, yield, holders
fiis_rankingliquid Brazilian REITs ranked by price-to-book
screener_fiisfilter 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.

Comments