@codespar/mcp-efi

@codespar/mcp-efi

MCP server for EFI (Gerencianet) — Pix charges, boleto, credit card, and carnets

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "efi": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-efi"],
      "env": {
        "EFI_CLIENT_ID": "your-client-id",
        "EFI_CLIENT_SECRET": "your-client-secret",
        "EFI_SANDBOX": "true"
      }
    }
  }
}

Claude Code

claude mcp add efi -- npx @codespar/mcp-efi

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "efi": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-efi"],
      "env": {
        "EFI_CLIENT_ID": "your-client-id",
        "EFI_CLIENT_SECRET": "your-client-secret",
        "EFI_SANDBOX": "true"
      }
    }
  }
}

Tools (18)

Tool	Purpose
create_cob	Create an immediate Pix charge (cobranca imediata)
get_cob	Get Pix charge details by txid
list_cobs	List Pix charges by date range
create_charge	Create a billing charge (boleto or credit card)
get_charge	Get charge details by ID
create_carnet	Create a carnet (payment booklet with multiple parcels)
get_pix_key	Get details of a registered Pix key
create_pix_evp	Create a random Pix key (EVP/alias)
create_cobv	Create a Pix due charge (cobranca com vencimento).
get_cobv	Get Pix due charge (cobv) details by txid
update_cobv	Update an existing Pix due charge (cobv) by txid
create_devolucao	Request a Pix devolution (refund) on a received Pix transaction
get_devolucao	Get details of a Pix devolution by e2eId and devolution id
list_pix_received	List received Pix transactions (recebidos) by date range
delete_pix_key	Delete a registered Pix key (DICT)
register_webhook	Register a webhook URL for a given Pix key
list_webhooks	List registered webhooks by date range
delete_webhook	Delete the webhook registered for a Pix key

Authentication

EFI uses OAuth2 client credentials. The server automatically manages token refresh.

Sandbox / Testing

EFI provides a sandbox at pix-h.api.efipay.com.br. Set EFI_SANDBOX=true to use it.

Get your credentials

• Go to EFI Pay Dashboard
• Create an account
• Register an application to get OAuth2 credentials
• Set the environment variables

Environment Variables

Variable	Required	Description
EFI_CLIENT_ID	Yes	OAuth2 client ID
EFI_CLIENT_SECRET	Yes	OAuth2 client secret
EFI_SANDBOX	No	Set to "true" for sandbox mode

Roadmap

v0.2 (planned)

• create_devolucao — Create a Pix refund (devolucao)
• get_devolucao — Get Pix refund details
• list_locations — List Pix payload locations
• create_webhook — Register a webhook for Pix notifications
• update_cob — Update an existing Pix charge

v0.3 (planned)

• batch_charges — Create multiple charges in a single request
• split_payments — Configure split payment rules

Want to contribute? Open a PR or request a tool.

Links

• EFI Pay Website
• Gerencianet API Documentation
• MCP Dev LATAM
• Landing Page

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT