Skip to content
plugmcp
DirectorySkillsCategoriesBlog
EN/中文
Sign inSign up
Home/Servers/Dados B3

Dados B3

by io.github.Val7h

Brazilian stock (B3) fundamentals: ratios, dividends, scores, FIIs, ETFs, BDRs. Open methodology.

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Server URL
https://dadosb3.com/mcp/
Credentials from the publisher
  • DADOS_B3_API_KEY — 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.
Provider
Add in Claude

Claude opens with the name and URL filled in. You still confirm it there.

Claude Code
claude mcp add --transport http io.github.val7h-dados-b3 https://dadosb3.com/mcp/

Run in a terminal.

Claude Desktop
{
  "mcpServers": {
    "io.github.val7h-dados-b3": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dadosb3.com/mcp/"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

View more
  • Firecrawl🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
  • N
    NotionToken-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.
  • Context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

Related skills

View all
  • reaReverse engineer anything with agents, from app behavior down to native binaries.
  • rea-changelog-updatePrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.
  • rea-tool-designDesign or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.

Questions

How do I install Dados B3?
Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Dados B3 need an API key?
The publisher lists these environment variables: DADOS_B3_API_KEY.
What transport does Dados B3 use?
Dados B3 is reached over HTTP.
When was Dados B3 last checked?
Last checked 2026-10-16. Brazilian stock (B3) fundamentals: ratios, dividends, scores, FIIs, ETFs, BDRs. Open methodology.

Brazilian stock (B3) fundamentals: ratios, dividends, scores, FIIs, ETFs, BDRs. Open methodology.

Dados B3 — MCP server (Brazilian stock market, auditable fundamentals)

Português abaixo

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.

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 2010WEGE3 yes; others need a key
multiplosP/E, P/B, EV/EBITDA point-in-time; trailing P/EWEGE3 yes; others need a key
fatos_contabeisStandardised accounts carrying the CVM code each figure came fromWEGE3 yes; others need a key
dividendosCash distributions, annual summary and 12-month dividend yieldWEGE3 yes; others need a key
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 segmentneeds a key
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 distributionsMXRF11 yes; others need a key
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.

WEGE3 and the whole methodology are open, no key needed. For other companies, 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, and pass it in the chave_api argument or the DADOS_B3_API_KEY environment variable.

The company count is deliberately not written here: the universe grows whenever the CVM publishes, and a number frozen in a README ages without anyone noticing. Call saude for today's figure.

Banks and insurers

Financial institutions file under a different chart of accounts — there is no EBIT and no sales revenue. The connector classifies them by their actual chart of accounts and returns the indicators that mean something for them — ROE, margin, growth, P/E, P/B, dividends — and deliberately does not publish ROIC, EBITDA or EV/EBITDA for them, because those do not apply. Examples: Itaú, Bradesco, Banco do Brasil, BB Seguridade, IRB.

Why this one

A methodology published rather than described, invariant tests gating every release, multiples with no future information leaking in, and restatements kept on the record — when a company republishes a filing, both versions stay side by side. An honest comparison, including where competitors are better: https://dadosb3.com/comparativo?de=github

Prefer plain Python?

pip install dadosb3 — the official client for the same API, with typed errors and one method per tool: https://pypi.org/project/dadosb3/

Licence

MIT (this connector). The underlying data is public (CVM/B3); the service adds standardisation, methodology and tests.


Dados B3 — servidor MCP (bolsa brasileira, fundamentos auditáveis)

Conector MCP que dá ao seu agente de IA (Claude, ChatGPT, Cursor e outros) acesso a dados fundamentalistas das companhias abertas brasileiras (B3) — inclusive bancos e seguradoras —, de 2010 até hoje, com metodologia 100% pública: ROE, ROIC, margens, crescimento, dívida líquida/EBITDA, múltiplos ponto-no-tempo (P/L, P/VP, EV/EBITDA com o preço do 1º pregão a partir da publicação real do balanço — sem look-ahead, próprio para backtest), dividendos e dividend yield, scores prontos (Piotroski F-Score e Graham) e histórico de reapresentações de balanço.

Fonte: CVM (dados abertos, ODbL) e B3 (COTAHIST). Cada número carrega a conta CVM de origem; nada é publicado sem uma bateria de testes de invariantes passando (o balanço fecha, a DRE fecha, o preço nunca antecede a publicação).

Produto e planos: https://dadosb3.com/?de=github

Uso 1 — remoto (nada para instalar, recomendado)

Adicione este conector remoto ao seu cliente de IA:

https://dadosb3.com/mcp/

No Claude: Configurações → Conectores → adicionar conector personalizado → cole a URL.

Uso 2 — local (stdio)

pip install -r requirements.txt
python server.py

Uso 3 — imagem Docker (um comando, sem Python local)

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

A imagem é publicada a cada push na main. Ela existe por dois motivos: dar um caminho de instalação de um comando só, e permitir que diretórios de MCP rodem o servidor para avaliá-lo.

Prefere Python puro?

pip install dadosb3 — o cliente oficial da mesma API, com erros tratados e um método por ferramenta: https://pypi.org/project/dadosb3/

Ferramentas

FerramentaO que fazGrátis?
listar_empresasTodas as companhias cobertas (nome, CNPJ, ticker), incl. bancos e seguradorassim
indicadores_anuaisROE, ROIC, margens, crescimento, DL/EBITDA — série anual desde 2010WEGE3 sim; demais com chave
multiplosP/L, P/VP, EV/EBITDA ponto-no-tempo; P/L TTMWEGE3 sim; demais com chave
fatos_contabeisContas padronizadas com a conta CVM de origem de cada númeroWEGE3 sim; demais com chave
dividendosProventos, resumo anual e dividend yield de 12 mesesWEGE3 sim; demais com chave
scoresPiotroski F-Score com os nove critérios abertos, e o critério de GrahamWEGE3 sim; demais com chave
reapresentacoesBalanços republicados — versão original e revisada lado a ladoWEGE3 sim; demais com chave
trimestresSérie trimestral: contas do 1T/2T/3T como publicadas, preço do trimestre, margens e ROE TTMWEGE3 sim; demais com chave
etfs_rankingETFs da B3: mais negociados, maior patrimônio, maior ágio/deságio sobre a cota do dia, retorno 12m pela cota, menor taxa EFETIVAsim
etfUm ETF: cota diária (FNET), ágio/deságio, taxa efetiva mês a mês, carteira (CDA) e sobreposição com paresBOVA11 sim; demais com chave
auditar_amostraSorteia casos com a SUA semente para refazer cada número contra o arquivo da CVM (fórmula, conta, onde procurar)sim
fiis_rankingFIIs mais descontados (P/VP ponto-no-tempo), maiores DY 12m e mediana por segmentoexige chave
hojeO que mudou nos últimos 30 dias: balanços publicados, balanços reenviados, proventos, rendimentos de FII, eventos societários, trocas de tickersim
fiiUm fundo imobiliário: P/VP ponto-no-tempo, DY de 12 meses, vacância, rendimentos recentesMXRF11 sim; demais com chave
fiisFiltra fundos por faixas de P/VP e dividend yieldexige chave
screenerFiltra o mercado inteiro por faixas de indicadores; as_of responde o que estava PÚBLICO numa data (sem olhar o futuro); recibo=True congela a resposta num endereço permanente, citávelexige chave
reciboLê uma consulta congelada do screener: pergunta, data de corte, versão do dado, resultado e o sha256 delesim
vereditoResumo descritivo de uma ação: seis números em três perguntas, cada um com faixa numérica e comparação (mediana do setor, história da própria empresa, mercado inteiro), mais a bandeira de confiança do dado — fato, nunca conselhosim, qualquer ação
desempenho"Valeu a pena?" em poucos números, calculado no servidor: retorno, queda máxima, volatilidade e cruzamento de médias 21 x 100 contra comprar e manter, no preço ajustado por eventos e, quando há proventos, o retorno TOTAL (dividendos e JCP reinvestidos no data-ex). Aberto para qualquer tickersim
desempenho_fiiO mesmo para um fundo imobiliário (só preço; rendimentos só no retorno total; salto diário acima de 35% vem marcado confiavel: false)sim
desempenho_etfO mesmo para um ETF (só preço; salto diário acima de 35% vem marcado)sim
indiceO benchmark: desempenho de um índice da B3 (IBOV, IFIX, SMLL...); código vazio listasim
indice_precosFechamento diário de um índice em pontos (amostra de 30 pregões sem chave)amostra
bdrBDRs da B3: a lista (aberta) ou um BDR com rentabilidade, proventos em reais e desdobramentoslista sim; AAPL34
bdr_precosPreços diários de um BDR (amostra de 30 pregões sem chave)amostra
precosA série DIÁRIA de preços de uma ação (abertura, máxima, mínima, fechamento, volume), do mais antigo ao mais recente, mais os eventos societários do período; não ajustada. Sem chave, uma AMOSTRA de 30 pregões com o aviso de como ter tudoWEGE3 sim; demais amostra, completa com chave
eventosDesdobramentos, grupamentos, bonificações e cisões com a fonte de cada um (declarado pela B3 ou achado por nós) e o efeito líquido do diaWEGE3 sim; demais com chave
dicionarioFórmula, contas CVM e base do lucro de cada indicador, em JSONsim
metodologiaAs páginas de metodologia publicadas, em textosim
saudeCobertura atual e última ingestãosim

trimestres para no 3T de propósito. A ITR nunca traz o 4º trimestre isolado — ele sai de exercício cheio − 9 meses, e há quem derive. Nós não: um número calculado por nós entraria na MESMA lista dos que a companhia reportou, carregando o erro de dois arquivos e apagando a fronteira entre "foi publicado" e "nós calculamos". Para o ano fechado, peça a série anual.

A empresa WEGE3 e a metodologia são abertas para degustação, sem chave. Para as demais, crie uma chave grátis em https://dadosb3.com/chave-gratis?de=github (200 consultas/dia, sem cartão) ou assine o Pro em https://dadosb3.com/assinar?de=github e passe a chave no argumento chave_api (ou na variável DADOS_B3_API_KEY).

A contagem de empresas não fica escrita aqui de propósito: o universo cresce quando a CVM publica, e um número congelado num README envelheceria sem ninguém ver. Para o número de hoje, chame saude.

Bancos e seguradoras

Instituições financeiras têm plano de contas próprio (não há EBIT nem receita de venda). O conector as classifica pelo plano de contas real e entrega os indicadores que fazem sentido — ROE, margem, crescimento, P/L, P/VP, dividendos — e não publica ROIC/EBITDA/EV-EBITDA para elas (não se aplicam). Ex.: Itaú, Bradesco, Banco do Brasil, BB Seguridade, IRB.

Por que este e não outro

Metodologia 100% pública, testes de invariantes antes de cada publicação, múltiplos sem vazamento de informação futura, e histórico de reapresentações registrado. Comparativo honesto, inclusive onde os concorrentes são melhores: https://dadosb3.com/comparativo?de=github

Licença

MIT (este conector). Os dados são públicos (CVM/B3); o serviço adiciona padronização, metodologia e testes.

How do I install Dados B3?
Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Dados B3 need an API key?
The publisher lists these environment variables: DADOS_B3_API_KEY.
What transport does Dados B3 use?
Dados B3 is reached over HTTP.
When was Dados B3 last checked?
Last checked 2026-10-16. Brazilian stock (B3) fundamentals: ratios, dividends, scores, FIIs, ETFs, BDRs. Open methodology.

No tool list yet. Remote servers get one after the first health check.

plugmcp

Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.

  • github.com/TODO
  • x.com/TODO
  • linkedin.com/company/TODO

PlugMCP, 2026

Product
  • Browse
  • Install
  • Host your own
  • Pricing
  • Voice mode
  • Browser
Directory
  • All MCP servers
  • MCP Apps
  • Tools
  • Agent skills
  • Categories
  • New
  • Voice
  • Submit a server
Developers
  • Docs
  • Blog
  • Club
  • Work with us
  • What is MCP
  • What is WebMCP
  • Status
Company
  • About
  • Contact
  • Terms
  • Privacy
  • DPA