# Banco MCP — how to use (mcp.ai)

Agrega dados bancários (saldos, faturas e extratos) via Open Finance Brasil. Cada instituição vira uma conexão; múltiplos bancos por usuário ficam em credentials.connections[]. Leitura apenas.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/banco?ms=1781045040000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `openfinance_search_bank_connectors`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/openfinance`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/openfinance/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/openfinance/connectors/search` — Buscar conectores de banco (Open Finance/API) por nome
  - body: { keywords: string[], include_accounts?: boolean }
- `POST https://api.mcp.ai/api/openfinance/connections/list` — Listar bancos conectados
- `POST https://api.mcp.ai/api/openfinance/connections/status` — Status de uma conexão (UPDATED, LOGIN_ERROR…)
  - body: { item?: string }
- `POST https://api.mcp.ai/api/openfinance/connections/sync` — Forçar sincronização de uma ou mais conexões
  - body: { items: string[] }
- `POST https://api.mcp.ai/api/openfinance/connections/disconnect` — Revogar consentimento Open Finance de um banco
  - body: { item: string }
- `POST https://api.mcp.ai/api/openfinance/accounts/list` — Listar contas (BANK / CREDIT) de uma conexão
  - body: { item?: string, type?: string }
- `POST https://api.mcp.ai/api/openfinance/accounts/detail` — Detalhe completo de contas por id (batch 1-50)
  - body: { account_ids: string[] }
- `POST https://api.mcp.ai/api/openfinance/accounts/balance` — Saldo em tempo real por conta (batch 1-50)
  - body: { account_ids: string[] }
- `POST https://api.mcp.ai/api/openfinance/transactions/list` — Transações por conta (BANK ou CREDIT) com filtros de data/keyword
  - body: { account_id: string, from?: string, to?: string, page?: number, page_size?: number, search_queries?: string[] }
- `POST https://api.mcp.ai/api/openfinance/credit-card-bills/list` — Faturas de cartão (com payment_status derivado)
  - body: { account_id: string, page?: number, page_size?: number }
- `POST https://api.mcp.ai/api/openfinance/credit-card-bills/detail` — Detalhe de fatura por id (batch 1-50)
  - body: { bill_ids: string[] }
- `POST https://api.mcp.ai/api/openfinance/investments/list` — Carteira de investimentos por conexão
  - body: { item?: string, type?: string, page?: number, page_size?: number }
- `POST https://api.mcp.ai/api/openfinance/investments/transactions/list` — Movimentação de uma posição de investimento (BUY/SELL/TAX/…)
  - body: { investment_id: string, page?: number, page_size?: number }
- `POST https://api.mcp.ai/api/openfinance/loans/list` — Contratos de empréstimo por conexão (batch)
  - body: { items: string[] }
- `POST https://api.mcp.ai/api/openfinance/categories/list` — Taxonomia de categorias de transação (Pluggy)
- `POST https://api.mcp.ai/api/openfinance/transactions/category` — Corrigir categoria de transações (cria regra automática)
  - body: { items: object[] }

## Example prompts
- "Quanto gastei esse mês com restaurantes e mercado?"
- "Liste minhas últimas 20 transações em todas as contas"
- "Resuma minhas faturas de cartão em aberto"
- "Como está minha carteira de investimentos hoje?"

## More
- Page: https://mcp.ai/openfinance
- Agent spec (llms.txt): https://mcp.ai/openfinance/llms.txt
- Postman collection: https://mcp.ai/openfinance/postman.json