Investidor B3 MCP Server

io.github.mcp-dir/b3-mcp

answering

Investidor B3 is answering right now. Last checked 2 min ago. It exposes 20 tools. Last commit 12 Jun 2026.

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

Uptime history 40 hours of history

40 hours agonow

100.0%

Uptime 24h

92 of 92 checks

Tools

read from the server

708 ms

Response time

average over 24h

Stars

last commit 12 Jun 2026

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 2 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add b3-mcp --transport http https://api.mcp.ai/p_b3

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "b3-mcp": {
      "url": "https://api.mcp.ai/p_b3"
    }
  }
}

~/.codex/config.toml

[mcp_servers.b3-mcp]
url = "https://api.mcp.ai/p_b3"

.cursor/mcp.json

{
  "mcpServers": {
    "b3-mcp": {
      "url": "https://api.mcp.ai/p_b3"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "b3-mcp": {
      "url": "https://api.mcp.ai/p_b3"
    }
  }
}

Available tools 20

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

proventos

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

accounts

b3_list_accounts

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

ativos

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.

authenticate

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.

carteira

b3_get_carteira

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

connect

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.

evolucao

b3_get_evolucao_patrimonial

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

instituicoes

b3_list_instituicoes

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

marketplace

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.

movimentacao

b3_list_movimentacao

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

negociacoes

b3_list_negociacoes

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

ofertas

b3_list_ofertas_publicas

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

patrimonio

b3_get_patrimonio

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

perfil

b3_get_perfil

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

posicao

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.

report

report_bug

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

show

show_version

Show the current MCP platform and adapter versions.

toolkit

toolkit_info

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

ultima

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.

Endpoints

URL	Transport	State	Latency	Checked
https://api.mcp.ai/p_b3	streamable-http	answering	1808 ms	2 min ago

Investidor B3 — questions

Answers built from our own checks of this server.

What can Investidor B3 do?

It exposes 20 tools, read directly from the server on our last check. Among them: authenticate, b3_get_carteira, b3_get_evolucao_patrimonial, b3_get_patrimonio, b3_get_perfil, b3_get_posicao and 14 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Investidor B3 working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 708 ms. The bar chart above shows every period we have measured.

How do I connect Investidor B3?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Investidor B3 need an API key?

No. Investidor B3 completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 20 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Investidor B3?

It answers our handshake in 708 ms on average, which is faster than 11% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Investidor B3 open source?

Yes — it is published under the MIT licence and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.