Dados B3 MCP
Remote MCP server providing 36 read-only tools for Brazilian stock market (B3) data, including fundamentals, dividends, FIIs, ETFs, and BDRs. It enables AI agents to query financial indicators, multiples, and historical prices with transparent CVM source lineage.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://dadosb3.com/mcp/What its tools do
36 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (36)
listar_empresasindicadores_anuaismultiplosdividendosprecosdesempenhoindiceacessos_telecomtesouro_diretoproducao_petroleo_gastarifas_energiafundos_investimentoquanto_rendeufundos_da_acaobancossaiu_da_bolsabdreventosscoresreapresentacoesfatos_contabeismetodologiaauditar_amostradicionarioscreenerfiis_rankingfiivereditoscreener_fiistrimestreshojefatos_relevantessaudeetfs_rankingetflistas
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Query annual financial indicators like ROE and ROIC for specific tickers
- Retrieve dividend history and yield data for stocks and FIIs
- Access point-in-time multiples to avoid look-ahead bias in analysis
- Screen for companies based on financial metrics and CVM filings
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- dados-b3 2.3.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 36 advertised
- Resources
- 0 advertised
- Resource templates
- 0 advertised
- Prompts
- 0 advertised
{
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
}
}Tools
36 advertised
listar_empresas — Lista de empresas abertas
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.
{
"type": "object",
"title": "listar_empresasArguments",
"properties": {}
}{
"title": "Lista de empresas abertas",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}indicadores_anuais — Indicadores anuais de uma empresa
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. ABERTA: qualquer ticker, sem chave, um por vez (sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave). Traz `citacao` pronta para citar.
{
"type": "object",
"title": "indicadores_anuaisArguments",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Indicadores anuais de uma empresa",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}multiplos — Múltiplos de uma empresa
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. ABERTA: qualquer ticker, sem chave, um por vez, pelo método atual (sem `as_of`; o ponto-no-tempo por data passada exige chave na REST). Sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave. Traz `citacao`.
{
"type": "object",
"title": "multiplosArguments",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Múltiplos de uma empresa",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}dividendos — Dividendos de uma empresa
Histórico de proventos em dinheiro (dividendos e JCP) de uma empresa da B3: valor por ação, data de aprovação, data-com, preço na data-com, parcela e data de pagamento, mais resumo anual e dividend yield 12 meses (com o total do ano corrente até hoje e do ano anterior fechado). ABERTA para todos os tickers, sem chave, um por vez (a mesma regra da REST /empresas/TICKER/dividendos; o mesmo dado é público em dadosb3.com/acoes/TICKER/dividendos). Sem chave: 2000 consultas por hora e 20000 por dia, por endereço; chave_api é opcional. Traz `citacao`: cite-a ao usar o número. Ticker de companhia que SAIU da bolsa (ENBR3, BIDI4...) devolve o bloco `saiu_da_bolsa` (último pregão e link) e os proventos que ela declarou à CVM (Formulário de Referência: montante em R$ por classe e exercício, até ~2021; Relatório Proventos do IPE: valor por ação e data-com, desde 2024), com `cobertura.fontes` dizendo a fonte e o período; se não declarou nenhum, devolve `erro` com `saiu_da_bolsa` (ausência DESCONHECIDA, não "não pagou").
{
"type": "object",
"title": "dividendosArguments",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Dividendos de uma empresa",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}precos — Histórico de preços
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ÃO é ajustado: os eventos societários do período vêm junto (`eventos`) para quem monta o retorno total. WEGE3 gratuita; demais tickers SEM chave devolvem uma AMOSTRA (últimos 30 pregões) com um `aviso` que diz como ter a série inteira (chave grátis em `chave_api`) e que `desempenho` responde sem chave; com chave, a série completa. ★ FORMATO COMPACTO (04/10/2026). Cinco anos de série completa pesam ~250 KB, mais do que cabe no contexto de um cliente de IA (o ChatGPT recebeu os 1.248 pregões e não conseguiu processá-los). Por padrão a resposta traz só `data,fechamento` em forma de colunas (`colunas` + `linhas`, ~28 KB). Peça mais com `campos` (lista separada por vírgula entre data, ticker, abertura, maxima, minima, fechamento, medio, volume, quantidade, negocios) ou `campos="todos"` para a lista completa de objetos em `serie`.
{
"type": "object",
"title": "precosArguments",
"required": [
"ticker"
],
"properties": {
"de": {
"type": "string",
"title": "De",
"default": "",
"description": "Início do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = desde o começo da série."
},
"ate": {
"type": "string",
"title": "Ate",
"default": "",
"description": "Fim do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = até o último pregão."
},
"campos": {
"type": "string",
"title": "Campos",
"default": "data,fechamento",
"description": "Colunas da série, separadas por vírgula, entre data, ticker, abertura, maxima, minima, fechamento, medio, volume, quantidade, negocios (padrão \"data,fechamento\"). \"todos\" devolve objetos completos (resposta grande)."
},
"limite": {
"type": "integer",
"title": "Limite",
"default": 1500,
"description": "Máximo de pregões devolvidos (padrão 1500, máximo 20000); corta a partir do mais antigo e avisa."
},
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Histórico de preços",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}desempenho — Desempenho de uma ação
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 há proventos registrados, também o retorno TOTAL (`retorno_total_pct`: dividendos, JCP e rendimentos reinvestidos no data-ex); SEM custos (as `premissas` vêm na resposta). Use esta ferramenta para "essa estratégia valeu a pena?" em vez de baixar a série diária. Medida do passado, não recomendação. ABERTA para todos os tickers, sem chave (degustação); chave_api é aceita mas desnecessária.
{
"type": "object",
"title": "desempenhoArguments",
"required": [
"ticker"
],
"properties": {
"de": {
"type": "string",
"title": "De",
"default": "",
"description": "Início do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = últimos 5 anos."
},
"ate": {
"type": "string",
"title": "Ate",
"default": "",
"description": "Fim do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = até o último pregão."
},
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
},
"media_curta": {
"type": "integer",
"title": "Media Curta",
"default": 21,
"description": "Média móvel curta, em pregões: inteiro de 1 a 1000, menor que media_longa (padrão 21)."
},
"media_longa": {
"type": "integer",
"title": "Media Longa",
"default": 100,
"description": "Média móvel longa, em pregões: inteiro de 1 a 1000, maior que media_curta (padrão 100)."
}
}
}{
"title": "Desempenho de uma ação",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}indice — Índices de mercado
Í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 fechamento DIÁRIO em pontos como colunas (`data`, `fechamento`): sem chave vem uma AMOSTRA dos últimos 30 pregões com `aviso`; com chave_api, a série inteira. `codigo=""` lista os índices disponíveis e a cobertura de cada um. Índice de RETORNO TOTAL (a B3 reinveste os proventos nos pontos); não é recomendação.
{
"type": "object",
"title": "indiceArguments",
"properties": {
"de": {
"type": "string",
"title": "De",
"default": "",
"description": "Início do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = últimos 5 anos."
},
"ate": {
"type": "string",
"title": "Ate",
"default": "",
"description": "Fim do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = até o último pregão."
},
"serie": {
"type": "boolean",
"title": "Serie",
"default": false,
"description": "False (padrão) = resumo; True = série diária em colunas. Sem chave_api a série vem como amostra dos últimos 30 pregões."
},
"codigo": {
"type": "string",
"title": "Codigo",
"default": "IBOV",
"description": "Código do índice B3: IBOV (padrão), IFIX, SMLL, IDIV, IBXX... Vazio = lista os índices disponíveis e a cobertura de cada um."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
},
"media_curta": {
"type": "integer",
"title": "Media Curta",
"default": 21,
"description": "Média móvel curta, em pregões: inteiro de 1 a 1000, menor que media_longa (padrão 21)."
},
"media_longa": {
"type": "integer",
"title": "Media Longa",
"default": 100,
"description": "Média móvel longa, em pregões: inteiro de 1 a 1000, maior que media_curta (padrão 100)."
}
}
}{
"title": "Índices de mercado",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}acessos_telecom — Acessos de telecom por operadora (Anatel)
Acessos de telefonia móvel e de banda larga fixa por operadora, mês a mês (Anatel, dados abertos; licença CC BY-ND 3.0 declarada pela Anatel, uso acertado com o órgão e informado pelo dono em 01/11/2026). ABERTO, sem chave. Sem argumentos: o ranking de cada serviço no mês consolidado, com a participação no total e a variação em 12 meses (contas nossas). `servico` (movel ou banda_larga) + `cnpj` (14 dígitos, ou TOTAL para a soma de todas as operadoras) devolve a SÉRIE MENSAL daquela operadora, recortada por `de`/`ate` (AAAA-MM). Telefonia móvel não conta M2M nem ponto de serviço (como o total oficial da Anatel). O mês mais novo é preliminar. O campo `ticker` só vem preenchido quando o CNPJ completo da operadora é o de uma empresa com papel negociado (Vivo/VIVT3, TIM/TIMS3); do contrário é nulo (a Claro não é listada). Número da Anatel somado por operadora por nós; a resposta traz a fonte, a licença, a atribuição e a citação. Não é recomendação de investimento.
{
"type": "object",
"title": "acessos_telecomArguments",
"properties": {
"de": {
"type": "string",
"title": "De",
"default": "",
"description": "Primeiro mês da série, AAAA-MM (ex.: 2024-01)."
},
"ate": {
"type": "string",
"title": "Ate",
"default": "",
"description": "Último mês da série, AAAA-MM (ex.: 2025-06)."
},
"cnpj": {
"type": "string",
"title": "Cnpj",
"default": "",
"description": "CNPJ da operadora com 14 dígitos, ou TOTAL para a soma de todas. Use com `servico`."
},
"servico": {
"type": "string",
"title": "Servico",
"default": "",
"description": "Serviço: \"movel\" ou \"banda_larga\". Vazio = ranking dos dois; com `cnpj`, a série mensal."
}
}
}{
"title": "Acessos de telecom por operadora (Anatel)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}tesouro_direto — Taxas do Tesouro Direto
Taxas e preços diários dos títulos do Tesouro Direto (Tesouro Nacional, Tesouro Transparente, ODbL 1.0), desde 31/12/2004: a curva de juros pública por vencimento. ABERTO, sem chave. Sem argumentos: todos os títulos no dia-base mais recente. `titulo` (selic, prefixado, prefixado-juros, ipca, ipca-juros, renda-mais, educa-mais, igpm-juros) filtra a família; `data` (AAAA-MM-DD) pede o último dia-base até essa data; `titulo` + `vencimento` (AAAA-MM-DD) devolve a SÉRIE DIÁRIA daquele título, recortada por `de`/`ate`. Compra e venda são os rótulos da fonte (do ponto de vista do investidor), taxas indicativas da manhã. Prefixado = taxa NOMINAL a.a.; IPCA+, Renda+ e Educa+ = taxa REAL a.a. (acima da inflação); Selic = taxa sobre a Selic: nominal e real NÃO se comparam diretamente. Número do Tesouro, sem recálculo; a resposta traz a fonte, a licença e a citação. Não é recomendação de investimento.
{
"type": "object",
"title": "tesouro_diretoArguments",
"properties": {
"de": {
"type": "string",
"title": "De",
"default": "",
"description": "Primeiro dia da série: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Use com `titulo` + `vencimento`."
},
"ate": {
"type": "string",
"title": "Ate",
"default": "",
"description": "Último dia da série: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Use com `titulo` + `vencimento`."
},
"data": {
"type": "string",
"title": "Data",
"default": "",
"description": "Dia-base, AAAA-MM-DD (também aceita 01/06/2024): devolve o último dia-base até essa data. Vazio = o mais recente."
},
"titulo": {
"type": "string",
"title": "Titulo",
"default": "",
"description": "Família do título: selic, prefixado, prefixado-juros, ipca, ipca-juros, renda-mais, educa-mais ou igpm-juros. Vazio = todos."
},
"vencimento": {
"type": "string",
"title": "Vencimento",
"default": "",
"description": "Vencimento de um título, AAAA-MM-DD (ex.: 2035-05-15). Exige `titulo`; devolve a série diária dele."
}
}
}{
"title": "Taxas do Tesouro Direto",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}producao_petroleo_gas — Produção de petróleo e gás por operador e campo (ANP)
Produção de petróleo e gás natural por operador e por campo (ANP, dados abertos, licença declarada CC BY-ND 3.0, uso acertado com a ANP). ABERTO, sem chave. Taxa MÉDIA DIÁRIA do mês: petróleo em bbl/dia, gás em Mm³/dia (mil m³). Sem argumentos: os operadores do último mês da base, com a soma dos poços, a participação no total nacional e a variação contra o mesmo mês do ano anterior (contas nossas). `nivel=campo` traz os campos; `periodo` (AAAA-MM) pede outro mês. `cnpj` (14 dígitos), `operador` (nome na ANP) ou `campo` devolvem a SÉRIE MENSAL dele, recortada por `de`/`ate` (AAAA-MM). Até dez/2023 é o arquivo por poço da ANP (mar e terra); de 2024 em diante os operadores vêm do Boletim Mensal da ANP e o dado por poço de exportação manual da consulta pública, com cobertura PARCIAL: cada linha traz `fonte` e `escopo` (`completo`, `somente_mar`), a resposta traz `cobertura_manual` com os meses que faltam, e a variação em 12 meses só existe entre meses de mesmo escopo. O `cnpj` vem da relação de concessionários da ANP pelo contrato e só quando o nome do operador confere; o `ticker` só vem quando esse CNPJ completo é o de uma empresa com papel negociado (operador SPE ou consórcio não liga). Número da ANP; a resposta traz a fonte, a licença, o acordo de uso e a citação. Não é recomendação de investimento.
{
"type": "object",
"title": "producao_petroleo_gasArguments",
"properties": {
"de": {
"type": "string",
"title": "De",
"default": "",
"description": "Primeiro mês da série, AAAA-MM (ex.: 2024-01)."
},
"ate": {
"type": "string",
"title": "Ate",
"default": "",
"description": "Último mês da série, AAAA-MM (ex.: 2025-06)."
},
"cnpj": {
"type": "string",
"title": "Cnpj",
"default": "",
"description": "CNPJ do operador com 14 dígitos; devolve a série mensal dele."
},
"campo": {
"type": "string",
"title": "Campo",
"default": "",
"description": "Nome do campo de petróleo ou gás na ANP; devolve a série mensal dele."
},
"nivel": {
"type": "string",
"title": "Nivel",
"default": "operador",
"description": "Nível: \"operador\" (padrão) ou \"campo\"."
},
"periodo": {
"type": "string",
"title": "Periodo",
"default": "",
"description": "Mês a devolver, AAAA-MM (ex.: 2025-06). Vazio = o último mês da base."
},
"operador": {
"type": "string",
"title": "Operador",
"default": "",
"description": "Nome do operador como consta na ANP; devolve a série mensal dele."
}
}
}{
"title": "Produção de petróleo e gás por operador e campo (ANP)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}tarifas_energia — Tarifa de energia por distribuidora (ANEEL)
Tarifa residencial de energia elétrica por distribuidora (ANEEL, dados abertos, ODbL 1.0), desde 2010: TUSD e TE em R$/MWh, SEM tributos (ICMS, PIS e COFINS ficam de fora), subgrupo B1 convencional. ABERTO, sem chave. Sem argumentos: a tarifa mais recente de cada distribuidora, com a variação do total contra o reajuste anterior (conta nossa) e o resumo (mais barata, mediana, mais cara entre as que têm tarifa em vigor). `cnpj` (14 dígitos) devolve todas as vigências de UMA distribuidora, recortadas por `de`/`ate` (AAAA-MM-DD, início da vigência). O campo `ticker` só vem preenchido quando o CNPJ completo da distribuidora é o de uma empresa com papel negociado; do contrário é nulo, porque a distribuidora costuma ser subsidiária da companhia listada e o grupo não é deduzido pelo nome. Número da ANEEL; a resposta traz a fonte, a licença e a citação. Não é recomendação de investimento.
{
"type": "object",
"title": "tarifas_energiaArguments",
"properties": {
"de": {
"type": "string",
"title": "De",
"default": "",
"description": "Início de vigência mais antigo: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
},
"ate": {
"type": "string",
"title": "Ate",
"default": "",
"description": "Início de vigência mais recente: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
},
"cnpj": {
"type": "string",
"title": "Cnpj",
"default": "",
"description": "CNPJ da distribuidora com 14 dígitos; devolve todas as vigências dela."
}
}
}{
"title": "Tarifa de energia por distribuidora (ANEEL)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}fundos_investimento — Fundos de investimento: cota, PL e captação (CVM)
Fundos de investimento registrados na CVM (renda fixa, multimercado, ações, cambial; ~25 mil), do Informe Diário da CVM (dados abertos, ODbL 1.0): cota, patrimônio líquido (PL), cotistas e captação e resgate do mês. ABERTO, sem chave. Sem argumentos: no mês de referência (o mais novo já fechado), os `limite` maiores fundos por PL, os que mais captaram e os que mais perderam (captação líquida = captação menos resgate, conta nossa). `cnpj` (14 dígitos, da classe ou do fundo): o nome, a classificação, o gestor e a série de 13 meses (foto do último dia informado de cada mês, soma do mês dos fluxos e a variação da cota no mês, conta nossa que NÃO é a rentabilidade oficial). `busca`: procura pelo nome (sem acento e sem caixa) ou pelo começo do CNPJ. O PL de todos os fundos não é somado (fundo de cotas contaria duas vezes). Número que o administrador informou à CVM; a resposta traz a fonte, a licença e a citação. Não é recomendação de investimento.
{
"type": "object",
"title": "fundos_investimentoArguments",
"properties": {
"cnpj": {
"type": "string",
"title": "Cnpj",
"default": "",
"description": "CNPJ do fundo ou da classe com 14 dígitos; devolve a série de 13 meses."
},
"busca": {
"type": "string",
"title": "Busca",
"default": "",
"description": "Nome do fundo (sem acento e sem distinção de caixa) ou começo do CNPJ."
},
"limite": {
"type": "integer",
"title": "Limite",
"default": 20,
"description": "Quantidade de fundos em cada ranking (padrão 20)."
}
}
}{
"title": "Fundos de investimento: cota, PL e captação (CVM)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}quanto_rendeu — Quanto rendeu R$ 1.000 em 1, 3, 5 e 10 anos
Quanto viraram R$ 1.000 numa AÇÃO, FII ou ETF há 1, 3, 5 e 10 anos: só com o preço e com os proventos reinvestidos, contra o Ibovespa (IFIX no FII) e a meta Selic, até o último fechamento. São EXATAMENTE os números da página https://dadosb3.com/quanto-rendeu/{ticker} (cada janela começa no mesmo dia do último fechamento, N anos antes); para outro período, use `desempenho` com `de`/`ate`. ABERTO, sem chave. Medida do passado, sem custos nem impostos; não é recomendação. Devolve o texto em markdown e a URL para citar.
{
"type": "object",
"title": "quanto_rendeuArguments",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker de ação, FII ou ETF da B3, como PETR4, HGLG11 ou BOVA11 (sem distinção de caixa; aceita .SA)."
}
}
}{
"title": "Quanto rendeu R$ 1.000 em 1, 3, 5 e 10 anos",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}fundos_da_acao — Fundos que têm uma ação na carteira (CDA da CVM)
Quais FUNDOS DE INVESTIMENTO têm uma AÇÃO na carteira e quanto (valor e quantidade), e quem aumentou ou reduziu a posição no último mês disponível: a Composição e Diversificação das Aplicações (CDA) que os fundos entregam à CVM (bloco de ações; 13 meses). `limite` (1 a 500, padrão 20) corta a lista dos maiores por valor; contadores e maiores movimentos cobrem todos os fundos. A carteira sai depois do fim do mês: a data de referência vem na resposta. Licença da fonte: ODbL 1.0. WEGE3 é aberto; as demais ações seguem a regra de chave da página. Não é recomendação.
{
"type": "object",
"title": "fundos_da_acaoArguments",
"required": [
"ticker"
],
"properties": {
"limite": {
"type": "integer",
"title": "Limite",
"default": 20,
"description": "Quantidade de fundos listados, inteiro de 1 a 500 (padrão 20), os maiores por valor."
},
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Fundos que têm uma ação na carteira (CDA da CVM)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}bancos — Indicadores dos bancos listados (Banco Central)
Indicadores dos BANCOS listados, do IF.data do Banco Central (conglomerado prudencial, ODbL 1.0): índice de Basileia, inadimplência acima de 90 dias, ativos problemáticos, carteira de crédito, lucro e patrimônio. Sem `ticker`: o ÚLTIMO trimestre de cada banco, na ordem do tamanho da carteira de crédito (a mesma tabela de https://dadosb3.com/bancos). Com `ticker` (ITUB4, BBDC4, BBAS3, SANB11...): a série trimestral daquele banco. ABERTO, sem chave. Número publicado pelo Banco Central, sem recálculo (a inadimplência é a divisão de duas linhas dele). Não é recomendação de investimento.
{
"type": "object",
"title": "bancosArguments",
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"default": "",
"description": "Ticker de banco opcional, como ITUB4, BBDC4, BBAS3 ou SANB11. Vazio = todos os bancos, último trimestre."
}
}
}{
"title": "Indicadores dos bancos listados (Banco Central)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}saiu_da_bolsa — Companhias que saíram da bolsa, por ano (B3 e CVM)
Companhias que SAÍRAM DA BOLSA (deixaram de ser negociadas na B3), por ano do ÚLTIMO PREGÃO: as que tiveram o registro de companhia aberta cancelado na CVM (com data e motivo da CVM) e as que pararam de negociar com o registro ainda ativo (mudança para fora, fusão, OPA: JBS, BRF, Santos Brasil...). Sem `ano`: os 3 anos mais recentes. Com `ano`: só aquele ano (dentro desses 3). ABERTO, sem chave. É a página https://dadosb3.com/saiu-da-bolsa. Não é recomendação.
{
"type": "object",
"title": "saiu_da_bolsaArguments",
"properties": {
"ano": {
"type": "integer",
"title": "Ano",
"default": 0,
"description": "Ano do último pregão, dentro dos 3 mais recentes (ex.: 2025). 0 = os 3 anos mais recentes."
}
}
}{
"title": "Companhias que saíram da bolsa, por ano (B3 e CVM)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}bdr — BDRs
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=` filtra. Com `ticker`: cadastro da B3, último pregão, rentabilidade com e sem proventos (1 mês a 10 anos, em reais, já com o câmbio), proventos por BDR em R$ e desdobramentos com a conferência pelo preço. `serie=True` devolve o fechamento DIÁRIO em colunas (sem chave, amostra dos últimos 30 pregões). AAPL34 é aberto; os demais exigem chave_api. NÃO tem o código da ação lá fora nem a proporção BDR:ação. Não é recomendação.
{
"type": "object",
"title": "bdrArguments",
"properties": {
"de": {
"type": "string",
"title": "De",
"default": "",
"description": "Início da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
},
"ate": {
"type": "string",
"title": "Ate",
"default": "",
"description": "Fim da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
},
"tipo": {
"type": "string",
"title": "Tipo",
"default": "",
"description": "Filtro de tipo de BDR: DRN, DR1, DR2, DR3 ou DRE. Vazio = todos."
},
"serie": {
"type": "boolean",
"title": "Serie",
"default": false,
"description": "False (padrão) = resumo; True = série diária em colunas. Sem chave_api a série vem como amostra dos últimos 30 pregões."
},
"ticker": {
"type": "string",
"title": "Ticker",
"default": "",
"description": "Ticker do BDR, como AAPL34, NVDC34 ou IVVB39. Vazio = lista os BDRs negociados no último ano."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "BDRs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}eventos — Eventos corporativos de uma empresa
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). WEGE3 gratuita; demais tickers exigem chave_api. Ticker de companhia que SAIU da bolsa responde com `saiu_da_bolsa` (último pregão e link), mesmo sem chave.
{
"type": "object",
"title": "eventosArguments",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Eventos corporativos de uma empresa",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}scores — Scores de qualidade de uma empresa
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; demais tickers exigem chave_api (grátis ou Pro): esta ferramenta não faz parte da vitrine aberta.
{
"type": "object",
"title": "scoresArguments",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Scores de qualidade de uma empresa",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}reapresentacoes — Reapresentações de balanço
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; demais tickers exigem chave_api (grátis ou Pro): as reapresentações por versão ficam atrás de chave.
{
"type": "object",
"title": "reapresentacoesArguments",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Reapresentações de balanço",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}fatos_contabeis — Fatos contábeis de uma empresa
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`. ABERTA: qualquer ticker, sem chave, um por vez, com o histórico de hoje (a versão vigente de cada período). O balanço como estava numa data passada (`as_of`) e as versões antigas não existem aqui: na REST exigem chave. Sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave. Traz `citacao`.
{
"type": "object",
"title": "fatos_contabeisArguments",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
},
"trimestral": {
"type": "boolean",
"title": "Trimestral",
"default": false,
"description": "False (padrão) = DFP anual; True = ITR trimestral (1T a 3T isolados)."
}
}
}{
"title": "Fatos contábeis de uma empresa",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}metodologia — Metodologia dos indicadores
Metodologia pública dos indicadores. Sem argumento, lista as páginas; com nome (ex.: 'roic'), devolve o texto completo. Gratuito.
{
"type": "object",
"title": "metodologiaArguments",
"properties": {
"nome": {
"type": "string",
"title": "Nome",
"default": "",
"description": "Nome da página de metodologia (ex.: roic, dividendos). Vazio = lista as páginas disponíveis."
}
}
}{
"title": "Metodologia dos indicadores",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}auditar_amostra — Auditoria de 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.
{
"type": "object",
"title": "auditar_amostraArguments",
"required": [
"semente"
],
"properties": {
"n": {
"type": "integer",
"title": "N",
"default": 25,
"description": "Quantidade de casos sorteados, inteiro de 1 a 25 (padrão 25)."
},
"semente": {
"type": "integer",
"title": "Semente",
"description": "Inteiro à sua escolha; a mesma semente devolve sempre os mesmos casos."
}
}
}{
"title": "Auditoria de amostra",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}dicionario — Dicionário de indicadores
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.
{
"type": "object",
"title": "dicionarioArguments",
"properties": {}
}{
"title": "Dicionário de indicadores",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}screener — Screener de ações
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) e os múltiplos pl (P/L anual, da DFP) e pl_ttm (P/L de 12 meses, do ITR ou DFP mais recente), ex. {"pl_max": 10}; P/L negativo, acima de 200 ou ausente nunca passa e a linha traz `multiplos` com `dt_receb`, `data_preco` e `ressalvas` do valor (`rigor="estrito"` só aceita P/L sem nenhuma ressalva; `fora_do_filtro` explica quem ficou de fora). 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).
{
"type": "object",
"title": "screenerArguments",
"required": [
"filtros"
],
"properties": {
"ano": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Ano",
"default": null,
"description": "Exercício a filtrar (ex.: 2024). Vazio = o último de cada empresa. Não se combina com `as_of`."
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "As Of",
"default": null,
"description": "Data AAAA-MM-DD: usa só o que já era público naquele dia (balanço recebido pela CVM). Não se combina com `ano`."
},
"rigor": {
"type": "string",
"title": "Rigor",
"default": "padrao",
"description": "Rigor do P/L: \"padrao\" (padrão) ou \"estrito\" (só P/L sem nenhuma ressalva)."
},
"recibo": {
"type": "boolean",
"title": "Recibo",
"default": false,
"description": "True congela a resposta num endereço permanente com sha256; False (padrão) = sem recibo."
},
"filtros": {
"type": "object",
"title": "Filtros",
"description": "Dicionário de filtros, ex.: {\"roic_min\": 0.15, \"dl_ebitda_max\": 2}. Chaves = indicador + sufixo _min ou _max.",
"additionalProperties": true
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Screener de ações",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}fiis_ranking — Ranking de FIIs
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. ABERTA, sem chave (sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave). Traz `citacao`. O filtro em massa por faixas é `screener_fiis`, que exige chave.
{
"type": "object",
"title": "fiis_rankingArguments",
"properties": {
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Ranking de FIIs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}fii — Ficha de um 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. ABERTA: qualquer FII, sem chave, um por vez (sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave). Traz `citacao`. `serie=True` devolve a série DIÁRIA em colunas (abertura, máxima, mínima, fechamento, volume, negócios, quantidade; sem ajuste, com os saltos sinalizados); sem chave, amostra dos últimos 30 pregões (MXRF11 vem inteiro).
{
"type": "object",
"title": "fiiArguments",
"required": [
"ticker"
],
"properties": {
"de": {
"type": "string",
"title": "De",
"default": "",
"description": "Início da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
},
"ate": {
"type": "string",
"title": "Ate",
"default": "",
"description": "Fim da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
},
"serie": {
"type": "boolean",
"title": "Serie",
"default": false,
"description": "False (padrão) = detalhe do fundo; True = série diária em colunas. Sem chave_api, amostra dos últimos 30 pregões (MXRF11 vem inteiro)."
},
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker de FII, como MXRF11, HGLG11 ou KNRI11 (sem distinção de caixa; aceita .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Ficha de um FII",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}veredito — Veredito de uma empresa
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.
{
"type": "object",
"title": "vereditoArguments",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
}
}
}{
"title": "Veredito de uma empresa",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}screener_fiis — Screener de 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).
{
"type": "object",
"title": "screener_fiisArguments",
"required": [
"filtros"
],
"properties": {
"filtros": {
"type": "object",
"title": "Filtros",
"description": "Dicionário de filtros, ex.: {\"pvp_max\": 0.9, \"dy_min\": 0.10, \"segmento\": \"Logística\", \"cotistas_min\": 5000}. Chaves válidas: pvp_min, pvp_max, dy_min, dy_max, segmento, cotistas_min.",
"additionalProperties": true
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Screener de FIIs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}trimestres — Resultados trimestrais de uma empresa
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.
{
"type": "object",
"title": "trimestresArguments",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Resultados trimestrais de uma empresa",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}hoje — Resumo do mercado 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.
{
"type": "object",
"title": "hojeArguments",
"properties": {}
}{
"title": "Resumo do mercado hoje",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}fatos_relevantes — Fatos relevantes entregues à CVM
Os últimos Fatos Relevantes (ou Comunicados ao Mercado) que as companhias entregaram à CVM, do mais recente para o mais antigo, cada um com a companhia, o assunto (texto livre da companhia), a data de entrega, o protocolo e o LINK DO DOCUMENTO ORIGINAL na CVM. `ticker` filtra por companhia (ex.: PETR4); `categoria` é "Fato Relevante" ou "Comunicado ao Mercado". Cada item traz `frase`, uma sentença só descritiva. Sem resumo, sem leitura de impacto e sem recomendação. ATENÇÃO: a fonte são os dados abertos da CVM (ODbL), que a CVM atualiza SEMANALMENTE e que trazem a data, não a hora; o campo `fonte` diz quando o arquivo foi atualizado. Gratuito, sem chave. Traz `citacao`.
{
"type": "object",
"title": "fatos_relevantesArguments",
"properties": {
"limite": {
"type": "integer",
"title": "Limite",
"default": 20,
"description": "Quantidade de documentos, inteiro de 1 a 100 (padrão 20), do mais recente ao mais antigo."
},
"ticker": {
"type": "string",
"title": "Ticker",
"default": "",
"description": "Ticker de companhia opcional, como PETR4. Vazio = todas."
},
"categoria": {
"type": "string",
"title": "Categoria",
"default": "Fato Relevante",
"description": "Categoria: \"Fato Relevante\" (padrão) ou \"Comunicado ao Mercado\"."
}
}
}{
"title": "Fatos relevantes entregues à CVM",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}saude — Saúde dos dados
Cobertura atual do banco (contagens e última ingestão). Gratuito.
{
"type": "object",
"title": "saudeArguments",
"properties": {}
}{
"title": "Saúde dos dados",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}etfs_ranking — Ranking de ETFs
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.
{
"type": "object",
"title": "etfs_rankingArguments",
"properties": {}
}{
"title": "Ranking de ETFs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}etf — Ficha de um 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). `serie=True` devolve a série DIÁRIA em colunas (abertura, máxima, mínima, fechamento, volume, negócios, quantidade e `fechamento_ajustado` por desdobramento conferido), com os eventos, os saltos sem explicação e o retorno com rendimentos reinvestidos; `de`/`ate` recortam; sem chave, amostra dos últimos 30 pregões (BOVA11 vem inteiro).
{
"type": "object",
"title": "etfArguments",
"required": [
"ticker"
],
"properties": {
"de": {
"type": "string",
"title": "De",
"default": "",
"description": "Início da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
},
"ate": {
"type": "string",
"title": "Ate",
"default": "",
"description": "Fim da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
},
"serie": {
"type": "boolean",
"title": "Serie",
"default": false,
"description": "False (padrão) = detalhe do ETF; True = série diária em colunas. Sem chave_api, amostra dos últimos 30 pregões (BOVA11 vem inteiro)."
},
"ticker": {
"type": "string",
"title": "Ticker",
"description": "Ticker de ETF, como BOVA11 ou IVVB11 (sem distinção de caixa; aceita .SA)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Ficha de um ETF",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}listas — Listas com data (resposta pronta)
A LISTA COM DATA PRONTA, sem montar nada: devolve o ranking já calculado, com o nome, a DATA-BASE, o critério (liquidez de R$ 5 milhões por dia em 63 pregões, teto de 30% de DY, 5.000 cotistas...), as linhas (ticker, valores), a fonte e a `source_url` da página canônica para citar. É a MESMA conta das páginas dadosb3.com/listas/...: use esta ferramenta em vez de ler uma página por ação para montar um ranking. `lista`: "dividendos" (as ações líquidas de maior dividend yield de 12 meses, uma classe por empresa), "pl" (ações líquidas com P/L abaixo de 10) ou "fiis" (FIIs de maior rendimento em 12 meses). Vazio devolve o catálogo das três. `limite`: de 1 a 20 linhas (padrão 20). ABERTA: sem chave (sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave). Informação histórica, não é recomendação: a nota vem na resposta.
{
"type": "object",
"title": "listasArguments",
"properties": {
"lista": {
"type": "string",
"title": "Lista",
"default": "",
"description": "Qual lista: \"dividendos\", \"pl\" ou \"fiis\". Vazio = o catálogo das três."
},
"limite": {
"type": "integer",
"title": "Limite",
"default": 20,
"description": "Quantidade de linhas, inteiro de 1 a 20 (padrão 20)."
},
"chave_api": {
"type": "string",
"title": "Chave Api",
"default": "",
"description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
}
}
}{
"title": "Listas com data (resposta pronta)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
0 advertised
Resources
0 advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1021 ms
- 95th percentile latency
- 1021 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1021 ms · metadata changed · 36 tool(s), 0 resource(s), 0 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http dados-b3-mcp-dadosb3 https://dadosb3.com/mcp/Codex
codex mcp add dados-b3-mcp-dadosb3 --url https://dadosb3.com/mcp/Cursor
{
"mcpServers": {
"dados-b3-mcp-dadosb3": {
"url": "https://dadosb3.com/mcp/"
}
}
}Cline
{
"mcpServers": {
"dados-b3-mcp-dadosb3": {
"type": "streamableHttp",
"url": "https://dadosb3.com/mcp/",
"disabled": false
}
}
}VS Code
{
"servers": {
"dados-b3-mcp-dadosb3": {
"type": "http",
"url": "https://dadosb3.com/mcp/"
}
}
}Gemini CLI
gemini mcp add --transport http dados-b3-mcp-dadosb3 https://dadosb3.com/mcp/Claude Desktop
https://dadosb3.com/mcp/Windsurf
{
"mcpServers": {
"dados-b3-mcp-dadosb3": {
"serverUrl": "https://dadosb3.com/mcp/"
}
}
}Let your agent find its tools
Find servers like Dados B3 MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.