accueil / serveurs / Dev & Code / io.github.Val7h/dados-b3
io.github.Val7h/dados-b3
serveur MCP (Model Context Protocol) · dados-b3 1.30.0
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que io.github.Val7h/dados-b3 est sûr ?
Au dernier audit MCP Hub, le serveur MCP « io.github.Val7h/dados-b3 » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 25 outils
- auditar_amostra≈ 371 tokens
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.
Paramètres, retour & exemple (2)
Paramètresn· integer · optionnelsemente· integer · requis
Exemple d'appel{"name": "auditar_amostra", "arguments": {"semente": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - bdr≈ 341 tokens
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.
Paramètres, retour & exemple (6)
Paramètresde· string · optionnelate· string · optionneltipo· string · optionnelserie· boolean · optionnelticker· string · optionnelchave_api· string · optionnel
Exemple d'appel{"name": "bdr", "arguments": {"de": "texte", "ate": "texte", "tipo": "texte", "serie": true, "ticker": "texte", "chave_api": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - desempenho≈ 354 tokens
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.
Paramètres, retour & exemple (6)
Paramètresde· string · optionnelate· string · optionnelticker· string · requischave_api· string · optionnelmedia_curta· integer · optionnelmedia_longa· integer · optionnel
Exemple d'appel{"name": "desempenho", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - dicionario≈ 132 tokens
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.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "dicionario", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - dividendos≈ 205 tokens
Histórico de proventos em dinheiro (dividendos e JCP) de uma empresa da B3: valor por ação, data de aprovação, data-com e preço na data-com, mais resumo anual e dividend yield 12 meses. ABERTA para todos os tickers, sem chave (o mesmo dado é público em dadosb3.com/acoes/TICKER/dividendos); chave_api é aceita mas desnecessária. Cite a página ao usar o número.
Paramètres, retour & exemple (2)
Paramètresticker· string · requischave_api· string · optionnel
Exemple d'appel{"name": "dividendos", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - etf≈ 192 tokens
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).
Paramètres, retour & exemple (2)
Paramètresticker· string · requischave_api· string · optionnel
Exemple d'appel{"name": "etf", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - etfs_ranking≈ 167 tokens
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.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "etfs_ranking", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - eventos≈ 205 tokens
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.
Paramètres, retour & exemple (2)
Paramètresticker· string · requischave_api· string · optionnel
Exemple d'appel{"name": "eventos", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - fatos_contabeis≈ 245 tokens
Contas padronizadas de uma AÇÃO (receita, EBIT, lucro, PL, dívida, caixa...) com a conta CVM de origem de cada número — auditável de ponta a ponta. `trimestral` escolhe a granularidade: False lê os DFP anuais, True lê os ITR (Q1-Q3 isolado); os dois cobrem o mesmo histórico. Só ações. FII não publica DFP/ITR nesse formato — o que existe é o informe mensal, exposto por `fii`. WEGE3 gratuita; demais exigem chave_api.
Paramètres, retour & exemple (3)
Paramètresticker· string · requischave_api· string · optionneltrimestral· boolean · optionnel
Exemple d'appel{"name": "fatos_contabeis", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - fii≈ 174 tokens
Detalhe de um fundo imobiliário (FII): cadastro, último informe (cotistas/PL/competência), a série histórica de P/VP ponto-no-tempo, o DY 12m corrente e os últimos rendimentos pagos. MXRF11 é o FII aberto para degustação; demais fundos exigem chave_api (grátis ou Pro).
Paramètres, retour & exemple (2)
Paramètresticker· string · requischave_api· string · optionnel
Exemple d'appel{"name": "fii", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - fiis_ranking≈ 176 tokens
Ranking dos fundos imobiliários (FIIs): os mais descontados (menor P/VP), os maiores pagadores (DY 12m) e a mediana de P/VP e DY por segmento. Tudo do informe mensal da CVM + COTAHIST, só valores limpos (sem flag) e fundos líquidos. Requer chave_api (grátis ou Pro); o FII MXRF11 é aberto para degustação nas ferramentas por ticker.
Paramètres, retour & exemple (1)
Paramètreschave_api· string · optionnel
Exemple d'appel{"name": "fiis_ranking", "arguments": {"chave_api": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - hoje≈ 244 tokens
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.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "hoje", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - indicadores_anuais≈ 235 tokens
Série anual (2010–hoje) de ROIC, ROE, margens, crescimento e dívida líquida/EBITDA de uma AÇÃO da B3, com flags de qualidade. Só ações. Ticker de fundo imobiliário (terminado em 11, como MXRF11) NÃO se consulta aqui — FII não tem ROIC nem EBITDA, tem P/VP, DY e vacância: use `fii`. Banco e seguradora entram, mas sem ROIC/EBITDA, que não se aplicam ao plano de contas deles. WEGE3 é gratuita; demais tickers exigem chave_api (grátis ou Pro).
Paramètres, retour & exemple (2)
Paramètresticker· string · requischave_api· string · optionnel
Exemple d'appel{"name": "indicadores_anuais", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - indice≈ 343 tokens
Í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.
Paramètres, retour & exemple (7)
Paramètresde· string · optionnelate· string · optionnelserie· boolean · optionnelcodigo· string · optionnelchave_api· string · optionnelmedia_curta· integer · optionnelmedia_longa· integer · optionnel
Exemple d'appel{"name": "indice", "arguments": {"de": "texte", "ate": "texte", "serie": true, "codigo": "texte", "chave_api": "texte", "media_curta": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - listar_empresas≈ 166 tokens
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.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "listar_empresas", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - metodologia≈ 127 tokens
Metodologia pública dos indicadores. Sem argumento, lista as páginas; com nome (ex.: 'roic'), devolve o texto completo. Gratuito.
Paramètres, retour & exemple (1)
Paramètresnome· string · optionnel
Exemple d'appel{"name": "metodologia", "arguments": {"nome": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - multiplos≈ 203 tokens
Múltiplos ponto-no-tempo de uma AÇÃO (P/L, P/VP, EV/EBITDA anuais; P/L TTM trimestral) — preço do 1º pregão APÓS a publicação real do balanço, sem vazamento de informação futura. Só ações. Para o P/VP de um fundo imobiliário use `fii`, que o calcula sobre o informe mensal da CVM, não sobre balanço trimestral. WEGE3 gratuita; demais exigem chave_api.
Paramètres, retour & exemple (2)
Paramètresticker· string · requischave_api· string · optionnel
Exemple d'appel{"name": "multiplos", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - precos≈ 463 tokens
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`.
Paramètres, retour & exemple (6)
Paramètresde· string · optionnelate· string · optionnelcampos· string · optionnellimite· integer · optionnelticker· string · requischave_api· string · optionnel
Exemple d'appel{"name": "precos", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - reapresentacoes≈ 192 tokens
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.
Paramètres, retour & exemple (2)
Paramètresticker· string · requischave_api· string · optionnel
Exemple d'appel{"name": "reapresentacoes", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - saude≈ 88 tokens
Cobertura atual do banco (contagens e última ingestão). Gratuito.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "saude", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - scores≈ 168 tokens
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.
Paramètres, retour & exemple (2)
Paramètresticker· string · requischave_api· string · optionnel
Exemple d'appel{"name": "scores", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - screener≈ 540 tokens
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).
Paramètres, retour & exemple (6)
Paramètresano· ? · optionnelas_of· ? · optionnelrigor· string · optionnelrecibo· boolean · optionnelfiltros· object · requischave_api· string · optionnel
Exemple d'appel{"name": "screener", "arguments": {"filtros": {}}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - screener_fiis≈ 220 tokens
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).
Paramètres, retour & exemple (2)
Paramètresfiltros· object · requischave_api· string · optionnel
Exemple d'appel{"name": "screener_fiis", "arguments": {"filtros": {}}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - trimestres≈ 316 tokens
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.
Paramètres, retour & exemple (2)
Paramètresticker· string · requischave_api· string · optionnel
Exemple d'appel{"name": "trimestres", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - veredito≈ 256 tokens
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.
Paramètres, retour & exemple (1)
Paramètresticker· string · requis
Exemple d'appel{"name": "veredito", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».