About mcp-efi
mcp-efi is an MCP server for EFI (formerly Gerencianet), covering Pix charges, boleto, credit card billing and carnets. It suits developers building Brazilian payment and billing flows through an MCP client. The README includes sandbox and credential setup steps.
Key features
- 01Immediate and due-date Pix charges
- 02Boleto and credit card billing
- 03Carnet payment booklets with multiple parcels
- 04Pix key, refund and webhook management
Use cases
- 01Generating carnets for installment payments
- 02Creating Pix charges and tracking payment status
- 03Managing Pix keys and webhook notifications
MCP support
This is an MCP server that exposes 18 tools to MCP clients for calling EFI charge, Pix and webhook endpoints.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
18Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| txid | string | No | Transaction ID (26-35 chars, alphanumeric) |
| chave | string | Yes | Pix key of the receiver |
| valor | object | Yes | Charge value |
| valor.original | string | Yes | Amount as string (e.g. '10.00') |
| devedor | object | No | Debtor info |
| devedor.cpf | string | No | Debtor CPF |
| devedor.nome | string | No | Debtor name |
| calendario | object | No | Expiration settings |
| calendario.expiracao | number | No | Expiration in seconds (default 3600) |
| solicitacaoPagador | string | No | Message to payer |
Details
From the project README@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 detailslist_locations— List Pix payload locationscreate_webhook— Register a webhook for Pix notificationsupdate_cob— Update an existing Pix charge
v0.3 (planned)
batch_charges— Create multiple charges in a single requestsplit_payments— Configure split payment rules
Want to contribute? Open a PR or request a tool.
Links
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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.