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: Méliuz MCP

Ferramentas

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.

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.