{"data":{"name":"io.github.Val7h/dados-b3","title":"Dados B3","description":"Brazilian stock (B3) fundamentals: ratios, dividends, scores, FIIs, ETFs, BDRs. Open methodology.","version":"1.9.0","websiteUrl":null,"repositoryUrl":"https://github.com/Val7h/dados-b3-mcp","remotes":[{"url":"https://dadosb3.com/mcp/","type":"streamable-http"}],"packages":[{"identifier":"ghcr.io/val7h/dados-b3-mcp:1.9.0","runtimeHint":"stdio","registryType":"oci","runtimeArguments":null,"environmentVariables":null}],"status":"active","isLatest":true,"publishedAt":"2026-10-11T19:04:35.010Z","updatedAt":"2026-10-11T19:04:35.010Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"Dados B3","source":"official-registry","sourceId":"io.github.Val7h/dados-b3","updatedAt":"2026-10-11T19:04:35.010Z","confidence":100,"websiteUrl":null,"description":"Brazilian stock (B3) fundamentals: ratios, dividends, scores, FIIs, ETFs, BDRs. Open methodology.","verification":"official","repositoryUrl":"https://github.com/Val7h/dados-b3-mcp"}],"toolIndex":{"tools":[{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"acessos_telecom","title":"Acessos de telecom por operadora (Anatel)","description":"Quantas linhas móveis e acessos de banda larga cada operadora tem, mês a mês (Vivo, TIM, Claro).\nUse quando: \"quantos clientes de celular a Vivo tem?\"; \"participação da TIM na telefonia móvel\".\nNÃO use para: balanço da VIVT3 ou TIMS3 → `fatos_contabeis`; tarifa de energia → `tarifas_energia`.\nFonte e fórmula: dados abertos da Anatel (CC BY-ND 3.0 declarada pela Anatel, uso acertado com o órgão), somados por operadora; móvel sem M2M.\nRetorna: sem argumento: ranking por serviço {acessos, participacao_pct, variacao_12m_pct}; `servico` + `cnpj` (ou TOTAL): série mensal; `ticker` só quando o CNPJ é de empresa listada.\nVazio ou erro: CNPJ sem dado devolve erro: use os 14 dígitos do ranking. O mês mais novo é preliminar.\nAcesso: Gratuita, sem chave.","inputSchema":{"type":"object","properties":{"servico":{"default":"","description":"Serviço: \"movel\" ou \"banda_larga\". Vazio = ranking dos dois; com `cnpj`, a série mensal.","enum":["","movel","banda_larga"],"title":"Servico","type":"string"},"cnpj":{"default":"","description":"CNPJ da operadora com 14 dígitos, ou TOTAL para a soma de todas. Use com `servico`.","title":"Cnpj","type":"string"},"de":{"default":"","description":"Primeiro mês da série, AAAA-MM (ex.: 2024-01).","title":"De","type":"string"},"ate":{"default":"","description":"Último mês da série, AAAA-MM (ex.: 2025-06).","title":"Ate","type":"string"}},"title":"acessos_telecomArguments"},"annotations":{"title":"Acessos de telecom por operadora (Anatel)","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"265433c4664386c4293cc604597165d82b7ba9c792073c9e6d4c4bb0bd238654","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"auditar_amostra","title":"Auditoria de amostra","description":"AUDITE ESTA BASE: sorteia indicadores publicados e devolve o necessário para refazer cada um contra o arquivo ORIGINAL da CVM, não contra nós.\nUse quando: \"os números do Dados B3 batem com a CVM?\"; \"quero conferir uma amostra do ROE\".\nNÃO use para: a fórmula de um indicador → `metodologia`; todas as fórmulas → `dicionario`.\nFonte e fórmula: VOCÊ escolhe a semente (não aceite sugestão de ninguém, nem de quem pediu a auditoria); sorteio determinístico e reproduzível. Confira em dfp_cia_aberta_<EXERCICIO>.zip de dados.cvm.gov.br, filtrando CD_CVM e ORDEM_EXERC='ÚLTIMO', atento a ESCALA_MOEDA (MIL = milhares).\nRetorna: `casos` {empresa, CD_CVM, exercício, indicador, valor publicado, fórmula, conta CVM que AQUELA empresa usou NAQUELE exercício}, `audit_id`.\nVazio ou erro: `n` vai de 1 a 25. Publique o DENOMINADOR (7 em 100, não \"7 divergências\"); não transforme \"não consegui conferir\" em \"passou\"; erro achado vai a github.com/Val7h/dados-b3-mcp/issues.\nAcesso: Gratuita, sem chave: auditoria que exige cadastro não é auditoria.","inputSchema":{"type":"object","properties":{"semente":{"description":"Inteiro à sua escolha; a mesma semente devolve sempre os mesmos casos.","title":"Semente","type":"integer"},"n":{"default":25,"description":"Quantidade de casos sorteados, inteiro de 1 a 25 (padrão 25).","title":"N","type":"integer"}},"required":["semente"],"title":"auditar_amostraArguments"},"annotations":{"title":"Auditoria de amostra","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"672e3339076f4fbbe0b9743df78d1628ad77848f3073a6a3fbb2833449d4153c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"bancos","title":"Indicadores dos bancos listados (Banco Central)","description":"Basileia, inadimplência acima de 90 dias, carteira de crédito e lucro dos BANCOS listados, por trimestre.\nUse quando: \"qual banco tem a maior inadimplência?\"; \"índice de Basileia do Itaú\"; \"compare BBAS3 e BBDC4\".\nNÃO use para: ROE anual do banco → `indicadores_anuais`; P/L ou P/VP do banco → `multiplos`; dividendos do banco → `dividendos`.\nFonte e fórmula: IF.data do Banco Central (conglomerado prudencial, ODbL), sem recálculo; inadimplência = divisão de duas linhas do próprio BC.\nRetorna: sem `ticker`: `bancos` (último trimestre de cada um em `ultimo`, ordem da carteira de crédito); com `ticker`: `serie` trimestral {basileia_pct, inadimplencia_90d_pct, carteira_credito_rs_mil}.\nVazio ou erro: ticker que não é banco devolve erro: chame sem `ticker` para ver os bancos cobertos.\nAcesso: Gratuita, sem chave.","inputSchema":{"type":"object","properties":{"ticker":{"default":"","description":"Ticker de banco opcional, como ITUB4, BBDC4, BBAS3 ou SANB11. Vazio = todos os bancos, último trimestre.","title":"Ticker","type":"string"}},"title":"bancosArguments"},"annotations":{"title":"Indicadores dos bancos listados (Banco Central)","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"6a386c906a47e49e886efc9374c135a44032525a7f5591499067175f81e43d5e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"bdr","title":"BDRs","description":"BDRs negociados na B3 (Apple AAPL34, Nvidia NVDC34, IVVB39): lista, preço em reais, rentabilidade e proventos.\nUse quando: \"quais BDRs são mais negociados?\"; \"quanto rendeu AAPL34 em 5 anos?\"; \"BDR patrocinado ou não?\".\nNÃO use para: ação brasileira → `precos`; ETF brasileiro → `etf`.\nFonte e fórmula: cadastro e COTAHIST da B3; rentabilidade em reais, já com o câmbio; proventos por BDR em R$.\nRetorna: `ticker=\"\"`: lista {ticker, tipo, último fechamento, liquidez}; com `ticker`: cadastro, último pregão, rentabilidade com e sem proventos (1 mês a 10 anos), proventos e desdobramentos; `serie=True`: `colunas`/`linhas`.\nVazio ou erro: não tem o código da ação lá fora nem a proporção BDR:ação. Série sem chave = amostra de 30 pregões.\nAcesso: Lista e AAPL34 abertos; detalhe dos demais exige chave_api (grátis).","inputSchema":{"type":"object","properties":{"ticker":{"default":"","description":"Ticker do BDR, como AAPL34, NVDC34 ou IVVB39. Vazio = lista os BDRs negociados no último ano.","title":"Ticker","type":"string"},"tipo":{"default":"","description":"Filtro de tipo de BDR: DRN, DR1, DR2, DR3 ou DRE. Vazio = todos.","enum":["","DRN","DR1","DR2","DR3","DRE"],"title":"Tipo","type":"string"},"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.","title":"Serie","type":"boolean"},"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).","title":"De","type":"string"},"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).","title":"Ate","type":"string"},"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":"Chave Api","type":"string"}},"title":"bdrArguments"},"annotations":{"title":"BDRs","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"74e527f9fb08a54b89c688bc8bc5a12bf02c1174cc47d9e79de7dceb875afcca","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"desempenho","title":"Desempenho de uma ação","description":"Quanto uma AÇÃO subiu ou caiu num período escolhido: retorno, retorno com dividendos, queda máxima e volatilidade, prontos.\nUse quando: \"quanto a PETR4 rendeu de 2020 a 2024 com dividendos?\"; \"qual a maior queda da MGLU3 nos últimos 5 anos?\"; \"cruzamento de médias 21 x 100 valeu a pena na VALE3?\".\nNÃO use para: R$ 1.000 em 1, 3, 5 ou 10 anos, ou FII/ETF → `quanto_rendeu`; a série diária → `precos`; benchmark IBOV/IFIX → `indice`; lucro, margem, endividamento → `veredito`.\nFonte e fórmula: COTAHIST da B3, preço AJUSTADO por eventos societários; retorno total reinveste dividendos e JCP na data-ex; sem custos nem impostos.\nRetorna: `buy_and_hold` e `cruzamento_de_medias` {retorno_pct, retorno_total_pct, drawdown_maximo com datas, volatilidade}; `de`/`ate`; `premissas`.\nVazio ou erro: padrão: últimos 5 anos. Período sem pregão suficiente devolve erro: amplie `de`/`ate`. Código de FII ou ETF traz `tente_assim` com `quanto_rendeu`.\nAcesso: Aberta, sem chave, qualquer ticker; `chave_api` é aceita e desnecessária.","inputSchema":{"type":"object","properties":{"ticker":{"description":"Código de AÇÃO na B3, ex.: PETR4, VALE3, ITUB4. Aceita petr4, PETR4.SA, BVMF:PETR4, PETR4F (fracionário) e código antigo (vira o atual). Código de FII, ETF ou BDR devolve erro com `tente_assim`.","examples":["PETR4","VALE3","ITUB4"],"title":"Ticker","type":"string"},"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.","title":"De","type":"string"},"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.","title":"Ate","type":"string"},"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).","title":"Media Curta","type":"integer"},"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":"Media Longa","type":"integer"},"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":"Chave Api","type":"string"}},"required":["ticker"],"title":"desempenhoArguments"},"annotations":{"title":"Desempenho de uma ação","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"fa35b5d3fe4730c96020208dddf2671e54e1756e9a2cf9e0a3358ccf308534a0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"dicionario","title":"Dicionário de indicadores","description":"Todas as fórmulas dos indicadores em JSON: fórmula, contas CVM e a BASE do lucro de cada um.\nUse quando: \"o ROE usa lucro dos controladores ou total?\"; \"quais contas entram na dívida líquida?\".\nNÃO use para: texto explicativo de um indicador → `metodologia`; valores de uma empresa → `indicadores_anuais`.\nFonte e fórmula: a mesma definição usada no cálculo. margem_liquida usa lucro consolidado TOTAL; roe usa lucro dos CONTROLADORES.\nRetorna: `indicadores`: uma entrada por indicador {formula, contas_cvm, base do lucro}.\nVazio ou erro: não fica vazio.\nAcesso: Gratuita, sem chave.","inputSchema":{"type":"object","properties":{},"title":"dicionarioArguments"},"annotations":{"title":"Dicionário de indicadores","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"5ac2c8fee113653c9173cc3ef5bdbf93640fb0c2a6fa321255b667eb2afb4c32","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"dividendos","title":"Dividendos de uma empresa","description":"Quanto uma AÇÃO pagou de dividendos e JCP: valor por ação, data-com, data de pagamento e dividend yield (DY) de 12 meses.\nUse quando: \"quanto a Petrobras PN pagou de dividendos nos últimos 12 meses?\"; \"qual o DY do Itaú?\"; \"a Petz pagou dividendos antes de sair da bolsa?\".\nNÃO use para: rendimento ou DY de FII (HGLG11, MXRF11) → `fii`; ranking das maiores pagadoras → `listas`; lista de quem saiu da bolsa → `saiu_da_bolsa`.\nFonte e fórmula: proventos em dinheiro da B3 e da CVM, valor bruto (sem os 15% de IR do JCP); DY 12m = soma dos proventos com data-com nos últimos 365 dias ÷ último fechamento. Quem saiu da bolsa: Formulário de Referência (até ~2021) e IPE (desde 2024).\nRetorna: `proventos` {tipo, valor, data aprovação, data_com, preco_com, parcela, data_pagamento} de TODAS as classes (ON e PN): não some a lista; `resumo_anual` e DY 12 meses só da classe pedida, com o total do ano corrente até hoje e do ano anterior fechado; `citacao`. Delistada: `saiu_da_bolsa` e `cobertura.fontes`.\nVazio ou erro: lista vazia de companhia listada = nenhum provento em dinheiro registrado no período, não erro. Erro com `saiu_da_bolsa` = ausência DESCONHECIDA, não \"não pagou\". Código de FII devolve `tente_assim` com `fii`.\nAcesso: 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`: cite-a ao usar o número.","inputSchema":{"type":"object","properties":{"ticker":{"description":"Código de AÇÃO na B3, ex.: PETR4, VALE3, ITUB4. Aceita petr4, PETR4.SA, BVMF:PETR4, PETR4F (fracionário) e código antigo (vira o atual). Código de FII, ETF ou BDR devolve erro com `tente_assim`.","examples":["PETR4","VALE3","ITUB4"],"title":"Ticker","type":"string"},"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":"Chave Api","type":"string"}},"required":["ticker"],"title":"dividendosArguments"},"annotations":{"title":"Dividendos de uma empresa","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"0cd8acc2de7c321359063eb893fdd71cda5c42480695aaa556cfb50c3fa57d29","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"etf","title":"Ficha de um ETF","description":"Um ETF da B3 (BOVA11, IVVB11, SMAL11): ágio ou deságio sobre a cota, taxa efetiva, carteira e retornos.\nUse quando: \"qual o ágio do BOVA11?\"; \"o que tem na carteira do IVVB11?\"; \"preço diário do SMAL11\".\nNÃO use para: comparar vários ETFs → `etfs_ranking`; R$ 1.000 em 1 a 10 anos → `quanto_rendeu`.\nFonte e fórmula: cadastro CVM + B3, informe diário do FNET, balancete (taxa EFETIVA, não a nominal), carteira da CVM; retorno pela cota = retorno total.\nRetorna: `cadastro`, `ultimo_informe`, `agio_30_pregoes`, `taxa_efetiva_mensal`, `carteira` (10 maiores, sobreposição), `retornos_pela_cota`, `retornos_pelo_preco`; `serie=True`: `colunas`/`linhas`.\nVazio ou erro: ETF desconhecido devolve erro: veja `etfs_ranking`. Série sem chave = amostra de 30 pregões.\nAcesso: BOVA11 sem chave; demais exigem chave_api (grátis ou Pro).","inputSchema":{"type":"object","properties":{"ticker":{"description":"Código do ETF na B3, ex.: BOVA11, IVVB11, SMAL11. Aceita caixa baixa e .SA.","examples":["BOVA11","IVVB11"],"title":"Ticker","type":"string"},"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":"Chave Api","type":"string"},"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).","title":"Serie","type":"boolean"},"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).","title":"De","type":"string"},"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).","title":"Ate","type":"string"}},"required":["ticker"],"title":"etfArguments"},"annotations":{"title":"Ficha de um ETF","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"a5f4fdf6f2a3956673b438724a01bbfb2c9571ac939bac0082e5f370236ca579","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"etfs_ranking","title":"Ranking de ETFs","description":"Ranking dos ETFs da B3: mais negociados, maior patrimônio, ágio e deságio, retorno 12 meses e menor taxa efetiva.\nUse quando: \"qual ETF tem a menor taxa?\"; \"ETFs mais negociados da B3\"; \"algum ETF negocia com deságio?\".\nNÃO use para: um ETF específico (BOVA11, IVVB11) → `etf`; BDR de ETF → `bdr`.\nFonte e fórmula: informe diário do FNET e COTAHIST; ágio = preço ÷ cota do MESMO dia; taxa EFETIVA = despesa do balancete ÷ PL médio, anualizada; só ETF com liquidez > R$ 1 mi/dia em ágio, retorno e taxa.\nRetorna: listas `mais_negociados`, `maior_patrimonio`, `maior_desagio`, `maior_agio`, `retorno_12m_pela_cota`, `menor_taxa_efetiva`, `por_tipo`, `dados_ate`.\nVazio ou erro: erro \"sendo construídos\" = tente em minutos.\nAcesso: Gratuita, sem chave.","inputSchema":{"type":"object","properties":{},"title":"etfs_rankingArguments"},"annotations":{"title":"Ranking de ETFs","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e4b6ebacd7d4b0f3ef62556b1ca77c7f905eafddd8a5f5d70a313ad1f69f9b6a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"eventos","title":"Eventos corporativos de uma empresa","description":"Desdobramentos, grupamentos, bonificações e cisões de uma ação, com a fonte e o que o preço confirmou.\nUse quando: \"a WEG fez desdobramento?\"; \"quando foi o grupamento da MGLU3?\".\nNÃO use para: dividendos e JCP → `dividendos`; troca de ticker no mês → `hoje`.\nFonte e fórmula: eventos declarados pela B3 ou achados por nós no preço, cada um com `fonte`; eventos do mesmo dia formam uma operação (`efeito_liquido_do_dia`).\nRetorna: lista de eventos {data, tipo, fator, fonte, conferência pelo preço (confirmou, não distingue, discorda)}.\nVazio ou erro: lista vazia = nenhum evento registrado. Empresa que saiu da bolsa responde com `saiu_da_bolsa`.\nAcesso: WEGE3 sem chave; demais tickers exigem chave_api (grátis).","inputSchema":{"type":"object","properties":{"ticker":{"description":"Código de AÇÃO na B3, ex.: PETR4, VALE3, ITUB4. Aceita petr4, PETR4.SA, BVMF:PETR4, PETR4F (fracionário) e código antigo (vira o atual). Código de FII, ETF ou BDR devolve erro com `tente_assim`.","examples":["PETR4","VALE3","ITUB4"],"title":"Ticker","type":"string"},"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":"Chave Api","type":"string"}},"required":["ticker"],"title":"eventosArguments"},"annotations":{"title":"Eventos corporativos de uma empresa","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"12c2c85f0a1b49018b8dd1bfc01b207349c38ae2982f537a4629737d712cee9b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"fatos_contabeis","title":"Fatos contábeis de uma empresa","description":"Receita, EBIT, lucro, patrimônio, dívida e caixa de uma AÇÃO em R$, por ano ou trimestre, com a conta CVM de cada número.\nUse quando: \"qual foi a receita líquida e o lucro da WEG em 2025?\"; \"lucro do 2T da Petrobras\"; \"caixa da Magalu no último balanço\".\nNÃO use para: ROE, margem, dívida/EBITDA já calculados → `indicadores_anuais`; versões republicadas → `reapresentacoes`; informe de FII → `fii`.\nFonte e fórmula: DFP (anual) ou ITR (`trimestral=True`, 1T a 3T isolados) da CVM, versão vigente; `origem` = conta CVM exata. O balanço numa data passada (`as_of`) e versões antigas só na REST, com chave.\nRetorna: `fatos`: uma linha por período com as contas padronizadas em R$ e `origem`; `citacao`.\nVazio ou erro: o 4º trimestre não vem no trimestral (é a DFP anual). Erro de código traz `sugestoes`; FII aponta para `fii`.\nAcesso: 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`: cite-a ao usar o número.","inputSchema":{"type":"object","properties":{"ticker":{"description":"Código de AÇÃO na B3, ex.: PETR4, VALE3, ITUB4. Aceita petr4, PETR4.SA, BVMF:PETR4, PETR4F (fracionário) e código antigo (vira o atual). Código de FII, ETF ou BDR devolve erro com `tente_assim`.","examples":["PETR4","VALE3","ITUB4"],"title":"Ticker","type":"string"},"trimestral":{"default":false,"description":"False (padrão) = DFP anual; True = ITR trimestral (1T a 3T isolados).","title":"Trimestral","type":"boolean"},"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":"Chave Api","type":"string"}},"required":["ticker"],"title":"fatos_contabeisArguments"},"annotations":{"title":"Fatos contábeis de uma empresa","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"76784106a8a1d72f4dcdb3049600b1deac5947c149aca9c5aab99e813545fcf5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"fatos_relevantes","title":"Fatos relevantes entregues à CVM","description":"Os últimos Fatos Relevantes e Comunicados ao Mercado entregues à CVM, com o link do documento original.\nUse quando: \"últimos fatos relevantes da Petrobras\"; \"alguma empresa anunciou fusão esta semana?\".\nNÃO use para: resumo do mês com balanços e proventos → `hoje`; lista de quem saiu da bolsa → `saiu_da_bolsa`.\nFonte e fórmula: dados abertos da CVM (ODbL), atualizados SEMANALMENTE, com a data e sem a hora; `frase` é só descritiva, sem leitura de impacto.\nRetorna: itens {companhia, assunto, data de entrega, protocolo, link CVM, frase}, `fonte`, `citacao`.\nVazio ou erro: lista vazia = nenhum documento da categoria no arquivo; troque `categoria` ou aumente `limite`.\nAcesso: Gratuita, sem chave.","inputSchema":{"type":"object","properties":{"ticker":{"default":"","description":"Ticker de companhia opcional, como PETR4. Vazio = todas.","title":"Ticker","type":"string"},"limite":{"default":20,"description":"Quantidade de documentos, inteiro de 1 a 100 (padrão 20), do mais recente ao mais antigo.","title":"Limite","type":"integer"},"categoria":{"default":"Fato Relevante","description":"Categoria: \"Fato Relevante\" (padrão) ou \"Comunicado ao Mercado\".","enum":["Fato Relevante","Comunicado ao Mercado"],"title":"Categoria","type":"string"}},"title":"fatos_relevantesArguments"},"annotations":{"title":"Fatos relevantes entregues à CVM","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"da75376446d0ec44e035355b9d86f9479a67e938877957a3ea3ac60a7f683281","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"fii","title":"Ficha de um FII","description":"Um fundo imobiliário (FII): dividend yield 12 meses, rendimentos pagos, P/VP, vacância e cotistas, pelo ticker (HGLG11, MXRF11, KNRI11).\nUse quando: \"qual o DY dos últimos 12 meses do HGLG11?\"; \"o MXRF11 está acima ou abaixo do valor patrimonial?\"; \"quanto o KNRI11 pagou por cota no último mês?\".\nNÃO use para: comparar ou listar muitos FIIs → `fiis_ranking`; filtrar FIIs por faixas → `screener_fiis`; dividendos de ação → `dividendos`; preço de ação → `precos`; R$ 1.000 em 1 a 10 anos → `quanto_rendeu`.\nFonte e fórmula: informe mensal e trimestral da CVM + COTAHIST da B3; P/VP ponto-no-tempo = preço do 1º pregão após o informe ÷ VP da cota; DY 12m = rendimentos dos últimos 12 meses ÷ preço; vacância ponderada por área.\nRetorna: `cadastro`, `ultimo_informe` {cotistas, pl, competencia}, `pvp` (série), `dy_12m`, `proventos_recentes` (18), `vacancia` (só tijolo), `citacao`; `serie=True`: preço diário em `colunas`/`linhas`.\nVazio ou erro: vacância vazia = fundo de papel (sem imóvel). FII desconhecido devolve erro: confira em `fiis_ranking`. Série sem chave = amostra de 30 pregões.\nAcesso: 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`: cite-a ao usar o número.","inputSchema":{"type":"object","properties":{"ticker":{"description":"Código do FII na B3, ex.: HGLG11, MXRF11, KNRI11. Aceita caixa baixa, .SA e código antigo (vira o atual).","examples":["HGLG11","MXRF11","KNRI11"],"title":"Ticker","type":"string"},"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":"Chave Api","type":"string"},"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).","title":"Serie","type":"boolean"},"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).","title":"De","type":"string"},"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).","title":"Ate","type":"string"}},"required":["ticker"],"title":"fiiArguments"},"annotations":{"title":"Ficha de um FII","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"763675bfd73ee9d531612d519f81d6c4bea6ea79abeb2308a04ac124b523e465","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"fiis_ranking","title":"Ranking de FIIs","description":"Ranking dos fundos imobiliários (FIIs): menor P/VP, maior dividend yield 12 meses e medianas por segmento.\nUse quando: \"quais FIIs pagam mais dividendos?\"; \"FIIs mais descontados (menor P/VP)\"; \"DY médio dos FIIs de logística\".\nNÃO use para: um FII específico → `fii`; filtrar FIIs por faixas próprias → `screener_fiis`; lista pronta com data-base para citar → `listas`.\nFonte e fórmula: informe mensal da CVM + COTAHIST; P/VP = preço do 1º pregão após o informe ÷ VP da cota; DY 12m = rendimentos de 12 meses ÷ preço; só fundos líquidos e valores sem flag.\nRetorna: `mais_descontados` e `maiores_dy` (15 cada) {ticker, nome, segmento, pvp, dy_12m}, `por_segmento`, `fundos_liquidos`, `citacao`.\nVazio ou erro: erro \"sendo construídos\" = tente em minutos. Filtro em massa por faixas: `screener_fiis`, que exige chave.\nAcesso: 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`: cite-a ao usar o número.","inputSchema":{"type":"object","properties":{"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":"Chave Api","type":"string"}},"title":"fiis_rankingArguments"},"annotations":{"title":"Ranking de FIIs","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"b3673f027d21097e7843c3ad794990859bee888835338ae6821c662a6b53dc80","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"fundos_da_acao","title":"Fundos que têm uma ação na carteira (CDA da CVM)","description":"Quais fundos de investimento têm uma AÇÃO na carteira, quanto têm e quem aumentou ou reduziu no mês.\nUse quando: \"quais fundos têm PETR4?\"; \"os fundos venderam WEGE3 no último mês?\".\nNÃO use para: dados de um fundo pelo CNPJ → `fundos_investimento`; carteira de um ETF → `etf`.\nFonte e fórmula: CDA (Composição e Diversificação das Aplicações) entregue à CVM, bloco de ações, 13 meses (ODbL); a carteira sai depois do fim do mês.\nRetorna: maiores fundos por valor {fundo, valor, quantidade}, contadores e maiores movimentos de todos os fundos, e a data de referência.\nVazio ou erro: lista vazia = nenhum fundo declarou a ação no mês de referência. `limite` vai de 1 a 500.\nAcesso: WEGE3 sem chave; demais ações exigem chave_api (grátis).","inputSchema":{"type":"object","properties":{"ticker":{"description":"Código de AÇÃO na B3, ex.: PETR4, VALE3, ITUB4. Aceita petr4, PETR4.SA, BVMF:PETR4, PETR4F (fracionário) e código antigo (vira o atual). Código de FII, ETF ou BDR devolve erro com `tente_assim`.","examples":["PETR4","VALE3","ITUB4"],"title":"Ticker","type":"string"},"limite":{"default":20,"description":"Quantidade de fundos listados, inteiro de 1 a 500 (padrão 20), os maiores por valor.","title":"Limite","type":"integer"},"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":"Chave Api","type":"string"}},"required":["ticker"],"title":"fundos_da_acaoArguments"},"annotations":{"title":"Fundos que têm uma ação na carteira (CDA da CVM)","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"3fe4a99de67dac85cab86e166f8bc66e3a8ed761affb2d6e1ae06cc5b2a675de","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"fundos_investimento","title":"Fundos de investimento: cota, PL e captação (CVM)","description":"Fundos de investimento da CVM (renda fixa, multimercado, ações): cota, patrimônio, cotistas e captação.\nUse quando: \"quais fundos mais captaram este mês?\"; \"patrimônio do fundo Verde\"; \"série da cota do fundo CNPJ X\".\nNÃO use para: fundo imobiliário listado (FII) → `fii`; ETF listado → `etf`; quais fundos têm uma ação → `fundos_da_acao`.\nFonte e fórmula: Informe Diário da CVM (ODbL); captação líquida = captação − resgate; a variação mensal da cota é conta nossa, não a rentabilidade oficial.\nRetorna: sem argumento: `maiores_pl`, `maior_captacao_liquida`, `maior_resgate_liquido`; `cnpj`: o fundo com série de 13 meses; `busca`: por nome.\nVazio ou erro: busca sem resultado: tire acento ou use o começo do CNPJ. `limite` vai de 1 a 500.\nAcesso: Gratuita, sem chave.","inputSchema":{"type":"object","properties":{"cnpj":{"default":"","description":"CNPJ do fundo ou da classe com 14 dígitos; devolve a série de 13 meses.","title":"Cnpj","type":"string"},"busca":{"default":"","description":"Nome do fundo (sem acento e sem distinção de caixa) ou começo do CNPJ.","title":"Busca","type":"string"},"limite":{"default":20,"description":"Quantidade de fundos em cada ranking (padrão 20).","title":"Limite","type":"integer"}},"title":"fundos_investimentoArguments"},"annotations":{"title":"Fundos de investimento: cota, PL e captação (CVM)","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"b37e9ff4b9845dd9570ae32373a80b5b54573ee45ea04a746c8bb6610b756535","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"hoje","title":"Resumo do mercado hoje","description":"O que mudou no mercado brasileiro nos últimos 30 dias: balanços entregues, proventos aprovados, eventos e trocas de ticker.\nUse quando: \"o que aconteceu com a empresa X esta semana?\"; \"quais empresas divulgaram balanço este mês?\"; \"trocas de ticker recentes\".\nNÃO use para: texto de fato relevante → `fatos_relevantes`; histórico de dividendos → `dividendos`.\nFonte e fórmula: CVM (entregas e reenvios), B3 (proventos, eventos, códigos) e informes de FII.\nRetorna: seções `balancos`, `reenvios`, `proventos`, `rendimentos_fii`, `informes_fii`, `eventos`, `trocas`, cada uma com `dados_ate`.\nVazio ou erro: seção vazia = nada na janela; `dados_ate` antigo = fonte parada, não mercado parado.\nAcesso: Gratuita, sem chave.","inputSchema":{"type":"object","properties":{},"title":"hojeArguments"},"annotations":{"title":"Resumo do mercado hoje","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"212febb26ef91559ff44116fbe0e4335640f10eaeca217c305120e2e806d2bbf","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"indicadores_anuais","title":"Indicadores anuais de uma empresa","description":"ROE, ROIC, margens, crescimento da receita e dívida líquida/EBITDA de uma AÇÃO, ano a ano desde 2010.\nUse quando: \"qual o ROE do Itaú em 2025?\"; \"como está a dívida líquida da Vale em relação ao EBITDA?\"; \"a margem da WEG cresceu nos últimos 5 anos?\".\nNÃO use para: P/L, P/VP, EV/EBITDA → `multiplos`; ano corrente ou último trimestre → `trimestres`; receita, lucro e contas em R$ → `fatos_contabeis`; FII (P/VP, DY, vacância) → `fii`; Basileia e inadimplência de banco → `bancos`.\nFonte e fórmula: DFP anual da CVM, versão vigente; ROE = lucro dos controladores ÷ PL médio dos controladores; ROIC = NOPAT ÷ capital investido médio; fórmula e conta CVM de cada um em `proveniencia`; memória de cálculo em /linhagem/TICKER/ANO/INDICADOR.\nRetorna: `indicadores`: linhas {ano, nome, valor (decimal: 0,15 = 15%), flag}; `proveniencia`; `citacao`. flag não nula = confie menos e leia a metodologia.\nVazio ou erro: banco e seguradora vêm sem ROIC e EBITDA (não se aplicam ao plano de contas). Erro de código traz `sugestoes` e `tente_assim`; FII aponta para `fii`.\nAcesso: 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`: cite-a ao usar o número.","inputSchema":{"type":"object","properties":{"ticker":{"description":"Código de AÇÃO na B3, ex.: PETR4, VALE3, ITUB4. Aceita petr4, PETR4.SA, BVMF:PETR4, PETR4F (fracionário) e código antigo (vira o atual). Código de FII ou ETF devolve a série do fundo (com `atendido_como`); BDR devolve erro com `tente_assim`.","examples":["PETR4","VALE3","ITUB4"],"title":"Ticker","type":"string"},"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":"Chave Api","type":"string"}},"required":["ticker"],"title":"indicadores_anuaisArguments"},"annotations":{"title":"Indicadores anuais de uma empresa","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"3d2dc99abc5f2f97ecd3797eabbf6e76999788da5c5266f3a41c878084c1302c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"indice","title":"Índices de mercado","description":"Desempenho e pontos dos índices da B3 (IBOV, IFIX, SMLL, IDIV, IBXX): o benchmark para comparar uma ação ou um fundo.\nUse quando: \"quanto o Ibovespa subiu em 2025?\"; \"qual a queda máxima do IFIX nos últimos 5 anos?\"; \"pontos diários do IBOV desde janeiro\".\nNÃO use para: desempenho de uma ação → `desempenho`; ETF que replica o índice → `etf`.\nFonte e fórmula: série da B3; índices de RETORNO TOTAL (a B3 reinveste os proventos nos pontos).\nRetorna: padrão: desempenho {retorno, queda máxima, volatilidade; comprar e manter e médias 21 x 100}, últimos 5 anos; `serie=True`: `colunas` (data, fechamento) e `linhas`; `codigo=\"\"`: a lista.\nVazio ou erro: código desconhecido: chame com `codigo=\"\"` para a lista. ^BVSP vira IBOV. Série sem chave = amostra dos últimos 30 pregões.\nAcesso: Desempenho e lista abertos, sem chave; série inteira com `chave_api`.","inputSchema":{"type":"object","properties":{"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.","title":"Codigo","type":"string"},"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.","title":"Serie","type":"boolean"},"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.","title":"De","type":"string"},"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.","title":"Ate","type":"string"},"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).","title":"Media Curta","type":"integer"},"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":"Media Longa","type":"integer"},"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":"Chave Api","type":"string"}},"title":"indiceArguments"},"annotations":{"title":"Índices de mercado","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"44a0cc4b2bcacffc0bb81867a3e404e0a59844f1ddb41f30423914669d50fe33","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"listar_empresas","title":"Lista de empresas abertas","description":"Lista as companhias abertas brasileiras (ações da B3) com nome, código CVM e ticker principal.\nUse quando: \"qual o ticker da Gerdau?\"; \"quais empresas da B3 vocês cobrem?\".\nNÃO use para: fundo imobiliário → `fiis_ranking`; ETF → `etfs_ranking`; BDR → `bdr`; empresa que saiu da bolsa → `saiu_da_bolsa`.\nFonte e fórmula: cadastro de companhias abertas da CVM ligado ao código de negociação da B3.\nRetorna: `empresas`: lista de {cd_cvm, nome, ticker} (ticker nulo quando a companhia não tem papel negociado); a contagem é o tamanho da lista.\nVazio ou erro: não fica vazia; se o nome não aparecer, a companhia pode ter saído da bolsa (`saiu_da_bolsa`).\nAcesso: Gratuita, sem chave.","inputSchema":{"type":"object","properties":{},"title":"listar_empresasArguments"},"annotations":{"title":"Lista de empresas abertas","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"5c4f5ee780d5ae3327cc643707059d6d30e5aad749fa0e57355e2f66e58703e1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"listas","title":"Listas com data (resposta pronta)","description":"A lista pronta com data-base: maiores pagadoras de dividendos, ações com P/L abaixo de 10 e FIIs de maior rendimento.\nUse quando: \"quais ações mais pagaram dividendos nos últimos 12 meses?\"; \"ações com P/L abaixo de 10\"; \"FIIs que mais pagam\".\nNÃO use para: filtro próprio de ações → `screener`; filtro próprio de FIIs → `screener_fiis`; rankings de P/VP de FII → `fiis_ranking`; dividendos de uma ação → `dividendos`.\nFonte e fórmula: a mesma conta das páginas dadosb3.com/listas: liquidez mínima de R$ 5 mi/dia em 63 pregões, teto de 30% de DY marcado, uma classe por empresa; FIIs com 5.000 cotistas.\nRetorna: nome, data-base, critério, linhas {ticker, valores}, fonte e `source_url` para citar.\nVazio ou erro: `lista` vazia devolve o catálogo; nome desconhecido devolve erro com as válidas (dividendos, pl, fiis).\nAcesso: 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`: cite-a ao usar o número.","inputSchema":{"type":"object","properties":{"lista":{"default":"","description":"Qual lista: \"dividendos\", \"pl\" ou \"fiis\". Vazio = o catálogo das três.","enum":["","dividendos","pl","fiis"],"title":"Lista","type":"string"},"limite":{"default":20,"description":"Quantidade de linhas, inteiro de 1 a 20 (padrão 20).","title":"Limite","type":"integer"},"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":"Chave Api","type":"string"}},"title":"listasArguments"},"annotations":{"title":"Listas com data (resposta pronta)","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"cc3204d4128dcaa20fabcd67d97b2aedb3bf167c4cc9f3f22bdcd327ab52741a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"metodologia","title":"Metodologia dos indicadores","description":"Como cada número é calculado: a página de metodologia (fórmula, contas CVM, casos de borda).\nUse quando: \"como vocês calculam o ROIC?\"; \"qual a metodologia do DY de FII?\".\nNÃO use para: todas as fórmulas em JSON → `dicionario`; conferir números sorteados → `auditar_amostra`.\nFonte e fórmula: https://dadosb3.com/metodologia, o mesmo texto do site.\nRetorna: sem `nome`: `paginas`; com `nome` (roic, roe, dividendos, fiis, multiplos...): `conteudo` em markdown.\nVazio ou erro: nome desconhecido devolve erro: chame sem `nome` para a lista.\nAcesso: Gratuita, sem chave.","inputSchema":{"type":"object","properties":{"nome":{"default":"","description":"Nome da página de metodologia (ex.: roic, dividendos). Vazio = lista as páginas disponíveis.","title":"Nome","type":"string"}},"title":"metodologiaArguments"},"annotations":{"title":"Metodologia dos indicadores","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"09879e08bbf5483348245d3fee7ea509c496b4d9485bef72750b5d35cfadd52a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"multiplos","title":"Múltiplos de uma empresa","description":"P/L, P/VP e EV/EBITDA de uma AÇÃO por ano, e P/L de 12 meses (TTM) por trimestre: está cara ou barata contra a própria história.\nUse quando: \"qual o P/L da WEG hoje?\"; \"qual o P/VP do Banco do Brasil?\"; \"EV/EBITDA da Vale nos últimos anos\".\nNÃO use para: ROE, ROIC, margem, dívida/EBITDA → `indicadores_anuais`; P/VP de fundo imobiliário → `fii`; resumo com comparação ao setor → `veredito`; filtrar várias ações por P/L → `screener`.\nFonte e fórmula: preço do 1º pregão APÓS a publicação do balanço na CVM (sem informação futura) ÷ lucro, patrimônio ou EBITDA da DFP/ITR. Pelo método atual; o ponto-no-tempo numa data passada (`as_of`) só na REST, com chave.\nRetorna: `anuais` {ano, pl, pvp, ev_ebitda, data_preco, dt_receb, ressalvas}; `trimestrais` com pl_ttm; lpa, ações e valuation da rota REST.\nVazio ou erro: valor nulo = lucro negativo ou dado ausente (veja `ressalvas`). Erro de código traz `sugestoes` e `tente_assim`.\nAcesso: 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`: cite-a ao usar o número.","inputSchema":{"type":"object","properties":{"ticker":{"description":"Código de AÇÃO na B3, ex.: PETR4, VALE3, ITUB4. Aceita petr4, PETR4.SA, BVMF:PETR4, PETR4F (fracionário) e código antigo (vira o atual). Código de FII, ETF ou BDR devolve erro com `tente_assim`.","examples":["PETR4","VALE3","ITUB4"],"title":"Ticker","type":"string"},"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":"Chave Api","type":"string"}},"required":["ticker"],"title":"multiplosArguments"},"annotations":{"title":"Múltiplos de uma empresa","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"83e519ca3fb9332b9ef0d1112f19067f1d96571c2c34846f79c1cba2e15ec05a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"precos","title":"Histórico de preços","description":"Série DIÁRIA de preços de uma AÇÃO (abertura, máxima, mínima, fechamento, volume) num período.\nUse quando: \"preço de fechamento da PETR4 em 2024\"; \"cotação diária da VALE3 desde 2020\".\nNÃO use para: retorno, queda máxima ou volatilidade prontos → `desempenho`; quanto rendeu R$ 1.000 → `quanto_rendeu`; preço de FII → `fii`; preço de ETF → `etf`; preço de BDR → `bdr`; pontos do IBOV ou IFIX → `indice`.\nFonte e fórmula: COTAHIST da B3, preço NÃO ajustado; os eventos societários do período vêm em `eventos`.\nRetorna: por padrão `colunas` + `linhas` (data, fechamento), do mais antigo ao mais recente; `campos` pede mais colunas; `campos=\"todos\"` devolve `serie` com objetos (resposta grande); `limite` corta e avisa.\nVazio ou erro: sem chave, AMOSTRA dos últimos 30 pregões com `aviso`. Erro de código: FII, ETF, BDR ou índice trazem `tente_assim` com a ferramenta certa; repita lá.\nAcesso: WEGE3 completa sem chave; demais tickers sem chave devolvem a amostra; com `chave_api` (grátis), a série inteira.","inputSchema":{"type":"object","properties":{"ticker":{"description":"Código de AÇÃO na B3, ex.: PETR4, VALE3, ITUB4. Aceita petr4, PETR4.SA, BVMF:PETR4, PETR4F (fracionário) e código antigo (vira o atual). Código de FII, ETF ou BDR devolve erro com `tente_assim`.","examples":["PETR4","VALE3","ITUB4"],"title":"Ticker","type":"string"},"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.","title":"De","type":"string"},"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.","title":"Ate","type":"string"},"limite":{"default":1500,"description":"Máximo de pregões devolvidos (padrão 1500, máximo 20000); corta a partir do mais antigo e avisa.","title":"Limite","type":"integer"},"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).","title":"Campos","type":"string"},"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":"Chave Api","type":"string"}},"required":["ticker"],"title":"precosArguments"},"annotations":{"title":"Histórico de preços","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"a784489fd7f09de870b7451a50106128a75dd15d78ddcef645f7c23ba5f55ebd","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"},{"serverName":"io.github.Val7h/dados-b3","endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","name":"producao_petroleo_gas","title":"Produção de petróleo e gás por operador e campo (ANP)","description":"Quanto petróleo e gás cada operadora e cada campo produzem por dia, mês a mês (Petrobras, PRIO, Brava).\nUse quando: \"quanto a Petrobras produziu de petróleo em junho de 2025?\"; \"maiores campos do pré-sal\".\nNÃO use para: balanço ou dividendos da PETR4 ou PRIO3 → `fatos_contabeis`; preço da ação → `precos`.\nFonte e fórmula: dados abertos da ANP (CC BY-ND 3.0 declarada, uso acertado com a ANP); média diária do mês: petróleo em bbl/dia, gás em mil m³/dia; participação e variação em 12 meses são contas nossas.\nRetorna: `producao` por operador ou campo {petroleo_bbl_dia, gas_mm3_dia, participacao_petroleo_pct}; com `cnpj`/`operador`/`campo`, série mensal; cada linha traz `fonte` e `escopo`.\nVazio ou erro: de 2024 em diante a cobertura por campo é PARCIAL (`cobertura_manual` lista os meses que faltam). Nome não achado: tente `cnpj` ou o nome como está na ANP.\nAcesso: Gratuita, sem chave.","inputSchema":{"type":"object","properties":{"nivel":{"default":"operador","description":"Nível: \"operador\" (padrão) ou \"campo\".","enum":["operador","campo"],"title":"Nivel","type":"string"},"periodo":{"default":"","description":"Mês a devolver, AAAA-MM (ex.: 2025-06). Vazio = o último mês da base.","title":"Periodo","type":"string"},"cnpj":{"default":"","description":"CNPJ do operador com 14 dígitos; devolve a série mensal dele.","title":"Cnpj","type":"string"},"operador":{"default":"","description":"Nome do operador como consta na ANP; devolve a série mensal dele.","title":"Operador","type":"string"},"campo":{"default":"","description":"Nome do campo de petróleo ou gás na ANP; devolve a série mensal dele.","title":"Campo","type":"string"},"de":{"default":"","description":"Primeiro mês da série, AAAA-MM (ex.: 2024-01).","title":"De","type":"string"},"ate":{"default":"","description":"Último mês da série, AAAA-MM (ex.: 2025-06).","title":"Ate","type":"string"}},"title":"producao_petroleo_gasArguments"},"annotations":{"title":"Produção de petróleo e gás por operador e campo (ANP)","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"c8362de0d8dc60046b169853a220e52dd94532351e66cd0bdb083fa332041605","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T02:46:32.542Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"9473988dc116ba09280c67530e677fdd8cd64d9b3ac1c6b70b749f7d0ba3b23d","protocol":"streamable-http","status":"indexed","toolCount":36,"observedAt":"2026-11-20T02:46:32.542Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.Val7h/dados-b3":{"url":"https://dadosb3.com/mcp/"}}},"Cursor":{"mcpServers":{"io.github.Val7h/dados-b3":{"url":"https://dadosb3.com/mcp/"}}},"VS Code":{"servers":{"io.github.Val7h/dados-b3":{"type":"http","url":"https://dadosb3.com/mcp/"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://dadosb3.com/mcp/"},{"protocol":"mcp","package":"ghcr.io/val7h/dados-b3-mcp:1.9.0","registryType":"oci"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.Val7h%2Fdados-b3","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.Val7h%2Fdados-b3","name":"io.github.Val7h/dados-b3","description":"Brazilian stock (B3) fundamentals: ratios, dividends, scores, FIIs, ETFs, BDRs. Open methodology.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://dadosb3.com/mcp/"},{"protocol":"mcp","package":"ghcr.io/val7h/dados-b3-mcp:1.9.0","registryType":"oci"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":null,"repositoryUrl":"https://github.com/Val7h/dados-b3-mcp","version":"1.9.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.Val7h/dados-b3","status":"online","lastCheckedAt":"2026-11-20T05:15:44.150Z","lastSuccessfulCheck":"2026-11-20T05:15:44.150Z","latencyMs":124,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T05:15:44.150Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T05:15:44.150Z"},"security":null,"timestamps":{"createdAt":"2026-10-11T19:04:35.010Z","updatedAt":"2026-10-11T19:04:35.010Z","observedAt":"2026-11-20T05:15:44.150Z"},"compatibility":{"serverVersion":"1.9.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}