Investidor B3 — REST API skill

Você tem acesso à Investidor B3 REST API na MCP.AI.

Sua carteira de investimentos consolidada da B3 (a central depositária): posição por ativo, patrimônio, negociações, proventos (dividendos/JCP) e movimentação, de todas as corretoras numa fonte só. Somente leitura, dado D-1. Conecte a sua própria conta da Área do Investidor, com consentimento. Pareia com o Banco MCP (Open Finance), banco no Banco MCP, carteira de investimentos aqui.

Base URL

https://api.mcp.ai/api/b3

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/b3/get/carteira \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/b3/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (14)

#### b3_get_carteira

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

#### b3_get_evolucao_patrimonial

Série histórica de evolução do patrimônio na B3. _(POST /api/b3/get/evolucao/patrimonial)_

#### b3_get_patrimonio

Patrimônio total consolidado na B3 (soma de todas as corretoras) numa data. _(POST /api/b3/get/patrimonio)_

#### b3_get_perfil

Cadastro/perfil do investidor (identidade da conta B3 conectada). _(POST /api/b3/get/perfil)_

#### b3_get_posicao

Posição DETALHADA por ativo numa data: ticker (codigoNegociacao), quantidade, preço de fechamento, valor atualizado, ISIN, instituição. _(POST /api/b3/get/posicao)_

#### b3_get_ultima_atualizacao

Data/hora da última carga de dados da B3 (a base é D-1). _(POST /api/b3/get/ultima/atualizacao)_

#### b3_list_accounts

Lista as contas da Área do Investidor B3 conectadas a este install — id, label. _(POST /api/b3/list/accounts)_

#### b3_list_ativos

Drill-down nos ativos de UM tipo de produto (informe codigoProduto), com valor e percentual de cada ativo do grupo. _(POST /api/b3/list/ativos)_

#### b3_list_instituicoes

Instituições (corretoras) vinculadas ao investidor na B3. _(POST /api/b3/list/instituicoes)_

#### b3_list_movimentacao

Movimentação de ativos (entradas/saídas: transferências, subscrições, bonificações, etc.) num intervalo. _(POST /api/b3/list/movimentacao)_

#### b3_list_negociacoes

Negociações (compras/vendas) num intervalo de datas. _(POST /api/b3/list/negociacoes)_

#### b3_list_ofertas_publicas

Ofertas públicas (IPOs/subscrições) do investidor num intervalo. _(POST /api/b3/list/ofertas/publicas)_

#### b3_list_proventos_a_receber

Proventos provisionados a receber (dividendos/JCP futuros) numa data de referência. _(POST /api/b3/list/proventos/a/receber)_

#### b3_list_proventos_recebidos

Proventos já recebidos (dividendos/JCP pagos) num intervalo de datas. _(POST /api/b3/list/proventos/recebidos)_

Este MCP também funciona via conexão MCP (Claude / Cursor) em https://api.mcp.ai/p_b3 — veja o README. A skill acima é pra consumir a REST API direto (agente próprio / código).