Investidor B3

Investidor B3 para Claude, ChatGPT e agentes de IA

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.

• 📊 14 ferramentas
• 🔒 Somente leitura
• 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
• 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes

---

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Investidor B3 e URL https://api.mcp.ai/p_b3.

Cursor

➕ Instalar Investidor B3 no Cursor

VS Code (Copilot Chat)

➕ Instalar Investidor B3 no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_b3

Detalhes por cliente: INSTALL.md.

---

Exemplos de uso

Qual o meu patrimônio total na B3?
Mostre a minha posição por ativo
Quanto recebi de dividendos nos últimos 3 meses?

---

14 ferramentas disponíveis

Tool	Descrição
b3_list_accounts	Lista as contas da Área do Investidor B3 conectadas a este install — id, label.
b3_get_patrimonio	Patrimônio total consolidado na B3 (soma de todas as corretoras) numa data.
b3_get_carteira	Resumo da carteira agrupado por classe de ativo (ações, FIIs, renda fixa, etc.) com valor e percentual de cada grupo.
b3_get_posicao	Posição DETALHADA por ativo numa data: ticker (codigoNegociacao), quantidade, preço de fechamento, valor atualizado, ISIN, instituição.
b3_list_ativos	Drill-down nos ativos de UM tipo de produto (informe codigoProduto), com valor e percentual de cada ativo do grupo.
b3_get_evolucao_patrimonial	Série histórica de evolução do patrimônio na B3.
b3_list_negociacoes	Negociações (compras/vendas) num intervalo de datas.
b3_list_movimentacao	Movimentação de ativos (entradas/saídas: transferências, subscrições, bonificações, etc.) num intervalo.
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.
b3_list_ofertas_publicas	Ofertas públicas (IPOs/subscrições) do investidor num intervalo.
b3_get_perfil	Cadastro/perfil do investidor (identidade da conta B3 conectada).
b3_list_instituicoes	Instituições (corretoras) vinculadas ao investidor na B3.
b3_get_ultima_atualizacao	Data/hora da última carga de dados da B3 (a base é D-1).

Detalhe de cada tool: docs/ferramentas.md

---

Preços

Planos a partir do tier grátis. Veja docs/precos.md.

---

Privacidade & LGPD

• Somente leitura, nenhuma ferramenta altera dados na origem.
• Sub-processadores: B3 S.A. — Brasil, Bolsa, Balcão, o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
• Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

---

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_b3.

---

Suporte

• 📧 [email protected]
• 🐛 GitHub Issues
• 📄 docs/

---

Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_b3 é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.