Dados B3 MCP Server

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…

Local + remotestreamable-httpstdio

What is the Dados B3 MCP Server?

Dados B3 | MCP Server is an MCP project maintained in the val7h/dados-b3-mcp repository. The maintainer describes its purpose as “An MCP connector that gives your AI agent (Claude, ChatGPT, Cursor and others) access to fundamentals for Brazilian listed companies (B3) — banks and insurers…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using python. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares DADOS_B3_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
listar_empresasEvery covered company (name, tax ID, ticker), banks and insurers included
indicadores_anuaisROE, ROIC, margins, growth, net debt/EBITDA — annual series from 2010
multiplosP/E, P/B, EV/EBITDA point-in-time; trailing P/E
fatos_contabeisStandardised accounts carrying the CVM code each figure came from
dividendosCash distributions, annual summary and 12-month dividend yield
scoresPiotroski F-Score with all nine criteria shown, plus the Graham test
reapresentacoesRestated filings — the original and the revised figure side by side
trimestresQuarterly series: Q1/Q2/Q3 accounts as filed, the quarter's price, margins and trailing ROE
etfs_rankingB3 ETFs: most traded, largest net assets, largest premium/discount to same-day NAV, 12m NAV return, lowest EFFECTIVE fee
etfOne ETF: daily NAV (FNET filing), premium/discount, monthly effective fee, portfolio (CDA) and overlap with peers
auditar_amostraDraws cases with YOUR seed so you can recompute each figure against the CVM file (formula, account, where to look)
fiis_rankingMost discounted FIIs (point-in-time P/B), highest 12m yield and medians by segment
hojeWhat changed in the last 30 days: filings published, filings re-sent, dividends, fund distributions, corporate actions, ticker changes
fiiOne real-estate fund: point-in-time P/B, 12-month yield, vacancy, recent distributions
fiisFilters funds by P/B and dividend-yield ranges
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…
reciboReads a frozen screener query: question, cut-off date, data version, result and its sha256
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…
dicionarioFormula, CVM accounts and earnings base of each indicator, as JSON
metodologiaThe published methodology pages, as text
saudeCurrent coverage and last ingestion

How to install the Dados B3 MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
DADOS_B3_API_KEYDeclared in the maintainer’s client configuration.Optional