convez.ai
MCP ServerIntegração & APIsIntermediário
gu-does-git

Pluggy MCP Server

gu-does-git/pluggy-mcp

Acesso Open Finance Brasil via MCP para Claude e LLMs

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta LLMs (Claude, Cursor, etc.) à API Pluggy de Open Finance Brasil, permitindo acesso a dados bancários, transações, investimentos e identidades através de 18 tools integrados. Baseado no trabalho da CodeSpar com extensões para investimentos e transações.

Instalação

$npx convez-ai gu-does-git/pluggy-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integração de dados bancários em assistentes de IA
  • Análise de transações e investimentos via LLM
  • Agregação de contas e extrato em aplicações inteligentes
  • Automação de consultas financeiras com credenciais seguras

Veredito

MCP server bem estruturado e produção-ready para Open Finance Brasil. Cobertura ampla da API Pluggy com autenticação OAuth2 segura e suporte nativo a Claude Desktop e Cursor. Documentação clara, setup simples via npx, e créditos mantidos ao trabalho original.

README

A tradução para o português deste README ainda está na fila.

@gu-does-packages/pluggy-mcp

Servidor MCP para Pluggy — agregador Open Finance Brasil (ITP/TPP).

Baseado no @codespar/mcp-pluggy por CodeSpar, estendido com funcionalidades adicionais.

Licença: MIT — mantém os créditos ao trabalho original da CodeSpar.

Setup

bun install

Quick Start

Via npx (recomendado)

```bash
npx @gu-does-packages/pluggy-mcp

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "pluggy": {
      "command": "npx",
      "args": ["@gu-does-packages/pluggy-mcp"],
      "env": {
        "PLUGGY_CLIENT_ID": "seu-client-id",
        "PLUGGY_CLIENT_SECRET": "seu-client-secret"
      }
    }
  }
}

Cursor / VS Code

Mesma configuração em .cursor/mcp.json ou no JSON de MCP do VS Code.

Autenticação

Pluggy usa OAuth2 client-credentials. Obtenha suas credenciais no dashboard da Pluggy.

VariávelObrigatórioDescrição
PLUGGY_CLIENT_IDsimClient ID do dashboard
PLUGGY_CLIENT_SECRETsimClient Secret do dashboard
PLUGGY_API_BASEnãoURL base da API (default https://api.pluggy.ai)

Sandbox

A Pluggy disponibiliza conectores sandbox (Pluggy Bank, BR · Pluggy Bank) que funcionam com o mesmo endpoint de produção. Use list_connectors com sandbox: true para listá-los.

Comandos

ComandoDescrição
bun run buildCompila para Node.js (dist/index.js)
bun run startRoda o servidor MCP (node dist/index.js)
bun run testRoda os testes automatizados
bun run inspectAbre o MCP Inspector (UI interativa no navegador)

Créditos

Este projeto é um fork estendido do @codespar/mcp-pluggy (MIT), mantendo toda a funcionalidade original dos 18 tools MCP para a API Pluggy. Agradecimentos à CodeSpar pelo trabalho base.

Extensões em relação ao original

  • list_investments — recupera todos os investimentos de um item (GET /investments)
  • get_investment — recupera um investimento específico por ID (GET /investments/{id})
  • list_investment_transactions — recupera todas as transações de um investimento (GET /investments/{id}/transactions)

Funcionalidades (18 tools)

ToolEndpoint PluggyDescrição
list_connectorsGET /connectorsLista conectores (bancos)
get_connectorGET /connectors/{id}Detalhes de um conector
list_categoriesGET /categoriesTaxonomia de categorias
create_connect_tokenPOST /connect_tokenToken para Pluggy Connect
create_itemPOST /itemsNova conexão bancária
get_itemGET /items/{id}Detalhes de uma conexão
update_itemPATCH /items/{id}Atualiza credenciais/sync
delete_itemDELETE /items/{id}Revoga conexão
list_accountsGET /accountsContas de um item
get_accountGET /accounts/{id}Detalhes de uma conta
list_transactionsGET /transactionsTransações de uma conta
get_transactionGET /transactions/{id}Detalhes de uma transação
list_identitiesGET /identityDados cadastrais (CPF, nome, endereço)
list_investmentsGET /investmentsInvestimentos de um item
get_investmentGET /investments/{id}Detalhes de um investimento
list_investment_transactionsGET /investments/{id}/transactionsTransações de um investimento
create_payment_intentPOST /payments/intentsInicia intent de pagamento
get_payment_intentGET /payments/intents/{id}Status do payment intent

Publicação

bun run build
npm publish

npx @gu-does-packages/pluggy-mcp funciona em qualquer máquina com Node.js instalado.

Licença

MIT — veja LICENSE.

Ver o original no GitHub

Bom para

Relacionados