# Banco MCP — MCP server on 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.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/banco?ms=1781685840000
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/openfinance/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/openfinance/<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/openfinance/skill.md
Postman collection (v2.1): https://mcp.ai/openfinance/postman.json

## Tools
- openfinance_search_bank_connectors(keywords: string[], include_accounts?: boolean) — Buscar conectores de banco (Open Finance/API) por nome
- openfinance_list_connections() — Listar bancos conectados
- openfinance_get_item_status(item?: string) — Status de uma conexão (UPDATED, LOGIN_ERROR…)
- openfinance_force_sync(items: string[]) — Forçar sincronização de uma ou mais conexões
- openfinance_disconnect_bank(item: string) — Revogar consentimento Open Finance de um banco
- openfinance_list_accounts(item?: string, type?: string) — Listar contas (BANK / CREDIT) de uma conexão
- openfinance_get_accounts_detail(account_ids: string[]) — Detalhe completo de contas por id (batch 1-50)
- openfinance_get_account_balance(account_ids: string[]) — Saldo em tempo real por conta (batch 1-50)
- openfinance_list_transactions(account_id: string, from?: string, to?: string, page?: number, page_size?: number, search_queries?: string[]) — Transações por conta (BANK ou CREDIT) com filtros de data/keyword
- openfinance_list_credit_card_bills(account_id: string, page?: number, page_size?: number) — Faturas de cartão (com payment_status derivado)
- openfinance_get_credit_card_bill(bill_ids: string[]) — Detalhe de fatura por id (batch 1-50)
- openfinance_list_investments(item?: string, type?: string, page?: number, page_size?: number) — Carteira de investimentos por conexão
- openfinance_list_investment_transactions(investment_id: string, page?: number, page_size?: number) — Movimentação de uma posição de investimento (BUY/SELL/TAX/…)
- openfinance_list_loans(items: string[]) — Contratos de empréstimo por conexão (batch)
- openfinance_list_categories() — Taxonomia de categorias de transação (Pluggy)
- openfinance_update_transaction_category(items: object[]) — Corrigir categoria de transações (cria regra automática)

## 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?"

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