English Français العربية

Investidor B3

Official registry Finance and payments

Your consolidated B3 investment portfolio (the central depository): position by asset, net worth, tr

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http investidor-b3 'https://api.mcp.ai/p_b3'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "investidor-b3": {
            "type": "http",
            "url": "https://api.mcp.ai/p_b3"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Investidor B3
  2. One-click install
  3. Example prompts
  4. 14 tools available
  5. How it works
  6. Pricing
  7. Privacy & data protection
  8. FAQ
  9. Support
  10. License

Investidor B3

Consolidated B3 portfolio (Área do Investidor) for Claude, Cursor and AI agents

Your consolidated investment portfolio at B3 — Brazil's central securities depository, where custody from ALL of your brokers shows up in a single source. Holdings by asset, net worth and its evolution, trades, dividends and interest-on-equity (received and upcoming), movements and public offerings. Read-only, D-1 data, read from your own Área do Investidor account with your authorization.

  • 🏛️ The source is B3 itself — the central depository, not an aggregator: whatever sits in your custody is what you get
  • 🧾 Every broker in one portfolio — holdings by asset, net worth and net-worth evolution
  • 💸 Dividends and interest-on-equity, both received and upcoming, with dates and amounts
  • 📈 Trades and movements by period, plus the public offerings you took part in
  • 📊 14 tools, all read-only (B3's D-1 data)
  • 🔑 Connects with your Área do Investidor CPF and password (2FA code when B3 asks) — the platform reads YOUR data, with your consent
  • 🏦 Pairs with the Banco MCP (Open Finance): banking and cards there, investment portfolio here
  • 💬 Works with any MCP client: Claude Desktop, Cursor, VS Code, Cline, Continue

Versão em português · Full docs (PT-BR) · Agent skill

One-click install

Claude (Web and Desktop)

Anthropic unified MCP installation at claude.ai/customize/connectors. The same link works for Claude Web and Claude Desktop (just be logged in):

➕ Open in Claude and connect

Manual (if the deeplink does not open): claude.ai/customize/connectors → + → Add custom connector → paste Name Investidor B3 and URL https://api.mcp.ai/p_b3.

Cursor

➕ Install Investidor B3 in Cursor

VS Code (Copilot Chat)

➕ Install Investidor B3 in VS Code

ChatGPT, Manus, OpenClaw and 40+ other clients

Works with any MCP client that speaks MCP over HTTP. The server URL is always:

https://api.mcp.ai/p_b3

Per-client details: INSTALL.md.

Example prompts

What's my total net worth at B3 today?
Show my holdings by asset and each one's share of the portfolio
How much did I get in dividends and interest-on-equity in the last 3 months?
Any upcoming dividends in the next few weeks?
List last month's trades and the institutions where I hold custody

14 tools available

ToolDescription
b3_list_accountsLista as contas da Área do Investidor B3 conectadas a este install — id, label.
b3_get_patrimonioPatrimônio total consolidado na B3 (soma de todas as corretoras) numa data.
b3_get_carteiraResumo da carteira agrupado por classe de ativo (ações, FIIs, renda fixa, etc.) com valor e percentual de cada grupo.
b3_get_posicaoPosição DETALHADA por ativo numa data: ticker (codigoNegociacao), quantidade, preço de fechamento, valor atualizado, ISIN, instituição.
b3_list_ativosDrill-down nos ativos de UM tipo de produto (informe codigoProduto), com valor e percentual de cada ativo do grupo.
b3_get_evolucao_patrimonialSérie histórica de evolução do patrimônio na B3.
b3_list_negociacoesNegociações (compras/vendas) num intervalo de datas.
b3_list_movimentacaoMovimentação de ativos (entradas/saídas: transferências, subscrições, bonificações, etc.) num intervalo.
b3_list_proventos_a_receberProventos provisionados a receber (dividendos/JCP futuros) numa data de referência.
b3_list_proventos_recebidosProventos já recebidos (dividendos/JCP pagos) num intervalo de datas.
b3_list_ofertas_publicasOfertas públicas (IPOs/subscrições) do investidor num intervalo.
b3_get_perfilCadastro/perfil do investidor (identidade da conta B3 conectada).
b3_list_instituicoesInstituições (corretoras) vinculadas ao investidor na B3.
b3_get_ultima_atualizacaoData/hora da última carga de dados da B3 (a base é D-1).

Details for each tool: docs/ferramentas.md (PT-BR)

How it works

1. Connect your Área do Investidor account (CPF + password; 2FA when B3 asks)
2. b3_get_patrimonio / b3_get_carteira / b3_get_posicao → consolidated portfolio snapshot
3. b3_list_proventos_recebidos / _a_receber → dividends and interest-on-equity
4. b3_list_negociacoes / b3_list_movimentacao → what came in and out over a period

B3 is the central securities depository: custody from all of your brokers is already consolidated there. That's why there's no "connect each broker" step — one connection covers the whole portfolio. Data is D-1 (previous close) and read-only — no tool places orders, transfers or changes anything.

Pairs with the Banco MCP (Open Finance) for the full picture: account and cards on one side, portfolio on the other.

Pricing

Plans start at a free tier. See docs/precos.md (PT-BR).

Privacy & data protection

  • Read-only, no tool changes data at the source.
  • Sub-processors: B3 S.A. — Brasil, Bolsa, Balcão, the LLM host you choose (Claude, ChatGPT, Cursor, your own agent). Full list in docs/privacidade-lgpd.md.
  • Data returned by the tools is sent to the LLM host you choose, a sub-processor outside our control. We recommend plans with training opt-out.

FAQ

Does this place buy or sell orders? No. All 14 tools are read-only. The MCP reads your custody at B3 — there's no broker or order routing in the path.

Do I have to connect each broker? No. B3 is the central depository: custody from all your brokers is already consolidated in Área do Investidor. One connection covers the whole portfolio.

Is the data real-time? No. Área do Investidor works with D-1 data (previous close). For live quotes, use a market-data source.

How does connecting with 2FA work? You provide CPF and password on the connect screen and, if B3 asks for a verification code, the dashboard prompts you for it right there and finishes the connection. The credential is encrypted and you can disconnect whenever you want at app.mcp.ai.

Is the server open source? The server is proprietary (hosted). This repository is the public wrapper with manifests, docs and skill, all MIT.

Support

License

MIT — see LICENSE. The MCP server at api.mcp.ai/p_b3 is proprietary (hosted); this repo (manifests, docs, skills) is MIT.

Frequently asked questions

What is Investidor B3?

Your consolidated B3 investment portfolio (the central depository): position by asset, net worth, tr

How do I install Investidor B3?

It runs as a remote server. In Claude Code: claude mcp add --transport http investidor-b3 'https://api.mcp.ai/p_b3'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Investidor B3 need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Investidor B3 open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Investidor B3?

It is published by mcp-dir. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.