Serveur MCP
Dados B3
io.github.Val7h/dados-b3
Ce que fait ce MCP
Provides auditable Brazilian B3 stock, ETF, and real estate fund fundamentals, dividends, ratios, rankings, screens, and financial histories.
Capacités
Outils
20
outils
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 devolve sempre os mesmos casos, então seu
resultado é reproduzível por terceiros.
Cada caso traz empresa, CD_CVM, exercício, indicador, valor publicado, a
fórmula, e a conta CVM que AQUELA empresa usou NAQUELE exercício. Confira
baixando dfp_cia_aberta_<EXERCICIO>.zip em dados.cvm.gov.br, filtrando
CD_CVM e ORDEM_EXERC='ÚLTIMO', atento a ESCALA_MOEDA (MIL = milhares).
Regras: publique o DENOMINADOR (7 divergências em 100 é resultado, "7
divergências" não é); NÃO transforme "não consegui conferir" em "passou";
e se afirmar que um número está errado, mostre a conta. Achou erro? É isso
que interessa — github.com/Val7h/dados-b3-mcp/issues.
Gratuito, sem chave. Auditoria que exige cadastro não é auditoria.
Schéma d’entrée
{'type': 'object', 'title': 'auditar_amostraArguments', 'required': ['semente'], 'properties': {'n': {'type': 'integer', 'title': 'N', 'default': 25}, 'semente': {'type': 'integer', 'title': '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.
Schéma d’entrée
{'type': 'object', 'title': 'dicionarioArguments', 'properties': {}}
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. WEGE3 é gratuita; demais tickers
exigem chave_api (grátis ou Pro).
Schéma d’entrée
{'type': 'object', 'title': 'dividendosArguments', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'title': 'Ticker'}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
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; os demais exigem chave_api (grátis ou Pro).
Schéma d’entrée
{'type': 'object', 'title': 'etfArguments', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'title': 'Ticker'}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
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 líquido (> R$ 1 mi/dia) entra em ágio, retorno e taxa. Gratuito.
Schéma d’entrée
{'type': 'object', 'title': 'etfs_rankingArguments', 'properties': {}}
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 publica DFP/ITR nesse formato — o que existe é o informe
mensal, exposto por `fii`.
WEGE3 gratuita; demais exigem chave_api.
Schéma d’entrée
{'type': 'object', 'title': 'fatos_contabeisArguments', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'title': 'Ticker'}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}, 'trimestral': {'type': 'boolean', 'title': 'Trimestral', 'default': False}}}
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).
Schéma d’entrée
{'type': 'object', 'title': 'fiiArguments', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'title': 'Ticker'}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
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
degustação nas ferramentas por ticker.
Schéma d’entrée
{'type': 'object', 'title': 'fiis_rankingArguments', 'properties': {'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
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á tinha entregue), os proventos de ações
aprovados, rendimentos e informes de FII, eventos societários
(grupamento, desdobramento, bonificação) e trocas de ticker.
Cada seção declara `dados_ate`, a data máxima daquela FONTE: as defasagens
são diferentes e a janela é fixa a partir de hoje, então fonte parada
aparece parada em vez de parecer recente. Gratuito, sem chave.
Schéma d’entrée
{'type': 'object', 'title': 'hojeArguments', 'properties': {}}
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 seguradora entram, mas sem ROIC/EBITDA, que não se
aplicam ao plano de contas deles.
WEGE3 é gratuita; demais tickers exigem chave_api (grátis ou Pro).
Schéma d’entrée
{'type': 'object', 'title': 'indicadores_anuaisArguments', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'title': 'Ticker'}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
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` (um fundo). Gratuito, sem chave.
Schéma d’entrée
{'type': 'object', 'title': 'listar_empresasArguments', 'properties': {}}
metodologia
Metodologia pública dos indicadores. Sem argumento, lista as páginas;
com nome (ex.: 'roic'), devolve o texto completo. Gratuito.
Schéma d’entrée
{'type': 'object', 'title': 'metodologiaArguments', 'properties': {'nome': {'type': 'string', 'title': 'Nome', 'default': ''}}}
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 trimestral.
WEGE3 gratuita; demais exigem chave_api.
Schéma d’entrée
{'type': 'object', 'title': 'multiplosArguments', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'title': 'Ticker'}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'reapresentacoesArguments', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'title': 'Ticker'}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
saude
Cobertura atual do banco (contagens e última ingestão). Gratuito.
Schéma d’entrée
{'type': 'object', 'title': 'saudeArguments', 'properties': {}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'scoresArguments', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'title': 'Ticker'}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
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, dl_ebitda, cresc_receita_1a,
cresc_receita_5a_cagr (sufixos _min/_max). Sem `ano` usa o último de cada
empresa. `as_of` ("AAAA-MM-DD") responde outra pergunta: o que estava
PÚBLICO naquela data (balanço já recebido pela CVM, ~100 dias depois do
exercício) — use para pesquisa sem olhar o futuro; cada linha traz
`disponivel_em`. `ano` e `as_of` não se combinam. O universo continua o
das companhias ativas hoje (viés de sobrevivência, declarado na resposta).
`recibo=True` congela a resposta num endereço permanente com o sha256 do
resultado — use quando for CITAR a lista, porque ela muda quando a base
for atualizada e o recibo não.
Só valores SEM flag entram. Requer chave_api (grátis ou Pro).
Schéma d’entrée
{'type': 'object', 'title': 'screenerArguments', 'required': ['filtros'], 'properties': {'ano': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Ano', 'default': None}, 'as_of': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'As Of', 'default': None}, 'recibo': {'type': 'boolean', 'title': 'Recibo', 'default': False}, 'filtros': {'type': 'object', 'title': 'Filtros', 'additionalProperties': True}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
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 DY sem flag). Ordena por P/VP crescente, teto de 100. Requer
chave_api (grátis ou Pro).
Schéma d’entrée
{'type': 'object', 'title': 'screener_fiisArguments', 'required': ['filtros'], 'properties': {'filtros': {'type': 'object', 'title': 'Filtros', 'additionalProperties': True}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
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 exercício fecha, e fica até um ano defasada.
O 4º TRIMESTRE NÃO VEM, e é escolha: a ITR publica 1T/2T/3T e o exercício
fechado é da DFP. Dá para derivar `4T = anual − 9M`, e não derivamos —
número calculado por nós não entra na mesma lista dos que a companhia
reportou. Para o ano fechado use `indicadores_anuais`.
Banco e seguradora recebem só margem líquida e ROE: não há resultado bruto
nem EBIT nesse plano de contas.
WEGE3 gratuita; demais exigem chave_api.
Schéma d’entrée
{'type': 'object', 'title': 'trimestresArguments', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'title': 'Ticker'}, 'chave_api': {'type': 'string', 'title': 'Chave Api', 'default': ''}}}
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 própria empresa e com o universo; mais a BANDEIRA DE
CONFIANÇA do retrato (verde/amarelo/vermelho: houve reapresentação? o dado
é o mais recente? passou nas conferências?). Uma frase de topo de até 25
palavras. Sem adjetivo de julgamento e sem recomendação: quem conclui é
quem lê. Gratuito, sem chave. Traz `citacao` pronta para citar.
Schéma d’entrée
{'type': 'object', 'title': 'vereditoArguments', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'title': 'Ticker'}}}
Historique
Modifications récentes des outils
Ajouté
veredito
25 September 2026 02:58
Modifié
screener
23 September 2026 02:50
Ajouté
etf
17 September 2026 12:52
Ajouté
etfs_ranking
17 September 2026 12:52
Ajouté
saude
17 September 2026 12:52
Ajouté
hoje
17 September 2026 12:52
Ajouté
trimestres
17 September 2026 12:52
Ajouté
screener_fiis
17 September 2026 12:52
Ajouté
fii
17 September 2026 12:52
Ajouté
fiis_ranking
17 September 2026 12:52
Ajouté
screener
17 September 2026 12:52
Ajouté
dicionario
17 September 2026 12:52
Ajouté
auditar_amostra
17 September 2026 12:52
Ajouté
metodologia
17 September 2026 12:52
Ajouté
fatos_contabeis
17 September 2026 12:52
Ajouté
reapresentacoes
17 September 2026 12:52
Ajouté
scores
17 September 2026 12:52
Ajouté
dividendos
17 September 2026 12:52
Ajouté
multiplos
17 September 2026 12:52
Ajouté
indicadores_anuais
17 September 2026 12:52
Ajouté
listar_empresas
17 September 2026 12:52
Découvrir
Serveurs MCP similaires
AlpineDataWorks Intelligence Server
com.alpinedataworks/adw-intelligence-server
Provides economic, market, supply-chain, real-estate, energy, consumer, labor, and other scored intelligence indices with histori…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Valuein — SEC EDGAR Fundamentals & Smart-Money Data
io.github.valuein/mcp-sec-edgar
Provides point-in-time SEC EDGAR fundamentals, filings, ownership signals, financial analysis, valuation models, research reports…
equibles
io.github.daniel3303/equibles
Provides equity and market research tools covering SEC filings, company financials, portfolios, prices, options, macroeconomic da…
DFX Real Estate Intelligence
io.github.Capital-W-Holdings/us-property-parcel-real-estate-debt
Provides US commercial real estate, parcel, debt maturity, bank CRE exposure, private capital, investor, ownership, occupancy, an…
simplefunctions
io.github.spfunctions/simplefunctions
Provides prediction-market data, thesis analysis, market signals, portfolio tracking, and automated intent-based trading workflow…
EventTrader MCP
com.cymetica/event-trader-mcp
Provides prediction-market research and trading capabilities, including real-time event-market data, CLOB execution paths, fund i…
Signal8
ai.signal8/mcp
Provides SEC filings, dilution data, insider and institutional ownership, and political-trade data.