# mcp-efi

This MCP server connects EFI (Gerencianet) to an AI agent for Pix, boleto, card charges, and carnets.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/efi
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-efi

## What it does

mcp-efi exposes EFI payment operations to an agent. It can create and inspect Pix charges, issue boleto or credit-card charges, create carnets with multiple instalments, and manage Pix keys, refunds, and webhooks. The package provides 18 tools.

Authentication uses OAuth2 client credentials, with token renewal handled by the server. Set `EFI_CLIENT_ID` and `EFI_CLIENT_SECRET` before connecting it; `EFI_SANDBOX=true` selects the sandbox environment. Without those credentials, authentication will fail. The server is listed for Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `EFI_CLIENT_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-efi -e EFI_CLIENT_SECRET=<EFI_CLIENT_SECRET> -- npx -y @codespar/mcp-efi
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add efi --env EFI_CLIENT_SECRET=<EFI_CLIENT_SECRET> -- npx -y @codespar/mcp-efi
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "efi": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-efi"
            ],
            "env": {
                "EFI_CLIENT_SECRET": "<EFI_CLIENT_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "efi": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-efi"
            ],
            "env": {
                "EFI_CLIENT_SECRET": "<EFI_CLIENT_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e EFI_CLIENT_SECRET=<EFI_CLIENT_SECRET> efi npx -y @codespar/mcp-efi
```
Replace <…> with your own values

## When to use it
- create an immediate Pix charge
- look up a charge by txid
- issue a boleto or card charge
- make a carnet with several instalments
- register a webhook for a Pix key

## Example prompts
- Create an immediate Pix charge with `create_cob` and return its identifier.
- Look up the Pix charge for this txid using `get_cob`.
- Create a payment carnet with several instalments through `create_carnet`.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md