Investidor B3
Server Details
Your consolidated B3 investment portfolio (the central depository): position by asset, net worth, tr
- Status
- Healthy
- Uptime
- 95.5% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- mcp-dir/b3-mcp
- GitHub Stars
- 0
- Server Listing
- Investidor B3
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 20 tools
Most tools are clearly separated by resource (carteira, posicao, proventos, negociacoes) and the b3_ prefix groups them. However, b3_get_carteira, b3_get_posicao, and b3_list_ativos all relate to portfolio positions and could be confused without careful reading; also authenticate/connect overlap in the auth domain.
The b3_* tools follow a consistent verb_noun pattern (get_, list_), but the non-b3 tools (authenticate, connect, marketplace, report_bug, show_version, toolkit_info) break the pattern and use different verb styles, creating a mixed convention.
20 tools is on the higher end but justifiable for a B3 investor data server plus platform utilities. The b3 domain has 13 tools covering the main data needs, and the remaining 7 are platform-level helpers, so the count is reasonable though slightly heavy.
The B3 domain covers the core investor data surface well: profile, accounts, institutions, portfolio, positions, transactions, corporate actions, and dividends. Minor gaps exist (e.g., no tool for detailed trade order history or tax reporting), but agents can accomplish the main workflows.
Available Tools
20 toolsauthenticateAIdempotentInspect
MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header Authorization: Bearer <token> for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "" } after the user pastes, or with no args to get the link.
Inputs: token.
b3_get_carteiraBRead-onlyIdempotentInspect
Resumo da carteira agrupado por classe de ativo (ações, FIIs, renda fixa, etc.) com valor e percentual de cada grupo.
Inputs: account, quantidade, agrupamento.
b3_get_evolucao_patrimonialCRead-onlyIdempotentInspect
Série histórica de evolução do patrimônio na B3.
Inputs: ap, data, account.
b3_get_patrimonioARead-onlyIdempotentInspect
Patrimônio total consolidado na B3 (soma de todas as corretoras) numa data. Retorna { valor, data }.
Inputs: data, account.
b3_get_perfilBRead-onlyIdempotentInspect
Cadastro/perfil do investidor (identidade da conta B3 conectada).
Inputs: account.
b3_get_posicaoARead-onlyIdempotentInspect
Posição DETALHADA por ativo numa data: ticker (codigoNegociacao), quantidade, preço de fechamento, valor atualizado, ISIN, instituição. Agrupado por tipo de produto. Paginado.
Inputs: data, pagina, account.
b3_get_ultima_atualizacaoARead-onlyIdempotentInspect
Data/hora da última carga de dados da B3 (a base é D-1). Use para saber quão fresca está a posição.
Inputs: account.
b3_list_accountsCRead-onlyIdempotentInspect
Lista as contas da Área do Investidor B3 conectadas a este install — id, label.
Inputs: account.
b3_list_ativosARead-onlyIdempotentInspect
Drill-down nos ativos de UM tipo de produto (informe codigoProduto), com valor e percentual de cada ativo do grupo. Para a posição COMPLETA de todos os ativos, use b3_get_posicao.
Inputs: codigoProduto (required), account, agrupamento.
b3_list_instituicoesCRead-onlyIdempotentInspect
Instituições (corretoras) vinculadas ao investidor na B3.
Inputs: account.
b3_list_movimentacaoBRead-onlyIdempotentInspect
Movimentação de ativos (entradas/saídas: transferências, subscrições, bonificações, etc.) num intervalo. Paginado.
Inputs: pagina, account, dataFim, dataInicio.
b3_list_negociacoesCRead-onlyIdempotentInspect
Negociações (compras/vendas) num intervalo de datas. Paginado por page.
Inputs: page, account, dataFim, dataInicio.
b3_list_ofertas_publicasBRead-onlyIdempotentInspect
Ofertas públicas (IPOs/subscrições) do investidor num intervalo. Paginado por page.
Inputs: page, account, dataFim, dataInicio.
b3_list_proventos_a_receberBRead-onlyIdempotentInspect
Proventos provisionados a receber (dividendos/JCP futuros) numa data de referência.
Inputs: data, pagina, account.
b3_list_proventos_recebidosBRead-onlyIdempotentInspect
Proventos já recebidos (dividendos/JCP pagos) num intervalo de datas. Paginado.
Inputs: page, account, dataFim, dataInicio.
connectARead-onlyIdempotentInspect
Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
Inputs: no named parameters.
marketplaceAInspect
The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/ link that opens without login.
Inputs: limit, query, action, mcp_id, +19 more.
report_bugAIdempotentInspect
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Inputs: message (required), context, conversation.
show_versionARead-onlyIdempotentInspect
Show the current MCP platform and adapter versions.
Inputs: no named parameters.
toolkit_infoARead-onlyIdempotentInspect
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Brazilian financial market data (B3): quotes, fundamentals, dividends, REITs (FIIs), BDRs, crypto, F
Brazilian personal finance: spending, statements, goals, portfolio and dividends.
Brazilian stocks (B3): 36 read-only tools. Fundamentals, dividends, FIIs, ETFs. Most need no key.
Brazilian investments MCP: B3 quotes, fundamentals, portfolio X-ray, theses and news for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceBrazilian investment-fund analytics for AI clients via the Model Context Protocol (MCP). Connect Claude Desktop, Cursor, ChatGPT, or any MCP-compatible client to query 30,000+ Brazilian investment funds: daily NAV, complete holdings (CDA), fund-of-funds look-through, portfolio overlap analysis, and your personal favorites/watchlist.MIT
- AlicenseNot gradedqualityDmaintenanceProvides Brazilian financial market data (stocks, dividends, FIIs, crypto, exchange rates, macro indicators) from B3. Works with any MCP client via HTTP, read-only.MIT
- AlicenseAqualityCmaintenanceTalk to your XP Investimentos portfolio through Claude — 100% local, read-only, zero scraping.1811 npm12MIT
- AlicenseAqualityDmaintenanceProvides Brazilian financial market data including stock prices, fundamentals, dividends, FIIs, and macro indicators to AI assistants.1136 PyPI2MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.