Mcp Efi

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for EFI (Gerencianet) — Pix, charges, carnets, cobranças

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.codespar/mcp-efi
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account codespar for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.codespar%2Fmcp-efi.svg)](https://sourceweft.com/mcp/io.github.codespar%2Fmcp-efi?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server for the EFI (Gerencianet) payment API, letting an assistant create and inspect Pix charges, boletos, carnets and webhooks.

What you can do: Create and look up immediate Pix charges (cob) by txid, and list charges by date range
Create and read billing charges (boleto or credit card) and multi-parcel carnets
Create, read and update Pix due charges (cobv), and request or inspect Pix refunds (devolução)
List received Pix transactions and manage Pix keys, including creating random EVP keys and deleting keys
Register, list and delete Pix webhooks for a key
When to use it: Useful when an assistant should work with a Brazilian EFI/Gerencianet merchant account: drafting Pix charges, checking payment status, issuing boletos or carnets, or handling refunds and webhook setup. Test against the sandbox first before touching live payments.
Requirements: Runs locally via npx (Node.js) over stdio. Needs an EFI Pay account and an OAuth2 application; the README sets EFI_CLIENT_ID and EFI_CLIENT_SECRET, and the manifest lists EFI_CLIENT_SECRET as a required secret. Optional EFI_SANDBOX=true switches to the sandbox. Network access to the EFI API is required.

Before you install

These tools move real money: they create charges, request Pix refunds, delete Pix keys and register or delete webhooks, so mistakes or prompt-injected calls can bill customers or alter payment routing. Credentials EFI_CLIENT_ID and EFI_CLIENT_SECRET are sent to EFI; keep them out of shared configs and prefer the sandbox while testing. The README also advertises a separate paid enterprise offering.

Installation

In SourceWeft

Open Mcp Efi in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-efi

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

[npm] [License: MIT]

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"      }    }  }}

{  "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

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"      }    }  }}

{  "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

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

Source: packages/payments/efi/README.md at commit d0a519a

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

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