原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

Dados B3

作者:Val7h版本 1.9.2i★ –i电脑或云端
注册名称io.github.Val7h/dados-b3

安装

概览

作者提供的说明(英文原文)

Brazilian stocks (B3): 36 read-only tools for fundamentals, dividends, FIIs, ETFs, BDRs. Free.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

  • 连接方式: 电脑或云端
  • 传输方式: stdio, Streamable HTTP
  • 分类: 会计、财务与税务
  • 你需要填写:DADOS_B3_API_KEY

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。

你需要

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

适用于网页版、桌面版和手机版 Claude:

  1. 打开 Settings → Connectors
  2. 点击 Add custom connector
  3. 粘贴下面的地址,然后点击 Add
  4. 如果要求登录,请登录作者的服务
SettingsConnectors1+ Add2https://…3
https://dadosb3.com/mcp/

或者在你的电脑上运行

打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "dados-b3": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DADOS_B3_API_KEY",
        "ghcr.io/val7h/dados-b3-mcp:1.9.2"
      ],
      "env": {
        "DADOS_B3_API_KEY": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add --transport http dados-b3 https://dadosb3.com/mcp/

或者在你的电脑上运行

claude mcp add dados-b3 --env DADOS_B3_API_KEY=your-value -- docker run -i --rm -e DADOS_B3_API_KEY ghcr.io/val7h/dados-b3-mcp:1.9.2

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "dados-b3": {
      "url": "https://dadosb3.com/mcp/"
    }
  }
}

或者在你的电脑上运行

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "dados-b3": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DADOS_B3_API_KEY",
        "ghcr.io/val7h/dados-b3-mcp:1.9.2"
      ],
      "env": {
        "DADOS_B3_API_KEY": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "dados-b3": {
      "type": "http",
      "url": "https://dadosb3.com/mcp/"
    }
  }
}

