Investidor B3
Your consolidated B3 investment portfolio (the central depository): position by asset, net worth, tr
Should I use this
Quality & Safety
Findings (15)
- HIGH
- MEDIUMin b3_list_ativos
- LOWin b3_get_patrimonio
- LOWin b3_get_posicao
- LOWin b3_get_evolucao_patrimonial
- LOWin b3_list_negociacoes
- LOWin b3_list_movimentacao
- LOWin b3_list_proventos_a_receber
- LOWin b3_list_proventos_recebidos
- LOWin b3_list_ofertas_publicas
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"b3-mcp": {
"url": "https://api.mcp.ai/p_b3"
}
}
}Remote endpoints
https://api.mcp.ai/p_b3streamable-httpWhat it can do
Tool inventory
Tools (20)
🟢b3_list_accounts(account)
Lista as contas da Área do Investidor B3 conectadas a este install — id, label.
Input Schema
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_get_patrimonio(data, account)
Patrimônio total consolidado na B3 (soma de todas as corretoras) numa data. Retorna { valor, data }.
Input Schema
{
"type": "object",
"properties": {
"data": {
"type": "string"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_get_carteira(agrupamento, quantidade, account)
Resumo da carteira agrupado por classe de ativo (ações, FIIs, renda fixa, etc.) com valor e percentual de cada grupo.
Input Schema
{
"type": "object",
"properties": {
"agrupamento": {
"type": "number"
},
"quantidade": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_get_posicao(data, pagina, account)
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.
Input Schema
{
"type": "object",
"properties": {
"data": {
"type": "string"
},
"pagina": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_list_ativos(codigoProduto, agrupamento, account)
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.
Input Schema
{
"type": "object",
"properties": {
"codigoProduto": {
"type": "string"
},
"agrupamento": {
"type": "number"
},
"account": {
"type": "string"
}
},
"required": [
"codigoProduto"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_get_evolucao_patrimonial(data, ap, account)
Série histórica de evolução do patrimônio na B3.
Input Schema
{
"type": "object",
"properties": {
"data": {
"type": "string"
},
"ap": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_list_negociacoes(dataInicio, dataFim, page, account)
Negociações (compras/vendas) num intervalo de datas. Paginado por `page`.
Input Schema
{
"type": "object",
"properties": {
"dataInicio": {
"type": "string"
},
"dataFim": {
"type": "string"
},
"page": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_list_movimentacao(dataInicio, dataFim, pagina, account)
Movimentação de ativos (entradas/saídas: transferências, subscrições, bonificações, etc.) num intervalo. Paginado.
Input Schema
{
"type": "object",
"properties": {
"dataInicio": {
"type": "string"
},
"dataFim": {
"type": "string"
},
"pagina": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_list_proventos_a_receber(data, pagina, account)
Proventos provisionados a receber (dividendos/JCP futuros) numa data de referência.
Input Schema
{
"type": "object",
"properties": {
"data": {
"type": "string"
},
"pagina": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_list_proventos_recebidos(dataInicio, dataFim, page, account)
Proventos já recebidos (dividendos/JCP pagos) num intervalo de datas. Paginado.
Input Schema
{
"type": "object",
"properties": {
"dataInicio": {
"type": "string"
},
"dataFim": {
"type": "string"
},
"page": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_list_ofertas_publicas(dataInicio, dataFim, page, account)
Ofertas públicas (IPOs/subscrições) do investidor num intervalo. Paginado por `page`.
Input Schema
{
"type": "object",
"properties": {
"dataInicio": {
"type": "string"
},
"dataFim": {
"type": "string"
},
"page": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_get_perfil(account)
Cadastro/perfil do investidor (identidade da conta B3 conectada).
Input Schema
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_list_instituicoes(account)
Instituições (corretoras) vinculadas ao investidor na B3.
Input Schema
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢b3_get_ultima_atualizacao(account)
Data/hora da última carga de dados da B3 (a base é D-1). Use para saber quão fresca está a posição.
Input Schema
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢show_version
Show the current MCP platform and adapter versions.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡report_bug(message, context, conversation)
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Input Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
},
"context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
}
},
"required": [
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡marketplace(action, query, mcp_id, limit, tier_slug, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"action": {
"default": "search",
"type": "string",
"enum": [
"search",
"describe",
"install",
"uninstall",
"subscribe",
"cancel",
"resume",
"report_bug",
"request_mcp",
"list_tools",
"invoke",
"search_prompts",
"get_prompt",
"publish_prompt"
]
},
"query": {
"default": "",
"type": "string"
},
"mcp_id": {
"default": "",
"type": "string"
},
"limit": {
"default": 10,
"type": "number"
},
"tier_slug": {
"default": "",
"type": "string"
},
"immediate": {
"default": false,
"type": "boolean"
},
"cancel_reason": {
"type": "string",
"enum": [
"too_expensive",
"missing_features",
"switched_service",
"unused",
"customer_service",
"too_complex",
"low_quality",
"other"
]
},
"cancel_comment": {
"default": "",
"type": "string"
},
"message": {
"default": "",
"type": "string"
},
"report_context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
},
"request_name": {
"default": "",
"type": "string"
},
"request_details": {
"default": "",
"type": "string"
},
"tool_id": {
"default": "",
"type": "string"
},
"arguments": {
"default": "{}",
"type": "string"
},
"prompt_slug": {
"default": "",
"type": "string"
},
"prompt_vars": {
"default": "{}",
"type": "string"
},
"prompt_category": {
"default": "",
"type": "string"
},
"prompt_tool": {
"default": "",
"type": "string"
},
"prompt_title": {
"default": "",
"type": "string"
},
"prompt_description": {
"default": "",
"type": "string"
},
"prompt_body": {
"default": "",
"type": "string"
},
"prompt_targets": {
"default": [],
"type": "array",
"items": {
"type": "string",
"enum": [
"claude",
"chatgpt",
"cursor",
"lovable"
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡authenticate(token)
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.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence