Skip to main content
PO

Pomelo

v0.1.0OAuth2

Pan-LATAM card issuing as a service (Visa/Mastercard). Issue virtual or physical cards, freeze, set limits, and authorize each swipe against a CodeSpar mandate.

9 tools6 env vars๐ŸŒŽ LATAMstable on npm

What your agent can do

Pomelo gives your agent 9 tools it calls directly โ€” pick the ones it needs, in Claude, Cursor, or any MCP client.

  • create_user โ€” Create a card-holder identity (POST /users/v1). The user is the person or business the card is issued to. Pass the Pomelo user shape for the target country (name, surname, identification_type/value, birthdate, address, email, phone).
  • get_user โ€” Fetch a user by id (GET /users/v1/{id}).
  • update_user โ€” Patch a user (PATCH /users/v1/{id}). Pass only the fields to change (e.g. status ACTIVE | BLOCKED, email, phone, address).
Example call
// Your agent calls a tool directly โ€” no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_user", { /* ... */ });

Install

terminal
$ npm install @codespar/mcp-pomelo

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json
{
  "mcpServers": {
    "pomelo": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-pomelo"
      ],
      "env": {
        "POMELO_CLIENT_ID": "<your_pomelo_client_id>",
        "POMELO_CLIENT_SECRET": "<your_pomelo_client_secret>"
      }
    }
  }
}

After restart, your agent can call any of the 9 tools below โ€” try create_user first.

Environment variables ยท 6

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

POMELO_CLIENT_ID
requiredsecret

OAuth2 client id

POMELO_CLIENT_SECRET
requiredsecret

OAuth2 client secret

POMELO_ENV
optional

Environment: 'sandbox' or 'production'. Defaults to 'sandbox'.

POMELO_BASE_URL
optional

API base URL override. Defaults per environment.

POMELO_AUTH_URL
optional

Auth base URL override. Defaults per environment.

POMELO_AUDIENCE
optional

OAuth2 audience override. Defaults per environment.

Available tools ยท 9

Each tool is independent โ€” your agent loads only what it needs to reduce context and response time.

WRITEcreate_user
Create a card-holder identity (POST /users/v1). The user is the person or business the card is issued to. Pass the Pomelo user shape for the target country (name, surname, identification_type/value, birthdate, address, email, phone).
READget_user
Fetch a user by id (GET /users/v1/{id}).
WRITEupdate_user
Patch a user (PATCH /users/v1/{id}). Pass only the fields to change (e.g. status ACTIVE | BLOCKED, email, phone, address).
WRITEcreate_card
Issue a card for a user (POST /cards/v1). card_type VIRTUAL is usable immediately; PHYSICAL enters embossing/shipping and must be activated on receipt. affinity_group_id selects the card program (BIN, art, limits) configured with Pomelo.
READget_card
Fetch a card by id (GET /cards/v1/{id}). Returns masked PAN, status, type and program data โ€” never full card credentials.
READlist_cards
List cards (GET /cards/v1), filterable by user and status. Paginated.
WRITEupdate_card_status
Change a card's lifecycle status (PATCH /cards/v1/{id}): ACTIVE to unblock/activate, BLOCKED to freeze, DISABLED to cancel permanently. status_reason is required by Pomelo for blocks (e.g. CLIENT_INTERNAL_REASON, LOST, STOLEN).
READlist_transactions
Search the card-transactions feed (GET /transactions/v1), filterable by card, user and time window. Paginated.

Compatible frameworks

MCP is a protocol โ€” any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

Run `npx -y @codespar/mcp-pomelo` and add the config block above to your MCP client โ€” Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Pomelo โ€” MCP server ยท 9 tools | CodeSpar