Open Finance Plugin MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Open Finance Plugin MCP quanto gastei por categoria no mês passado?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Open Finance Plugin MCP
Servidor MCP (Model Context Protocol) somente leitura que expõe os seus próprios dados financeiros do Open Finance Brasil, via Meu Pluggy, para clientes MCP como Claude Code, Claude Desktop e Cursor.
Existe porque o Meu Pluggy é gratuito para uma pessoa acessar as próprias contas pela API (até 5 conexões do mesmo titular, conforme pluggy.ai/meu-pluggy), mas o MCP oficial tem só duas ferramentas (contas de um item e lista de conectores) e não é atualizado desde junho de 2025.
O que ele não faz
Não move dinheiro. Não existe PIX, transferência, pagamento nem alteração de
dados. O único POST do código é o /auth que obtém a apiKey, e um teste
falha se aparecer outro método de escrita. Todas as ferramentas são marcadas
como readOnlyHint.
Não armazena nada: cada chamada consulta a API e devolve o resultado ao cliente MCP. Os dados continuam armazenados na Pluggy, que é a intermediária regulada.
Related MCP server: PicPay MCP
Ferramentas
Ferramenta | O que devolve |
| Banco (deduzido pelo código COMPE da conta corrente, já que o conector é sempre "MeuPluggy"), status, última atualização e validade do consentimento de cada item |
| Contas correntes, poupanças e cartões, com saldo |
| Saldo de uma conta, como o banco informou na última sincronização (vem de |
| Transações por período ( |
| Faturas de cartão: vencimento, fechamento, total, pagamento mínimo |
| Posições de investimento de todas as conexões |
| Soma das saídas por categoria e moeda no período |
Convenções:
tipoDEBITé dinheiro que saiu eCREDITé dinheiro que entrou, tanto na conta quanto no cartão.Compra em moeda estrangeira usa o valor convertido para a moeda da conta.
Em
gastos_por_categoria, o pagamento da fatura na conta corrente e as compras no cartão representam o mesmo gasto. Useignorar_categoriaspara tirar o pagamento de fatura e as transferências entre contas próprias.
Pré-requisitos
Conta no Meu Pluggy com os bancos conectados.
Conta no Dashboard Pluggy, com uma aplicação criada. Dela saem o Client ID e o Client Secret.
Na aplicação, uma conexão com o conector MeuPluggy para cada banco. Não use o conector do banco nem o Sandbox. Cada conexão tem um
itemId.Python 3.12 e uv.
O passo a passo oficial está em pluggy.ai/meu-pluggy.
Configuração
Tudo por variável de ambiente. Nada de segredo em arquivo do repositório.
Variável | Conteúdo |
| Client ID da aplicação |
| Client Secret da aplicação |
| itemIds separados por vírgula (a API não lista itens) |
Exemplo para Claude Code (.mcp.json), lendo as variáveis do ambiente em que o
cliente foi aberto:
{
"mcpServers": {
"pluggy": {
"command": "uv",
"args": ["run", "--directory", "/caminho/para/pluggy-mcp", "pluggy-mcp"],
"env": {
"PLUGGY_CLIENT_ID": "${PLUGGY_CLIENT_ID}",
"PLUGGY_CLIENT_SECRET": "${PLUGGY_CLIENT_SECRET}",
"PLUGGY_ITEM_IDS": "${PLUGGY_ITEM_IDS}"
}
}
}
}Desenvolvimento
uv sync
uv run pytestOs testes simulam a API da Pluggy com um transporte falso e dados sintéticos. Nenhum teste faz chamada de rede nem precisa de credencial.
Estrutura:
src/pluggy_mcp/cliente.py: cliente HTTP da API. Faz a autenticação com renovação da apiKey (validade de 2 h), a paginação por página e por cursor, e aceita um transporte injetável.src/pluggy_mcp/servidor.py: as ferramentas MCP e a normalização dos campos.
Licença
MIT.
Available Tools
7 toolsfaturasBRead-onlyIdempotent
Faturas de cartao de credito. Sem conta_id, traz de todos os cartoes.
Inputs: conta_id. Returns: result
gastos_por_categoriaARead-onlyIdempotent
Soma das saidas (DEBIT) por categoria e moeda no periodo, da maior para a menor. Use ignorar_categorias para tirar transferencias entre contas proprias e pagamento de fatura, que senao contam o mesmo gasto duas vezes.
Inputs: desde (required), ate, ignorar_categorias. Returns: result
investimentosBRead-onlyIdempotent
Posicoes de investimento de todas as conexoes.
Inputs: no named parameters. Returns: result
listar_conexoesCRead-onlyIdempotent
Conexoes (itens) configuradas: banco, status e data da ultima atualizacao.
Inputs: no named parameters. Returns: result
listar_contasBRead-onlyIdempotent
Contas correntes, poupancas e cartoes de credito, com o saldo informado pelo banco.
Inputs: no named parameters. Returns: result
saldoBRead-onlyIdempotent
Saldo atual de uma conta, como o banco informou na ultima sincronizacao.
Inputs: conta_id (required).
transacoesARead-onlyIdempotent
Transacoes no periodo (datas AAAA-MM-DD). Sem conta_id, traz de todas as contas. tipo DEBIT = dinheiro saiu; CREDIT = entrou.
Inputs: desde (required), ate, conta_id. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool maps to a distinct resource or view (connections, accounts, balance, transactions, invoices, investments, spend-by-category), and the aggregation tool is clearly separated from raw transactions. The only mild overlap is saldo versus listar_contas, since the account list already includes bank-reported balances, but the descriptions distinguish a single-account lookup from a full listing.
All names are lowercase snake_case in Portuguese, which is readable, but the convention is mixed: listar_conexoes and listar_contas are verb_noun, while saldo, transacoes, faturas and investimentos are bare nouns, and gastos_por_categoria is a noun-phrase aggregation name. There is a discernible theme but no single predictable pattern.
Seven tools is a well-scoped surface for a read-only Open Finance data plugin, with each tool covering a distinct data domain. Nothing appears redundant or missing at the count level.
The surface covers the core read-only domain: connections, accounts, balances, transactions, credit card invoices, investments and a spending aggregation. Minor gaps exist, such as no income-by-category or per-transaction detail tool, but an agent can work around these using the existing period queries.
Maintenance
Related MCP Connectors
Brazilian Open Finance MCP — 30+ banks (Itaú, Nubank, etc.) to Claude/Cursor. Read-only.
Read-only access to your own bank, card and brokerage accounts for Claude, ChatGPT and other AI agents: balances, transactions, spending, subscriptions, cashflow and investment holdings. It can never move money.
Read-only access to your bank, investment, and crypto accounts: balances, transactions, holdings.
Ask your AI about Brazilian bank spending. Read-only bank access, never moves money. Paid plan.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceRead-only MCP server for connecting to Pluggy Open Finance Brasil, exposing accounts, balances, transactions, and investments to Claude agents.-
- AlicenseNot gradedqualityDmaintenanceConnect your PicPay account to Claude, ChatGPT, and AI agents via Open Finance Brazil to query balances, statements, credit card bills, and investments in natural language. Read-only.MIT
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server exposing Brazilian Open Finance personal financial data from Pluggy to MCP clients, enabling listing of connections, accounts, transactions, credit card bills, investments, and loans without moving money.4MIT
- FlicenseBqualityCmaintenanceProvides read-only access to personal financial data via Pluggy, including accounts, transactions, investments, credit cards, and aggregations like total balance, monthly expenses, and net worth.18-