MCP Server

Maintained

MIT

Banco MCP MCP Server

io.github.douglac/banco-mcp

Connect 30+ Brazilian banks (Itaú, Nubank, etc.) to Claude/Cursor for read-only financial insights in natural language.

What is the Banco MCP MCP server?

Banco MCP is a Brazilian Open Finance MCP server that connects 30+ banks to Claude, Cursor, and AI agents. It provides read-only access to accounts, transactions, investments, loans, and credit card statements through 13 tools, regulated by Brazil's Central Bank.

Banco MCP lets you ask your AI agent about your spending, account balances, investments, and credit card bills across multiple Brazilian banks in natural language. It's read-only, LGPD-compliant, and works with any MCP-compatible client. Connect via magic-link in 30 seconds and get instant financial insights without sharing passwords.

How to install Banco MCP

Copy-paste configuration for popular MCP clients.

transport: http

Config generated by PluginBench — verify against the source before use.

~/.cursor/mcp.json

{
  "mcpServers": {
    "banco-mcp": {
      "url": "https://api.mcp.ai/banco"
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

openfinance_list_connections — Lists connected banks
openfinance_get_item_status — Synchronization status of a connection
openfinance_list_accounts — Checking, savings, and credit card accounts
openfinance_get_accounts_detail — Full account details including limits and additional cards
openfinance_get_account_balance — Real-time account balance
openfinance_list_transactions — Transaction history with date and keyword filters
openfinance_list_credit_card_bills — Credit card bills with payment status
openfinance_get_credit_card_bill — Detailed view of a single bill
openfinance_list_investments — Investment portfolio: REITs, stocks, fixed income, funds, retirement accounts
openfinance_list_investment_transactions — Transactions for a specific investment
openfinance_list_loans — Loan contracts
openfinance_list_categories — Transaction category taxonomy
openfinance_force_sync — Force immediate synchronization
openfinance_disconnect_bank — Remove connection and revoke consent

Use cases

Ask how much you spent on restaurants and groceries this month across all accounts
Review your latest 20 transactions or summarize open credit card bills
Check your investment portfolio breakdown (stocks vs fixed income vs REITs)
Detect recurring expenses over the last 6 months
Compare this month's credit card bill with last month's

Banco MCP MCP server FAQ

What is Banco MCP?

Banco MCP connects your Brazilian bank accounts (30+ supported) to Claude, Cursor, or any MCP client. You ask questions in natural language about spending, balances, investments, and loans. It's read-only and regulated by Brazil's Central Bank via Open Finance.

Can the AI move money or make transfers?

No. Banco MCP is 100% read-only. Open Finance is regulated by Brazil's Central Bank and does not permit write operations. None of the 13 tools can move funds.

Is it free?

Free trial includes 10 questions per 24 hours. Paid plans start at R$19.90/month (1 bank) to R$49.90/month (5 banks + extras). Cancel anytime with no fees.

How do I install it in Claude or Cursor?

Claude: go to claude.ai/customize/connectors, click +, add custom connector with name 'Banco MCP' and URL 'https://api.mcp.ai/banco'. Cursor: use the deeplink in the README. On first use, you'll authenticate via magic-link and connect your banks.

Which banks are supported?

All major Brazilian banks in Open Finance (Itaú, Bradesco, Santander, Banco do Brasil, Caixa, Nubank, Inter, C6, and 20+ others). Full list available via the openfinance_list_connections tool.

Is my data used to train AI?

Not by Banco MCP. Data is sent to your chosen LLM host (Claude, ChatGPT, etc.) — their privacy policy applies. We recommend enabling training opt-out with your LLM provider.

README (reference)

Source of truth, from the repository.

Banco MCP

Open Finance brasileiro para Claude, Cursor e agentes de IA

Conecte Itaú, Bradesco, Santander, Nubank, Inter, Banco do Brasil, Caixa, C6 e mais 25 bancos ao seu agente de IA. Pergunte sobre seus gastos, extratos, investimentos e cartões em linguagem natural. Open Finance regulado pelo Banco Central, em 30 segundos.

🇧🇷 30+ bancos brasileiros suportados
💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
🔒 Somente leitura — a IA não pode movimentar dinheiro
📊 13 ferramentas: extrato, saldos, faturas, investimentos, empréstimos
⚡ Open Finance regulado pelo Banco Central do Brasil
🛡️ LGPD-compliant — consentimento explícito, retenção mínima

English version · Documentação completa · Skills do Claude Code

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 na sua conta):

➕ Abrir no Claude e conectar

Esse link abre o modal "Adicionar conector personalizado" já com nome (Banco MCP) e URL (https://api.mcp.ai/banco) pré-preenchidos. Clique Adicionar, faça login via magic-link na primeira chamada, conecte seus bancos.

Manual (se o deeplink não abrir): vá em claude.ai/customize/connectors → clique + → Adicionar conector personalizado → cole:

Nome: Banco MCP
URL: https://api.mcp.ai/banco

Cursor

➕ Instalar Banco MCP no Cursor

VS Code (Copilot Chat)

➕ Instalar Banco MCP no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Banco MCP funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre a mesma:

https://api.mcp.ai/banco

Veja INSTALL.md pra exemplos de configuração por cliente, ou banco.mcp.ai pra instruções visuais.

Instruções detalhadas: INSTALL.md — config manual em arquivo (claude_desktop_config.json, .cursor/mcp.json, .vscode/mcp.json), fluxo agent-auth pra clientes sem OAuth, troubleshooting, e instruções pra IA te ajudar a instalar.

Pergunte sobre seu dinheiro

Depois de conectar pelo menos 1 banco, faça perguntas como:

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?
Quais foram meus maiores gastos no último trimestre?
Compara minha fatura desse mês com a do mês passado
Quanto tenho em renda fixa vs ações?
Detecta gastos recorrentes nos últimos 6 meses

13 ferramentas disponíveis

Tool	Descrição
`openfinance_list_connections`	Lista bancos conectados
`openfinance_get_item_status`	Status de sincronização de uma conexão
`openfinance_list_accounts`	Contas correntes, poupanças e cartões
`openfinance_get_accounts_detail`	Detalhe completo (limites, cartões adicionais)
`openfinance_get_account_balance`	Saldo em tempo real
`openfinance_list_transactions`	Extrato com filtros de data e keywords
`openfinance_list_credit_card_bills`	Faturas de cartão com `payment_status` derivado
`openfinance_get_credit_card_bill`	Detalhe de uma fatura
`openfinance_list_investments`	Carteira: FIIs, ações, renda fixa, fundos, previdência
`openfinance_list_investment_transactions`	Movimentações de um investimento
`openfinance_list_loans`	Contratos de empréstimo
`openfinance_list_categories`	Taxonomia de categorias
`openfinance_force_sync`	Força sincronização imediata
`openfinance_disconnect_bank`	Remove conexão e revoga consentimento

Documentação detalhada de cada tool: docs/ferramentas.md

Bancos suportados

Open Finance Brasil cobre as principais instituições:

Bancos digitais: Nubank, Inter, C6 Bank, Next, Neon, Original, BMG, PicPay, Mercado Pago, Pan

Bancos tradicionais: Itaú, Bradesco, Santander, Banco do Brasil, Caixa Econômica, Safra, Sicoob, Sicredi

Corretoras: XP, Rico, Clear, BTG Pactual, Inter Investimentos, Nu Invest, ÓRAMA

Crédito: Will Bank, Méliuz, Ame, Renner Card

E mais. Lista completa via tool openfinance_list_connections (mostra apenas os disponíveis pra você conectar).

Como funciona

1. Você instala o MCP no seu cliente (Claude/Cursor/VS Code)
2. Na primeira pergunta, browser abre pra magic-link
3. Você cria conta (só e-mail, sem senha) e conecta bancos via Open Finance
4. Concede consentimento Open Finance (somente leitura, revogável)
5. Pronto — perguntas em linguagem natural

Detalhe técnico: docs/instalacao.md · docs/autenticacao.md

Skill pra agentes de IA

Uma skill geral que cobre todos os casos de uso do Banco MCP — análise de gastos, extrato mensal, fluxo de caixa, fatura de cartão, carteira de investimentos, saldos, empréstimos. Funciona em Claude Code, Cursor, Codex, OpenCode e outros 50+ agentes suportados pelo ecossistema skills.sh.

Instalar via skills.sh (recomendado)

# detecta seu agente automaticamente e instala no diretório certo
npx skills add douglac/banco-mcp

# ou instala globalmente (todos os projetos)
npx skills add douglac/banco-mcp -g

# pra um agente específico
npx skills add douglac/banco-mcp -a claude-code

Instalar manualmente (Claude Code)

cp -r skills/banco-mcp ~/.claude/skills/

📁 Conteúdo da skill: skills/banco-mcp/SKILL.md

Depois é só perguntar coisas como "Quanto gastei esse mês?" ou "Como está minha carteira de investimentos?" — a skill ativa automaticamente e orquestra as 13 tools do Banco MCP.

Preços

Plano	Preço	Bancos	Perguntas
Free trial	R$ 0	Ilimitadas	10 / 24h
PF Solo	R$ 19,90/mês	1	Ilimitadas
PF Plus	R$ 29,90/mês	3	Ilimitadas
PF Ilimitado ⭐	R$ 49,90/mês	5 + R$9/extra	Ilimitadas
PJ Ilimitado	R$ 99,90/mês	4 + R$19,90/extra	Ilimitadas

Detalhamento: docs/precos.md. Cancela quando quiser, sem taxa.

Privacidade & LGPD

Somente leitura (regulado pelo Banco Central via Open Finance)
Consentimento explícito por banco, revogável a qualquer momento
Retenção mínima: dados apagados em 30 dias após desconectar
Sub-processadores: agregador Open Finance autorizado pelo BACEN, instituições financeiras conectadas, LLM host que você escolher
Você no controle: desconectar bancos, exportar dados, excluir conta

Política completa: docs/privacidade-lgpd.md

⚠️ Atenção: os dados retornados pelas tools são enviados ao LLM host que você escolher (Anthropic / OpenAI / Cursor / agente próprio). Esse provedor é sub-processador fora do nosso controle. Recomendamos contratar planos com opt-out de treinamento ativado.

Perguntas frequentes

A IA pode mover dinheiro ou fazer transferência? Não. 100% somente leitura. Open Finance é regulado pelo Banco Central e não permite operações de movimentação por essa via. Nenhuma das 13 tools faz writes.

Meus dados são usados pra treinar IA? Não pela gente. Os dados vão pro LLM host que você escolher (Claude, ChatGPT, etc.) — política de treinamento é responsabilidade do provedor de IA. Recomendamos opt-out.

Quais bancos são suportados? Todos integrados ao Open Finance Brasil + bancos digitais via credenciais. Veja seção "Bancos suportados" acima.

Como cancelo? app.mcp.ai/banco → Settings → Assinatura → Cancelar. Encerra no fim do ciclo, sem taxa.

E se um banco não tiver Open Finance? A maioria dos bancos no Brasil já está no Open Finance. Alguns bancos digitais menores podem usar fallback via credenciais diretas — a conexão funciona mas pode ser menos estável.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. Veja INSTALL.md seção "Outros clientes".

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT. PRs e contribuições nas docs/skills são bem-vindas.

Contribuindo

Issues, PRs e sugestões são bem-vindas. Especialmente:

Traduções de docs/skills (EN ✓, ES, FR, IT)
Novas skills do Claude Code
Snippets de instalação pra clientes MCP novos
Correções/melhorias na documentação

Por favor leia SECURITY.md antes de abrir issue com algo relacionado a segurança.

Suporte

📧 banco@mcp.ai — dúvidas, sugestões, parcerias
🐛 GitHub Issues — bugs e features
📄 docs/ — documentação completa em PT-BR

Licença

AI task cockpit: an agent does your tasks and asks before anything irreversible.

MIT

View repository →

Letterbox

File-based comms protocol for AI-to-AI dialogue between terminal agents.

View repository →