io.github.mcp-dir/b3-mcp

Tools

• 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.

  shallow
• b3_get_carteira

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

  shallow
• b3_get_evolucao_patrimonial

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

  shallow
• b3_get_patrimonio

  Patrimônio total consolidado na B3 (soma de todas as corretoras) numa data. Retorna { valor, data }.

  shallow
• b3_get_perfil

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

  shallow
• 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.

  shallow
• 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.

  shallow
• b3_list_accounts

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

  shallow
• 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.

  shallow
• b3_list_instituicoes

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

  shallow
• b3_list_movimentacao

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

  shallow
• b3_list_negociacoes

  Negociações (compras/vendas) num intervalo de datas. Paginado por `page`.

  shallow
• b3_list_ofertas_publicas

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

  shallow
• b3_list_proventos_a_receber

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

  shallow
• b3_list_proventos_recebidos

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

  shallow
• 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.

  shallow
• 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. 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/<slug> link that opens without login.

  shallow
• report_bug

  Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

  shallow
• show_version

  Show the current MCP platform and adapter versions.

  shallow
• toolkit_info

  Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/d7d34feb-4d28-4bf3-a951-d8fd15fc3d6e/badge.svg)](https://vouch.tools/servers/d7d34feb-4d28-4bf3-a951-d8fd15fc3d6e)