{"id":"io.github.Val7h/dados-b3","slug":"io-github-val7h-dados-b3","title":"Dados B3","description":"Brazilian stocks (B3): 36 read-only tools. Fundamentals, dividends, FIIs, ETFs. Most need no key.","version":"1.9.3","publisher":{"kind":"github","id":"Val7h","label":"@Val7h on GitHub","url":"https://github.com/Val7h"},"website":"https://dadosb3.com/conector","repository":"https://github.com/Val7h/dados-b3-mcp","remotes":[{"type":"streamable-http","url":"https://dadosb3.com/mcp/"}],"packages":[{"registryType":"oci","identifier":"ghcr.io/val7h/dados-b3-mcp:1.9.3","transport":{"type":"stdio"},"environmentVariables":[{"description":"Dados B3 API key. Optional: without one, any ticker answers in annual indicators, multiples, CVM accounts, dividends and FIIs (60/hour, 150/day per IP; AI assistants 2,000/hour). A free key (200 queries/day, no card) or Pro unlocks scores, restatements, quarterly data, full prices and screeners: https://dadosb3.com","isSecret":true,"name":"DADOS_B3_API_KEY"}]}],"published":"2026-11-07","updated":"2026-11-07","status":"online","auth":"","latency_ms":1159,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"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.\nReto","read_only":true},{"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`","read_only":true},{"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 ","read_only":true},{"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 d","read_only":true},{"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 → `indic","read_only":true},{"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`","read_only":true},{"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 (","read_only":true},{"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), s","read_only":true},{"name":"tesouro_direto","title":"Taxas do Tesouro Direto","description":"Taxa e preço dos títulos do Tesouro Direto (Selic, Prefixado, IPCA+, Renda+, Educa+) por dia, desde 2004.\nUse quando: \"quanto paga o Tesouro IPCA+ 2035 hoje?\"; \"taxa do Tesouro Prefixado em janeiro de 2024\".\nNÃO use para: fundo de renda fixa → `fundos_investimento`; dividendos de ação → `dividendos`.\nFonte e fórmula: Tesouro Transparente (ODbL), taxas indicativas da manhã, sem recálculo. Prefixado","read_only":true},{"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","read_only":true},{"name":"tarifas_energia","title":"Tarifa de energia por distribuidora (ANEEL)","description":"Tarifa residencial de energia de cada distribuidora (TUSD + TE em R$/MWh) e o último reajuste.\nUse quando: \"qual a distribuidora com a energia mais cara?\"; \"quanto subiu a tarifa da Cemig no último reajuste?\".\nNÃO use para: balanço da CMIG4 ou CPFE3 → `fatos_contabeis`; dividendos da elétrica → `dividendos`.\nFonte e fórmula: dados abertos da ANEEL (ODbL), subgrupo B1 convencional, SEM tributos; va","read_only":true},{"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íqu","read_only":true},{"name":"quanto_rendeu","title":"Quanto rendeu R$ 1.000 em 1, 3, 5 e 10 anos","description":"Quanto viraram R$ 1.000 numa ação, FII ou ETF em 1, 3, 5 e 10 anos, com e sem dividendos reinvestidos.\nUse quando: \"quanto rendeu R$ 1.000 em ITUB4 nos últimos 5 anos?\"; \"o HGLG11 rendeu mais que o IFIX?\"; \"BOVA11 em 10 anos contra a Selic\".\nNÃO use para: período escolhido (de/até) de uma ação → `desempenho`; só os dividendos → `dividendos`.\nFonte e fórmula: COTAHIST da B3 e proventos registrados;","read_only":true},{"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 carte","read_only":true},{"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 p","read_only":true},{"name":"saiu_da_bolsa","title":"Companhias que saíram da bolsa, por ano (B3 e CVM)","description":"Quais empresas saíram da bolsa (deixaram de negociar na B3) em cada ano, com data e motivo.\nUse quando: \"quais empresas saíram da bolsa em 2026?\"; \"a Petz saiu da B3? quando foi o último pregão?\"; \"quantas companhias fecharam o capital em 2025?\".\nNÃO use para: dividendos que uma delistada pagou → `dividendos`; desdobramentos e cisões → `eventos`; fato relevante da saída → `fatos_relevantes`.\nFonte","read_only":true},{"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$.\nReto","read_only":true},{"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 (`efe","read_only":true},{"name":"scores","title":"Scores de qualidade de uma empresa","description":"Piotroski F-Score (0 a 9) e critério de Graham de uma ação, com cada critério auditável.\nUse quando: \"qual o Piotroski da Vale?\"; \"a ação passa no critério de Graham?\".\nNÃO use para: resumo descritivo da ação → `veredito`; os indicadores por ano → `indicadores_anuais`.\nFonte e fórmula: DFP da CVM; Graham: P/L × P/VP ≤ 22,5. Banco não tem Piotroski.\nRetorna: os 9 critérios com valor e resultado, o ","read_only":true},{"name":"reapresentacoes","title":"Reapresentações de balanço","description":"Balanços REPUBLICADOS: quando a empresa mudou um número já entregue, as duas versões lado a lado.\nUse quando: \"a Americanas reapresentou o balanço?\"; \"quais contas da empresa mudaram na republicação?\".\nNÃO use para: as contas vigentes → `fatos_contabeis`; bandeira de confiança do resumo → `veredito`.\nFonte e fórmula: DFP original × republicada na CVM, conta a conta; nunca corrigido em silêncio.\nRe","read_only":true},{"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`.\n","read_only":true},{"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, r","read_only":true},{"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, n","read_only":true},{"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 TOTA","read_only":true},{"name":"screener","title":"Screener de ações","description":"Filtra as AÇÕES da B3 por faixas de indicadores: ROIC, ROE, margens, dívida/EBITDA, crescimento e P/L.\nUse quando: \"ações com ROIC acima de 15% e dívida/EBITDA abaixo de 2\"; \"empresas com P/L abaixo de 8 e ROE acima de 20%\".\nNÃO use para: filtrar FIIs → `screener_fiis`; lista pronta de P/L < 10 ou maiores pagadoras → `listas`; uma empresa só → `indicadores_anuais`.\nFonte e fórmula: DFP/ITR da CVM ","read_only":true},{"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 mens","read_only":true},{"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_fii","read_only":true},{"name":"veredito","title":"Veredito de uma empresa","description":"Resumo de uma AÇÃO em seis números: ganha dinheiro? está endividada? está cara contra o setor e a própria história?\nUse quando: \"a Petrobras está cara?\"; \"resumo fundamentalista da WEGE3\"; \"a Vale está endividada?\".\nNÃO use para: quanto a ação subiu ou caiu → `desempenho`; série anual completa → `indicadores_anuais`; Piotroski e Graham → `scores`.\nFonte e fórmula: DFP da CVM e COTAHIST: margem líq","read_only":true},{"name":"screener_fiis","title":"Screener de FIIs","description":"Filtra os fundos imobiliários (FIIs) por faixas de P/VP, dividend yield, segmento e cotistas.\nUse quando: \"FIIs de logística com P/VP abaixo de 0,9\"; \"FIIs com DY acima de 10% e mais de 5.000 cotistas\".\nNÃO use para: os rankings prontos sem filtro → `fiis_ranking`; um FII só → `fii`; filtrar ações → `screener`; lista pronta para citar → `listas`.\nFonte e fórmula: informe mensal da CVM + COTAHIST; ","read_only":true},{"name":"trimestres","title":"Resultados trimestrais de uma empresa","description":"Resultado TRIMESTRAL de uma AÇÃO: contas da ITR, margens e ROE de 12 meses, para o ano corrente.\nUse quando: \"como foi o 2T da Petrobras?\"; \"a margem da WEG melhorou este ano?\".\nNÃO use para: ano fechado → `indicadores_anuais`; contas em R$ por trimestre, abertas → `fatos_contabeis`.\nFonte e fórmula: ITR da CVM (1T, 2T, 3T); o 4T não vem: o exercício fechado é da DFP e não derivamos 4T = anual − 9","read_only":true},{"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 reenvio","read_only":true},{"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 se","read_only":true},{"name":"saude","title":"Saúde dos dados","description":"Cobertura e frescor da base: contagens, último pregão e última coleta.\nUse quando: \"até que data vão os preços?\"; \"quantas empresas a base tem?\".\nNÃO use para: como um número é calculado → `metodologia`.\nFonte e fórmula: o próprio banco servido.\nRetorna: `data_version`, `contagens`, `cobertura_de_preco`, `ultima_ingestao` e o estado de cada fonte.\nVazio ou erro: `avisos` diz se a base servida está","read_only":true},{"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 = d","read_only":true},{"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),","read_only":true},{"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ç","read_only":true}],"server_info":{"icons":[{"mimeType":"image/png","sizes":["512x512"],"src":"https://dadosb3.com/icon-512.png"}],"name":"dados-b3","version":"2.3.0"},"category":"finance","tags":[],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-08-11","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-val7h-dados-b3/"}