@codespar/mcp-efi (MCP Server)

This Model Context Protocol (MCP) server provides integrations for EFI (Gerencianet), covering Pix charges, boleto, credit card, and carnets/cobranças. It is distributed as the npm package @codespar/mcp-efi, intended for developer use with MCP-enabled clients such as Claude Desktop.

🛠️ Key Features

MCP server for EFI (Gerencianet)
Supports: Pix charges
Supports: boleto
Supports: credit card
Supports: carnets and cobranças
Topics include: payments, Pix, fintech, NFE, open finance, and Brazil

🚀 Use Cases

Create or manage payment flows via EFI for Pix, boleto, and credit card
Handle documents/collections referenced as carnets and cobranças
Integrate with MCP-based tooling for agentic commerce in Latin America

⚡ Developer Benefits

Works as an npm-delivered MCP server: @codespar/mcp-efi
Publish/consume with MCP clients (example shown for Claude Desktop)
Parameterization via environment variables (example includes EFI_CLIENT_ID)

⚠️ Limitations

Provided excerpt only shows the server scope and a Claude Desktop setup snippet; tool list and full capabilities are not included in the available data.

@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:

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

bash

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

Cursor / VS Code

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

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.

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

io.github.codespar/mcp-efi