或者在你的电脑上运行

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "dados-b3": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DADOS_B3_API_KEY",
        "ghcr.io/val7h/dados-b3-mcp:1.9.2"
      ],
      "env": {
        "DADOS_B3_API_KEY": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

ChatGPT 只能连接互联网上的服务器:

  1. 打开网页版 ChatGPT → Settings → Connectors (Apps)
  2. 点击 Create 或 Add(部分套餐需要先在 Advanced 中开启 Developer mode)
  3. 粘贴下面的地址,起个名字,然后保存
  4. 如果要求登录,请登录作者的服务
SettingsConnectors1+ Create2https://…3
https://dadosb3.com/mcp/

菜单名称可能因套餐和版本不同而略有差异。

你的选择通过 Cookie 保存在这台设备上,无需账户。

需要你填写的值

  • DADOS_B3_API_KEY 机密 env
    Dados B3 API key. Optional: WEGE3 and the whole methodology are free without one. Create a free key (200 queries/day, no card) or subscribe at https://dadosb3.com.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

工具名称和描述与服务器在 2026年11月6日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。

  • listar_empresas

    Lista as companhias abertas brasileiras (AÇÕES), com nome, CNPJ e ticker quando resolvido. A contagem vem na resposta — nunca escrita aqui, que é lida por clientes de IA e envelheceria sem ninguém ver. Só ações. Fundo imobiliário NÃO entra nesta lista: para FII use `fiis_ranking`

  • indicadores_anuais

    Série anual (2010–hoje) de ROIC, ROE, margens, crescimento e dívida líquida/EBITDA de uma AÇÃO da B3, com flags de qualidade. Só ações. Ticker de fundo imobiliário (terminado em 11, como MXRF11) NÃO se consulta aqui — FII não tem ROIC nem EBITDA, tem P/VP, DY e vacância: use `fii

  • multiplos

    Múltiplos ponto-no-tempo de uma AÇÃO (P/L, P/VP, EV/EBITDA anuais; P/L TTM trimestral) — preço do 1º pregão APÓS a publicação real do balanço, sem vazamento de informação futura. Só ações. Para o P/VP de um fundo imobiliário use `fii`, que o calcula sobre o informe mensal da CVM,

  • dividendos

    Histórico de proventos em dinheiro (dividendos e JCP) de uma empresa da B3: valor por ação, data de aprovação, data-com, preço na data-com, parcela e data de pagamento, mais resumo anual e dividend yield 12 meses (com o total do ano corrente até hoje e do ano anterior fechado). A

  • precos

    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

  • desempenho

    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

  • indice

    Í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

  • acessos_telecom

    Acessos de telefonia móvel e de banda larga fixa por operadora, mês a mês (Anatel, dados abertos; licença CC BY-ND 3.0 declarada pela Anatel, uso acertado com o órgão e informado pelo dono em 01/11/2026). ABERTO, sem chave. Sem argumentos: o ranking de cada serviço no mês consoli

  • tesouro_direto

    Taxas e preços diários dos títulos do Tesouro Direto (Tesouro Nacional, Tesouro Transparente, ODbL 1.0), desde 31/12/2004: a curva de juros pública por vencimento. ABERTO, sem chave. Sem argumentos: todos os títulos no dia-base mais recente. `titulo` (selic, prefixado, prefixado-

  • producao_petroleo_gas

    Produção de petróleo e gás natural por operador e por campo (ANP, dados abertos, licença declarada CC BY-ND 3.0, uso acertado com a ANP). ABERTO, sem chave. Taxa MÉDIA DIÁRIA do mês: petróleo em bbl/dia, gás em Mm³/dia (mil m³). Sem argumentos: os operadores do último mês da base

  • tarifas_energia

    Tarifa residencial de energia elétrica por distribuidora (ANEEL, dados abertos, ODbL 1.0), desde 2010: TUSD e TE em R$/MWh, SEM tributos (ICMS, PIS e COFINS ficam de fora), subgrupo B1 convencional. ABERTO, sem chave. Sem argumentos: a tarifa mais recente de cada distribuidora, c

  • fundos_investimento

    Fundos de investimento registrados na CVM (renda fixa, multimercado, ações, cambial; ~25 mil), do Informe Diário da CVM (dados abertos, ODbL 1.0): cota, patrimônio líquido (PL), cotistas e captação e resgate do mês. ABERTO, sem chave. Sem argumentos: no mês de referência (o mais

  • quanto_rendeu

    Quanto viraram R$ 1.000 numa AÇÃO, FII ou ETF há 1, 3, 5 e 10 anos: só com o preço e com os proventos reinvestidos, contra o Ibovespa (IFIX no FII) e a meta Selic, até o último fechamento. São EXATAMENTE os números da página https://dadosb3.com/quanto-rendeu/{ticker} (cada janela

  • fundos_da_acao

    Quais FUNDOS DE INVESTIMENTO têm uma AÇÃO na carteira e quanto (valor e quantidade), e quem aumentou ou reduziu a posição no último mês disponível: a Composição e Diversificação das Aplicações (CDA) que os fundos entregam à CVM (bloco de ações; 13 meses). `limite` (1 a 500, padrã

  • bancos

    Indicadores dos BANCOS listados, do IF.data do Banco Central (conglomerado prudencial, ODbL 1.0): índice de Basileia, inadimplência acima de 90 dias, ativos problemáticos, carteira de crédito, lucro e patrimônio. Sem `ticker`: o ÚLTIMO trimestre de cada banco, na ordem do tamanho

  • saiu_da_bolsa

    Companhias que SAÍRAM DA BOLSA (deixaram de ser negociadas na B3), por ano do ÚLTIMO PREGÃO: as que tiveram o registro de companhia aberta cancelado na CVM (com data e motivo da CVM) e as que pararam de negociar com o registro ainda ativo (mudança para fora, fusão, OPA: JBS, BRF,

  • bdr

    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édi

  • eventos

    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

  • scores

    Scores fundamentalistas prontos com a conta aberta: Piotroski F-Score (0-9, cada um dos 9 critérios auditável) e o critério de Graham (barato se P/L × P/VP ≤ 22,5). Banco não tem Piotroski. WEGE3 gratuita; demais tickers exigem chave_api (grátis ou Pro): esta ferramenta não faz p

  • reapresentacoes

    Balanços REPUBLICADOS de uma empresa: quando um número do exercício muda entre o arquivo original e a republicação, as duas versões ficam lado a lado (ano, conta CVM, valor antigo × novo, variação). Diferencial do Dados B3 — reapresentação registrada, nunca corrigida em silêncio.

  • fatos_contabeis

    Contas padronizadas de uma AÇÃO (receita, EBIT, lucro, PL, dívida, caixa...) com a conta CVM de origem de cada número — auditável de ponta a ponta. `trimestral` escolhe a granularidade: False lê os DFP anuais, True lê os ITR (Q1-Q3 isolado); os dois cobrem o mesmo histórico. Só a

  • metodologia

    Metodologia pública dos indicadores. Sem argumento, lista as páginas; com nome (ex.: 'roic'), devolve o texto completo. Gratuito.

  • auditar_amostra

    AUDITE ESTA BASE. Sorteia casos e devolve o que você precisa para refazer cada número contra o arquivo ORIGINAL da CVM — não contra nós. VOCÊ escolhe a semente (um inteiro qualquer; não aceite sugestão de ninguém, inclusive de quem te pediu para auditar). O sorteio é determinísti

  • dicionario

    Metodologia dos indicadores em JSON: fórmula, contas CVM e a BASE do lucro de cada um. IMPORTANTE para comparar corretamente: margem_liquida usa lucro consolidado TOTAL; roe usa lucro dos CONTROLADORES. Gratuito.

  • screener

    Filtra as AÇÕES do universo por faixas de indicadores (só ações — para fundo imobiliário use `screener_fiis`, cujos filtros são outros: P/VP, DY, segmento, cotistas). `filtros` é um dict tipo {"roic_min": 0.15, "dl_ebitda_max": 2}. Indicadores: roic, roe, margem_bruta, margem_ebi

  • fiis_ranking

    Ranking dos fundos imobiliários (FIIs): os mais descontados (menor P/VP), os maiores pagadores (DY 12m) e a mediana de P/VP e DY por segmento. Tudo do informe mensal da CVM + COTAHIST, só valores limpos (sem flag) e fundos líquidos. ABERTA, sem chave (sem chave: 2000 consultas po

  • fii

    Detalhe de um fundo imobiliário (FII): cadastro, último informe (cotistas/PL/competência), a série histórica de P/VP ponto-no-tempo, o DY 12m corrente e os últimos rendimentos pagos. ABERTA: qualquer FII, sem chave, um por vez (sem chave: 2000 consultas por hora e 20000 por dia,

  • veredito

    Resumo DESCRITIVO de uma AÇÃO da B3 em seis números e três perguntas — ganha dinheiro? (margem líquida, ROIC), está endividada? (dívida líquida/EBITDA), está cara em relação ao setor e à própria história? (P/L, P/VP) — cada um com faixa numérica e comparação com a mediana do seto

  • screener_fiis

    Filtra os FIIs por faixas. `filtros` é um dict tipo {"pvp_max": 0.9, "dy_min": 0.10, "segmento": "Logística", "cotistas_min": 5000}. Válidos: pvp_min, pvp_max, dy_min, dy_max (limites inclusivos), segmento (match exato, sem caixa) e cotistas_min (piso de liquidez). Só entram valo

  • trimestres

    Série TRIMESTRAL de uma AÇÃO: contas da ITR, preço do trimestre e indicadores (margem bruta, margem EBIT, margem líquida e ROE TTM). Use quando a pergunta for sobre o ANO CORRENTE ou o trimestre mais recente ("como foi o 2T", "a margem melhorou este ano?"): a série anual só respo

  • hoje

    O que mudou no mercado brasileiro nos últimos 30 dias. Responde "o que aconteceu com a empresa X esta semana" — a pergunta que nenhuma série anual responde. Traz, na janela: os balanços que ficaram públicos (com a data de entrega à CVM), os documentos REENVIADOS (a companhia repu

  • fatos_relevantes

    Os últimos Fatos Relevantes (ou Comunicados ao Mercado) que as companhias entregaram à CVM, do mais recente para o mais antigo, cada um com a companhia, o assunto (texto livre da companhia), a data de entrega, o protocolo e o LINK DO DOCUMENTO ORIGINAL na CVM. `ticker` filtra por

  • saude

    Cobertura atual do banco (contagens e última ingestão). Gratuito.

  • etfs_ranking

    ETFs listados na B3: mais negociados, maior patrimônio, maior deságio e maior ágio sobre a cota (preço ÷ cota do MESMO dia), retorno de 12 meses pela cota (retorno total por construção) e menor taxa EFETIVA (despesa do balancete ÷ PL médio, anualizada — a nominal não existe em fo

  • etf

    Detalhe de um ETF: cadastro (CVM + B3), último informe diário (cota, patrimônio, cotistas), ágio/deságio dos últimos 30 pregões, taxa efetiva mês a mês, carteira mais recente (10 maiores) e sobreposição com ETFs do mesmo índice, retornos pela cota e pelo preço. BOVA11 é o ETF abe

  • listas

    A LISTA COM DATA PRONTA, sem montar nada: devolve o ranking já calculado, com o nome, a DATA-BASE, o critério (liquidez de R$ 5 milhões por dia em 63 pregões, teto de 30% de DY, 5.000 cotistas...), as linhas (ticker, valores), a fonte e a `source_url` da página canônica para cita

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 Val7h 验证,该账户拥有此仓库

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • ✓ 通过

    端点有响应

    在 191 毫秒内响应(HTTP 200)

  • – 不适用

    使用 OAuth 登录

    无需登录

  • ✓ 通过

    工具描述中没有隐藏指令

    已读取 36 个工具描述,未发现针对 AI 的隐藏指令

与“会计、财务与税务”中的其他服务器比较i

  • 星标数多于此分类中其他 2898 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 2898 个服务器的 90% 更新
  • 基础检查结果等于或优于此分类中其他 2898 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

Dados B3 安全吗?

它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:DADOS_B3_API_KEY

它在我的电脑上运行还是在云端?

两种方式都可以:安装在你的电脑上,或者连接云端版本。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(1.9.2)于3天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。

有什么可以替代它?

同一分类中有:Finance Toolkit, SolidInvoice, Korea Tax Calculator

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Finance Toolkit

作者:JerBouma

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

电脑或云端★ 5,496MIT昨天更新
安装

SolidInvoice

作者:SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

在云端运行★ 981MIT8天前更新
安装

Korea Tax Calculator

作者:UpstageAI

Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.

在你的电脑上运行★ 97MIT昨天更新
安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Dados B3 — MCP server for the Brazilian stock market (B3)

Official site: https://dadosb3.com/?de=github · Remote MCP endpoint: `https://dadosb3.com/mcp/` · Methodology · Connection guide · llms.txt

*Português abaixo*

dadosb3.com is the only official address of the project. The old address on onrender.com is

retired; anything that still points there is out of date.

Keywords: B3, Bovespa, Brazilian stock market, Brazilian stocks (ações brasileiras), dividends (dividendos, proventos), FII (Brazilian REITs, fundos imobiliários), ETFs, BDRs, CVM filings, delisted companies (deslistagem), fundamentals, point-in-time multiples, MCP, Model Context Protocol.

At a glance (checked against the live server on 2026-11-06)

Remote serverhttps://dadosb3.com/mcp/ (Streamable HTTP), 36 read-only tools
Coverageevery company with CVM filings (DFP/ITR), 2010 to today, banks and insurers included; FIIs, ETFs, BDRs, B3 indices, Tesouro Direto, macro series; companies that left the exchange, with their last trading day, CVM status and dividends paid before leaving (list)
Updatesend-of-day prices (B3 COTAHIST) and dividends every trading night; CVM filings as the CVM publishes them. Live proof: saude / dadosb3.com/saude
Without a keyany ticker, one at a time: annual indicators, multiples, CVM accounts, dividends, FIIs, FII ranking, total return (desempenho), veredito, ETF ranking, methodology. Limit: 60 queries/hour and 150/day per IP; AI assistants (ChatGPT, Claude, Perplexity, this MCP connector) get their own allowance of 2,000/hour and 20,000/day
With a free key200 queries/day, no card: adds scores, restatements, quarterly series, full daily prices, corporate events, ETF detail and the screeners (get a key)
ProR$ 49.90/month, 10,000 queries/day and the whole base as CSV (plans)
Not coveredintraday or real-time quotes, prices before 2010, investment advice

Methodology and lineage

Every number carries the CVM account it came from. Each indicator page links down to the line of the CVM file, e.g. ITUB4 ROE 2025. Formulas: methodology and the JSON dictionary. Audit it yourself with your own seed: dadosb3.com/auditoria (or the auditar_amostra tool). Invariant tests run before every release: transparency page.

Example questions

  • "How much did PETR4 pay in dividends over the last 12 months, with ex-dates?" → dividendos
  • "Which companies left B3 in 2026, and what did they pay before leaving?" → saiu_da_bolsa, dividendos
  • "Itaú's 2025 ROE, with the CVM accounts behind it" → indicadores_anuais
  • "FIIs with the highest 12-month yield and P/B below 1" → fiis_ranking, fii
  • "Was WEGE3 worth it over 5 years, against the Ibovespa and Selic?" → desempenho
  • "What did R$ 1,000 in ITUB4 return?" → quanto_rendeu

What it is

An MCP connector that gives your AI agent (Claude, ChatGPT, Cursor and others) access to fundamentals for Brazilian listed companies (B3) — banks and insurers included — from 2010 to today, with a fully published methodology: ROE, ROIC, margins, growth, net debt/EBITDA, point-in-time multiples (P/E, P/B, EV/EBITDA priced at the first trading session *on or after* the day the filing actually became public — no look-ahead, usable for backtests), dividends and dividend yield, ready-made scores (Piotroski F-Score and Graham) and a record of restated filings.

Sources: CVM open data (ODbL) and B3 (COTAHIST). Every figure carries the CVM account it came from, and nothing is published unless a suite of invariant tests passes — the balance sheet balances, the income statement reconciles, and a price never precedes the filing that justifies it.

Product and plans: https://dadosb3.com/?de=github

Use 1 — remote (nothing to install, recommended)

Add this remote connector to your AI client:

https://dadosb3.com/mcp/

In Claude: Settings → Connectors → add custom connector → paste the URL.

The remote server exposes 36 read-only tools (most of them work without a key). Beyond the table below it also serves bancos, fatos_relevantes, fundos_da_acao, fundos_investimento, listas, producao_petroleo_gas, quanto_rendeu, saiu_da_bolsa, screener_fiis, tarifas_energia, acessos_telecom and tesouro_direto. The local builds in Use 2 and Use 3 run the subset in the table. Open pages without a key: https://dadosb3.com/claude-code?de=github (Claude Code guide) and the list under "Open pages, no key".

Use in Claude Code (plugin)

This repository is a Claude Code plugin marketplace with one plugin, dados-b3. The plugin registers the remote server https://dadosb3.com/mcp and adds a skill that tells Claude when to use it and to cite the dadosb3.com page each answer comes from.

In a Claude Code session (v2.1.275 or later), one command:

/plugin install dados-b3 --marketplace Val7h/dados-b3-mcp

Or in two steps:

/plugin marketplace add Val7h/dados-b3-mcp

/plugin install dados-b3@dados-b3

From your shell, without a session:

claude plugin marketplace add Val7h/dados-b3-mcp

claude plugin install dados-b3@dados-b3

Without the plugin (only the MCP server, no skill):

claude mcp add --transport http dados-b3 https://dadosb3.com/mcp

The free tools need no key. Prices are end-of-day, not real-time quotes, and the answers are past data, not investment advice. Guide: https://dadosb3.com/claude-code?de=github

Use 2 — local (stdio)

pip install -r requirements.txt

python server.py

{

"mcpServers": { "dados-b3": { "command": "python", "args": ["server.py"], "env": { "DADOS_B3_API_KEY": "your_optional_key" } } } }

Use 3 — Docker image (one command, no local Python)

docker run -i --rm -e DADOS_B3_API_KEY=your_optional_key ghcr.io/val7h/dados-b3-mcp:latest
{

"mcpServers": { "dados-b3": { "command": "docker", "args": ["run", "-i", "--rm", "ghcr.io/val7h/dados-b3-mcp:latest"] } } }

The image is published on every push to main (.github/workflows/publicar-imagem.yml). It exists for two reasons: a one-command install path, and letting MCP directories actually run the server in order to evaluate it.

Tools

ToolWhat it doesFree?
listar_empresasEvery covered company (name, tax ID, ticker), banks and insurers includedyes
indicadores_anuaisROE, ROIC, margins, growth, net debt/EBITDA — annual series from 2010yes, any ticker (no-key limit above)
multiplosP/E, P/B, EV/EBITDA point-in-time; trailing P/Eyes, any ticker (no-key limit above)
fatos_contabeisStandardised accounts carrying the CVM code each figure came fromyes, any ticker (no-key limit above)
dividendosCash distributions, annual summary and 12-month dividend yieldyes, any ticker (no-key limit above)
scoresPiotroski F-Score with all nine criteria shown, plus the Graham testWEGE3 yes; others need a key
reapresentacoesRestated filings — the original and the revised figure side by sideWEGE3 yes; others need a key
trimestresQuarterly series: Q1/Q2/Q3 accounts as filed, the quarter's price, margins and trailing ROEWEGE3 yes; others need a key
etfs_rankingB3 ETFs: most traded, largest net assets, largest premium/discount to same-day NAV, 12m NAV return, lowest EFFECTIVE feeyes
etfOne ETF: daily NAV (FNET filing), premium/discount, monthly effective fee, portfolio (CDA) and overlap with peersBOVA11 yes; others need a key
auditar_amostraDraws cases with YOUR seed so you can recompute each figure against the CVM file (formula, account, where to look)yes
fiis_rankingMost discounted FIIs (point-in-time P/B), highest 12m yield and medians by segmentyes
hojeWhat changed in the last 30 days: filings published, filings re-sent, dividends, fund distributions, corporate actions, ticker changesyes
fiiOne real-estate fund: point-in-time P/B, 12-month yield, vacancy, recent distributionsyes, any fund
fiisFilters funds by P/B and dividend-yield rangeskey required
screenerFilters the whole market by indicator ranges; as_of answers what was PUBLIC on a date (no look-ahead); recibo=True freezes the answer at a permanent, citable addresskey required
reciboReads a frozen screener query: question, cut-off date, data version, result and its sha256yes
vereditoDescriptive summary of one stock: six numbers in three questions, each with its numeric band and comparison (sector median, the company's own history, the whole market), plus the data confidence flag — facts, never adviceyes, any stock
desempenho"Was it worth it?" in a few numbers, computed server-side: return, max drawdown, volatility and a 21 x 100 moving-average crossover vs buy-and-hold, on the split-adjusted price and, when dividends are recorded, the TOTAL return (dividends and JCP reinvested on the ex-date). Open for every tickeryes
desempenho_fiiThe same for a real-estate fund (price only; distributions only in the total return; a daily jump above 35% is flagged confiavel: false)yes
desempenho_etfThe same for an ETF (price only; a daily jump above 35% is flagged)yes
indiceThe benchmark: performance of a B3 index (IBOV, IFIX, SMLL...); empty code lists themyes
indice_precosDaily close of an index in points (30-session sample without a key)sample
bdrBDRs on B3: the list (open) or one BDR with returns, distributions in reais and splitslist yes; AAPL34
bdr_precosDaily prices of a BDR (30-session sample without a key)sample
precosThe DAILY price series of one stock (open, high, low, close, volume), oldest first, plus the corporate events of the period; not adjusted. Without a key, a 30-session SAMPLE with a notice of how to get it allWEGE3 yes; others sample, full needs a key
eventosSplits, reverse splits, bonus issues and spin-offs with the source of each (B3-declared or found by us) and the net effect of the dayWEGE3 yes; others need a key
dicionarioFormula, CVM accounts and earnings base of each indicator, as JSONyes
metodologiaThe published methodology pages, as textyes
saudeCurrent coverage and last ingestionyes

trimestres stops at Q3 on purpose. The interim filing (ITR) never carries a standalone fourth quarter — it can be derived as full year − nine months, and some do derive it. We do not: a figure we computed would sit in the same list as the figures the company reported, carrying the error of two filings and erasing the line between what was filed and what we calculated. For the closed year, ask for the annual series.

No key needed for the tools marked "yes": any ticker, one at a time, up to 60 queries/hour and 150/day per IP (AI assistants and this connector: 2,000/hour and 20,000/day). WEGE3 is open in every tool. For the tools that need a key, create a free key at https://dadosb3.com/chave-gratis?de=github (200 queries/day, no card) or subscribe to Pro at https://dadosb3.com/assinar?de=github (10,000/day), and pass it in the chave_api argume

只显示了开头部分;其余内容请在仓库中阅读

问 PopNx