# Investidor B3 — MCP server on mcp.ai
> Your consolidated B3 investment portfolio (the central depository): position by asset, net worth, trades, dividends/interest-on-equity and movements, across all brokers in one place. Read-only, D-1 data. Connect your own Área do Investidor account, with consent. Pairs with the Banco MCP (Open Finance), banking in the Banco MCP, investment portfolio here.

By: mcp.ai · official
Page: https://mcp.ai/b3

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_b3?ms=1781685660000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/b3/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/b3/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/b3/skill.md
Postman collection (v2.1): https://mcp.ai/b3/postman.json

## Tools
- b3_get_carteira(agrupamento?: integer, quantidade?: integer, account?: string) — Resumo da carteira agrupado por classe de ativo (ações, FIIs, renda fixa, etc.) com valor e percentual de cada grupo.
- b3_get_evolucao_patrimonial(data?: string, ap?: integer, account?: string) — Série histórica de evolução do patrimônio na B3.
- b3_get_patrimonio(data?: string, account?: string) — Patrimônio total consolidado na B3 (soma de todas as corretoras) numa data. Retorna { valor, data }.
- b3_get_perfil(account?: string) — Cadastro/perfil do investidor (identidade da conta B3 conectada).
- b3_get_posicao(data?: string, pagina?: integer, account?: string) — 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.
- b3_get_ultima_atualizacao(account?: string) — Data/hora da última carga de dados da B3 (a base é D-1). Use para saber quão fresca está a posição.
- b3_list_accounts(account?: string) — Lista as contas da Área do Investidor B3 conectadas a este install — id, label.
- b3_list_ativos(codigoProduto: string, agrupamento?: integer, account?: string) — 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.
- b3_list_instituicoes(account?: string) — Instituições (corretoras) vinculadas ao investidor na B3.
- b3_list_movimentacao(dataInicio?: string, dataFim?: string, pagina?: integer, account?: string) — Movimentação de ativos (entradas/saídas: transferências, subscrições, bonificações, etc.) num intervalo. Paginado.
- b3_list_negociacoes(dataInicio?: string, dataFim?: string, page?: integer, account?: string) — Negociações (compras/vendas) num intervalo de datas. Paginado por `page`.
- b3_list_ofertas_publicas(dataInicio?: string, dataFim?: string, page?: integer, account?: string) — Ofertas públicas (IPOs/subscrições) do investidor num intervalo. Paginado por `page`.
- b3_list_proventos_a_receber(data?: string, pagina?: integer, account?: string) — Proventos provisionados a receber (dividendos/JCP futuros) numa data de referência.
- b3_list_proventos_recebidos(dataInicio?: string, dataFim?: string, page?: integer, account?: string) — Proventos já recebidos (dividendos/JCP pagos) num intervalo de datas. Paginado.

## Example prompts
- "What's my total net worth on B3?"
- "Show my position by asset"
- "How much did I receive in dividends in the last 3 months?"

## Links
Docs: https://mcp.ai/docs/mcps/b3
Website: https://mcp.ai/mcps/b3