@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

Tool	Description
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)

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 Brasil
• 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