Skip to main content
Glama
mcp-dir

Investidor B3

by mcp-dir

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.


Related MCP server: Indian Broker MCP Server

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

Tool

Description

b3_list_accounts

Lista as contas da Área do Investidor B3 conectadas a este install — id, label.

b3_get_patrimonio

Patrimônio total consolidado na B3 (soma de todas as corretoras) numa data.

b3_get_carteira

Resumo da carteira agrupado por classe de ativo (ações, FIIs, renda fixa, etc.) com valor e percentual de cada grupo.

b3_get_posicao

Posição DETALHADA por ativo numa data: ticker (codigoNegociacao), quantidade, preço de fechamento, valor atualizado, ISIN, instituição.

b3_list_ativos

Drill-down nos ativos de UM tipo de produto (informe codigoProduto), com valor e percentual de cada ativo do grupo.

b3_get_evolucao_patrimonial

Série histórica de evolução do patrimônio na B3.

b3_list_negociacoes

Negociações (compras/vendas) num intervalo de datas.

b3_list_movimentacao

Movimentação de ativos (entradas/saídas: transferências, subscrições, bonificações, etc.) num intervalo.

b3_list_proventos_a_receber

Proventos provisionados a receber (dividendos/JCP futuros) numa data de referência.

b3_list_proventos_recebidos

Proventos já recebidos (dividendos/JCP pagos) num intervalo de datas.

b3_list_ofertas_publicas

Ofertas públicas (IPOs/subscrições) do investidor num intervalo.

b3_get_perfil

Cadastro/perfil do investidor (identidade da conta B3 conectada).

b3_list_instituicoes

Instituições (corretoras) vinculadas ao investidor na B3.

b3_get_ultima_atualizacao

Data/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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Talk to your XP Investimentos portfolio through Claude — 100% local, read-only, zero scraping.
    12
    12
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides Brazilian financial market data (stocks, dividends, FIIs, crypto, exchange rates, macro indicators) from B3. Works with any MCP client via HTTP, read-only.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables reading C6 Bank account balances, statements, credit card bills, and investments via Open Finance Brasil. It is read-only and regulated by the Central Bank of Brazil.
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mcp-dir/b3-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server