mcp-pomelo — Claude Code MCP server: what it does, how to install
Connects your agent to Pomelo card issuing API across Latin America. It creates user identities, issues virtual or physical cards, and tracks transactions.
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-pomeloWhat mcp-pomelo 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.
What it helps with
- 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 for the agent
- 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
How to install mcp-pomelo
Platform CLI
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-pomeloReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
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-pomeloReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"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
Config file
{
"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
Platform CLI
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-pomeloReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-pomelo
How do I install mcp-pomelo in Claude Code?
Run claude mcp add mcp-pomelo -e POMELO_CLIENT_ID=<POMELO_CLIENT_ID> -e POMELO_CLIENT_SECRET=<POMELO_CLIENT_SECRET> -- npx -y @codespar/mcp-pomelo using your OAuth2 credentials.
What does mcp-pomelo do?
It provides an MCP interface to Pomelo card issuing infrastructure. Agents can create user records, manage card lifecycles, and retrieve transaction data across supported Latin American countries.
Can mcp-pomelo view full PAN numbers or CVV codes?
No, the server returns only masked card numbers. Unmasked PAN and CVV values are restricted to Pomelo PCI-compliant widgets.
