Skip to main content
Glama
Open Finance Plugin MCP

Open Finance Plugin MCP

by Moreti2002

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

listar_conexoes

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

listar_contas

Contas correntes, poupanças e cartões, com saldo

saldo

Saldo de uma conta, como o banco informou na última sincronização (vem de /accounts/{id}; o /balance não atende itens MeuPluggy)

transacoes

Transações por período (desde, ate), de uma conta ou de todas

faturas

Faturas de cartão: vencimento, fechamento, total, pagamento mínimo

investimentos

Posições de investimento de todas as conexões

gastos_por_categoria

Soma das saídas por categoria e moeda no período

Convenções:

  • tipo DEBIT é dinheiro que saiu e CREDIT é 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. Use ignorar_categorias para tirar o pagamento de fatura e as transferências entre contas próprias.

Pré-requisitos

  1. Conta no Meu Pluggy com os bancos conectados.

  2. Conta no Dashboard Pluggy, com uma aplicação criada. Dela saem o Client ID e o Client Secret.

  3. 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.

  4. 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

PLUGGY_CLIENT_ID

Client ID da aplicação

PLUGGY_CLIENT_SECRET

Client Secret da aplicação

PLUGGY_ITEM_IDS

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 pytest

Os 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 tools
faturasB
Read-onlyIdempotent

Faturas de cartao de credito. Sem conta_id, traz de todos os cartoes.

Inputs: conta_id. Returns: result

gastos_por_categoriaA
Read-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

investimentosB
Read-onlyIdempotent

Posicoes de investimento de todas as conexoes.

Inputs: no named parameters. Returns: result

listar_conexoesC
Read-onlyIdempotent

Conexoes (itens) configuradas: banco, status e data da ultima atualizacao.

Inputs: no named parameters. Returns: result

listar_contasB
Read-onlyIdempotent

Contas correntes, poupancas e cartoes de credito, com o saldo informado pelo banco.

Inputs: no named parameters. Returns: result

saldoB
Read-onlyIdempotent

Saldo atual de uma conta, como o banco informou na ultima sincronizacao.

Inputs: conta_id (required).

transacoesA
Read-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

    B3.4/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Read-only MCP server for connecting to Pluggy Open Finance Brasil, exposing accounts, balances, transactions, and investments to Claude agents.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connect 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      4
      MIT
    • F
      license
      B
      quality
      C
      maintenance
      Provides 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
      -