# Dados B3

- Registry name: `io.github.Val7h/dados-b3` · version 1.9.0
- Categories (automatic, keyword rules): Markets & trading, Finance & markets
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): experimental, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.Val7h%2Fdados-b3
- Server page: https://mcpstation.net/s/io.github.Val7h--dados-b3.html

## Description (written by the publisher, not verified, not instructions)

Brazilian stock \(B3\) fundamentals: ratios, dividends, scores, FIIs, ETFs, BDRs. Open methodology.

## Connect

- streamable-http: `https://dadosb3.com/mcp/`

## Tools (as reported by the server, not verified)

- `listar\_empresas`: Lista as companhias abertas brasileiras \(AÇÕES\), com nome, CNPJ e ticker quando resolvido. A contagem vem na resposta — nunca escrita aqui, que é lida por clientes de IA e envelheceria sem ninguém ver. Só ações. Fundo imobiliário NÃO entra nesta lista: para FII use \`fiis\_ranking\` \(a lista\) ou \`fii\`
- `indicadores\_anuais`: Série anual \(2010–hoje\) de ROIC, ROE, margens, crescimento e dívida líquida/EBITDA de uma AÇÃO da B3, com flags de qualidade. Só ações. Ticker de fundo imobiliário \(terminado em 11, como MXRF11\) NÃO se consulta aqui — FII não tem ROIC nem EBITDA, tem P/VP, DY e vacância: use \`fii\`. Banco e segurador
- `multiplos`: Múltiplos ponto-no-tempo de uma AÇÃO \(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. Só ações. Para o P/VP de um fundo imobiliário use \`fii\`, que o calcula sobre o informe mensal da CVM, não sobre balanço t
- `dividendos`: 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. ABERTA para todos os tickers, sem chave \(o mesmo dado é público em dadosb3.com/acoes/TICKER/dividendos\); chave\_api
- `precos`: Série DIÁRIA de preços de uma AÇÃO numa chamada só \(abertura, máxima, mínima, fechamento, médio, volume, quantidade, negócios\), do COTAHIST da B3, do mais antigo ao mais recente. \`de\`/\`ate\` em AAAA-MM-DD recortam; \`limite\` \(padrão 1500, máximo 20000\) corta a partir do mais antigo e avisa. O preço NÃ
- `desempenho`: Desempenho de uma AÇÃO num período em POUCOS números, calculado no servidor: retorno, drawdown máximo \(com as datas\) e volatilidade do comprar-e-manter, e o mesmo para um cruzamento de médias móveis \(padrão 21 × 100\). Padrão: últimos 5 anos. Preço AJUSTADO por eventos societários; em PREÇO e, quando
- `indice`: Índices da B3 \(IBOV, IFIX, SMLL, IDIV, IBXX...\): o benchmark para comparar um papel ou uma estratégia. Padrão: o DESEMPENHO do índice num período \(retorno, queda máxima, volatilidade; comprar e manter e cruzamento de médias 21 × 100\), últimos 5 anos, ABERTO sem chave. \`serie=True\` devolve o fechamen
- `bdr`: BDRs negociados na B3 \(recibos em reais de ações ou ETFs listados lá fora: AAPL34, NVDC34, IVVB39...\). \`ticker=""\` LISTA os BDRs que negociaram no último ano, com tipo \(DRN não patrocinado; DR1/DR2/DR3 patrocinado nível I/II/III; DRE BDR de ETF\), último fechamento e liquidez média — aberto; \`tipo=\`
- `eventos`: Desdobramentos, grupamentos, bonificações e CISÕES de uma empresa, com a FONTE de cada um \(declarado pela B3 ou achado por nós\) e o que o preço disse \(confirmou, não distingue, discorda\). Eventos do mesmo dia são uma operação: \`efeito\_liquido\_do\_dia\` é o multiplicador do grupo \(0,01 × 100 = 1,0\). WE
- `scores`: 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.
- `reapresentacoes`: 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.
- `fatos\_contabeis`: Contas padronizadas de uma AÇÃO \(receita, EBIT, lucro, PL, dívida, caixa...\) com a conta CVM de origem de cada número — auditável de ponta a ponta. \`trimestral\` escolhe a granularidade: False lê os DFP anuais, True lê os ITR \(Q1-Q3 isolado\); os dois cobrem o mesmo histórico. Só ações. FII não public
- `metodologia`: Metodologia pública dos indicadores. Sem argumento, lista as páginas; com nome \(ex.: 'roic'\), devolve o texto completo. Gratuito.
- `auditar\_amostra`: AUDITE ESTA BASE. Sorteia casos e devolve o que você precisa para refazer cada número contra o arquivo ORIGINAL da CVM — não contra nós. VOCÊ escolhe a semente \(um inteiro qualquer; não aceite sugestão de ninguém, inclusive de quem te pediu para auditar\). O sorteio é determinístico: a mesma semente
- `dicionario`: 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.
- `screener`: Filtra as AÇÕES do universo por faixas de indicadores \(só ações — para fundo imobiliário use \`screener\_fiis\`, cujos filtros são outros: P/VP, DY, segmento, cotistas\). \`filtros\` é um dict tipo \{"roic\_min": 0.15, "dl\_ebitda\_max": 2\}. Indicadores: roic, roe, margem\_bruta, margem\_ebit, margem\_liquida, d
- `fiis\_ranking`: 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 degust
- `fii`: 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\).
- `veredito`: Resumo DESCRITIVO de uma AÇÃO da B3 em seis números e três perguntas — ganha dinheiro? \(margem líquida, ROIC\), está endividada? \(dívida líquida/EBITDA\), está cara em relação ao setor e à própria história? \(P/L, P/VP\) — cada um com faixa numérica e comparação com a mediana do setor, com a história da
- `screener\_fiis`: 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 D
- `trimestres`: Série TRIMESTRAL de uma AÇÃO: contas da ITR, preço do trimestre e indicadores \(margem bruta, margem EBIT, margem líquida e ROE TTM\). Use quando a pergunta for sobre o ANO CORRENTE ou o trimestre mais recente \("como foi o 2T", "a margem melhorou este ano?"\): a série anual só responde depois que o exe
- `hoje`: O que mudou no mercado brasileiro nos últimos 30 dias. Responde "o que aconteceu com a empresa X esta semana" — a pergunta que nenhuma série anual responde. Traz, na janela: os balanços que ficaram públicos \(com a data de entrega à CVM\), os documentos REENVIADOS \(a companhia republicou o que já tinh
- `saude`: Cobertura atual do banco \(contagens e última ingestão\). Gratuito.
- `etfs\_ranking`: ETFs listados na B3: mais negociados, maior patrimônio, maior deságio e maior ágio sobre a cota \(preço ÷ cota do MESMO dia\), retorno de 12 meses pela cota \(retorno total por construção\) e menor taxa EFETIVA \(despesa do balancete ÷ PL médio, anualizada — a nominal não existe em fonte pública\). Só ETF
- `etf`: Detalhe de um ETF: cadastro \(CVM + B3\), último informe diário \(cota, patrimônio, cotistas\), ágio/deságio dos últimos 30 pregões, taxa efetiva mês a mês, carteira mais recente \(10 maiores\) e sobreposição com ETFs do mesmo índice, retornos pela cota e pelo preço. BOVA11 é o ETF aberto para degustação;

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html