# mcp-pomelo

Connects your agent to Pomelo card issuing API across Latin America. It creates user identities, issues virtual or physical cards, and tracks transactions.

- 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/banking/pomelo
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-pomelo

## What it does

The server provides nine tools to interact with Pomelo services in Argentina, Brazil, Mexico, Colombia, Peru, and Chile. An assistant can register cardholder accounts, trigger virtual or physical Visa and Mastercard creation, toggle statuses such as `ACTIVE` or `BLOCKED`, and inspect transaction logs.

Running the package requires `POMELO_CLIENT_ID` and `POMELO_CLIENT_SECRET`. It handles OAuth2 client-credential authentication, caches tokens before expiry, and appends an `x-idempotency-key` header to mutating calls. The server targets the sandbox environment by default, with `POMELO_ENV` enabling production.

Card details like unmasked PAN or CVV codes are never returned because Pomelo serves them exclusively through isolated PCI widgets. Real-time swipe authorization decisions are handled outside this server through separate webhooks.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `POMELO_CLIENT_ID`, `POMELO_CLIENT_SECRET`, `POMELO_ENV`, `POMELO_BASE_URL`, `POMELO_AUTH_URL`, `POMELO_AUDIENCE` — 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 --env POMELO_CLIENT_ID=<POMELO_CLIENT_ID> --env POMELO_CLIENT_SECRET=<POMELO_CLIENT_SECRET> --env POMELO_ENV=<POMELO_ENV> --env POMELO_BASE_URL=<POMELO_BASE_URL> --env POMELO_AUTH_URL=<POMELO_AUTH_URL> --transport stdio pomelo -- npx -y @codespar/mcp-pomelo
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

**Platform CLI**
```bash
codex mcp add pomelo --env POMELO_CLIENT_ID=<POMELO_CLIENT_ID> --env POMELO_CLIENT_SECRET=<POMELO_CLIENT_SECRET> --env POMELO_ENV=<POMELO_ENV> --env POMELO_BASE_URL=<POMELO_BASE_URL> --env POMELO_AUTH_URL=<POMELO_AUTH_URL> -- npx -y @codespar/mcp-pomelo
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pomelo": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-pomelo"
            ],
            "env": {
                "POMELO_CLIENT_ID": "<POMELO_CLIENT_ID>",
                "POMELO_CLIENT_SECRET": "<POMELO_CLIENT_SECRET>",
                "POMELO_ENV": "<POMELO_ENV>",
                "POMELO_BASE_URL": "<POMELO_BASE_URL>",
                "POMELO_AUTH_URL": "<POMELO_AUTH_URL>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pomelo": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-pomelo"
            ],
            "env": {
                "POMELO_CLIENT_ID": "<POMELO_CLIENT_ID>",
                "POMELO_CLIENT_SECRET": "<POMELO_CLIENT_SECRET>",
                "POMELO_ENV": "<POMELO_ENV>",
                "POMELO_BASE_URL": "<POMELO_BASE_URL>",
                "POMELO_AUTH_URL": "<POMELO_AUTH_URL>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e POMELO_CLIENT_ID=<POMELO_CLIENT_ID> -e POMELO_CLIENT_SECRET=<POMELO_CLIENT_SECRET> -e POMELO_ENV=<POMELO_ENV> -e POMELO_BASE_URL=<POMELO_BASE_URL> -e POMELO_AUTH_URL=<POMELO_AUTH_URL> pomelo npx -y @codespar/mcp-pomelo
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- issue physical or virtual cards for registered users
- freeze or disable compromised cards
- query transaction feeds and payment details
- update cardholder contact and address information

## Example prompts
- Register a new cardholder and issue a virtual card for them
- Freeze the card with id `crd_12345`
- Fetch the latest transactions for cardholder `usr_98765`

## 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