# Investidor B3 MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-mcp-dir-b3-mcp
- Repository: https://github.com/mcp-dir/b3-mcp

## Install
- Endpoint: https://api.mcp.ai/p_b3
- Auth: Not captured

## Setup notes
- Remote endpoint: https://api.mcp.ai/p_b3

## Tools
- b3_list_accounts - Lista as contas da Área do Investidor B3 conectadas a este install — id, label. Endpoint: https://api.mcp.ai/p_b3
- b3_get_patrimonio - Patrimônio total consolidado na B3 (soma de todas as corretoras) numa data. Retorna { valor, data }. Endpoint: https://api.mcp.ai/p_b3
- b3_get_carteira - Resumo da carteira agrupado por classe de ativo (ações, FIIs, renda fixa, etc.) com valor e percentual de cada grupo. Endpoint: https://api.mcp.ai/p_b3
- b3_get_posicao - 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. Endpoint: https://api.mcp.ai/p_b3
- b3_list_ativos - 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. Endpoint: https://api.mcp.ai/p_b3
- b3_get_evolucao_patrimonial - Série histórica de evolução do patrimônio na B3. Endpoint: https://api.mcp.ai/p_b3
- b3_list_negociacoes - Negociações (compras/vendas) num intervalo de datas. Paginado por `page`. Endpoint: https://api.mcp.ai/p_b3
- b3_list_movimentacao - Movimentação de ativos (entradas/saídas: transferências, subscrições, bonificações, etc.) num intervalo. Paginado. Endpoint: https://api.mcp.ai/p_b3
- b3_list_proventos_a_receber - Proventos provisionados a receber (dividendos/JCP futuros) numa data de referência. Endpoint: https://api.mcp.ai/p_b3
- b3_list_proventos_recebidos - Proventos já recebidos (dividendos/JCP pagos) num intervalo de datas. Paginado. Endpoint: https://api.mcp.ai/p_b3
- b3_list_ofertas_publicas - Ofertas públicas (IPOs/subscrições) do investidor num intervalo. Paginado por `page`. Endpoint: https://api.mcp.ai/p_b3
- b3_get_perfil - Cadastro/perfil do investidor (identidade da conta B3 conectada). Endpoint: https://api.mcp.ai/p_b3
- b3_list_instituicoes - Instituições (corretoras) vinculadas ao investidor na B3. Endpoint: https://api.mcp.ai/p_b3
- b3_get_ultima_atualizacao - Data/hora da última carga de dados da B3 (a base é D-1). Use para saber quão fresca está a posição. Endpoint: https://api.mcp.ai/p_b3
- show_version - Show the current MCP platform and adapter versions. Endpoint: https://api.mcp.ai/p_b3
- report_bug - Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. Endpoint: https://api.mcp.ai/p_b3
- connect - 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. Endpoint: https://api.mcp.ai/p_b3
- toolkit_info - Returns the current toolkit state: installed MCPs, their connection status, and how many catalog tools each exposes. Endpoint: https://api.mcp.ai/p_b3
- marketplace - 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. Endpoint: https://api.mcp.ai/p_b3
- authenticate - 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: "<jwt>" } after the user pastes, or with no args to get the link. Endpoint: https://api.mcp.ai/p_b3

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.mcp-dir
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 12, 2026
- Source: https://registry.modelcontextprotocol.io