プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。レビューとアカウント機能は今後のステップで始まります。
PopNx MCPAIを使う人のための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の3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: パソコンでもクラウドでも
  • トランスポート: 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

  • このカテゴリのほかの32700件のうち0%よりスターが多い
  • このカテゴリのほかの32700件のうち93%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの32700件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Dados B3は安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:DADOS_B3_API_KEY

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は–、最新バージョン(1.9.2)がレジストリに届いたのは一昨日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。

代わりに使えるものは?

同じカテゴリには:Spec Driven Development, Remote Desktop Commander, Agent Data Tools: Utilities

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Remote Desktop Commander

作者:desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

クラウドで動く★ 211一昨日更新
インストール

作者の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に聞く