Skip to main content
PO

Pomelo

v0.1.0OAuth2

Emisión de tarjetas como servicio pan-LATAM (Visa/Mastercard). Emite tarjetas virtuales o físicas, congela, define límites y autoriza cada transacción contra un mandato CodeSpar.

9 herramientas6 env vars🌎 LATAMestable en npm

Qué puede hacer tu agente

Pomelo le da a tu agente 9 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier cliente MCP.

  • create_userCreate 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_userFetch a user by id (GET /users/v1/{id}).
  • update_userPatch a user (PATCH /users/v1/{id}). Pass only the fields to change (e.g. status ACTIVE | BLOCKED, email, phone, address).
Ejemplo de llamada
// 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", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-pomelo

Quickstart

Agregá esta entrada a tu claude_desktop_config.json (o a la config de cualquier cliente compatible con MCP).

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

Después de reiniciar, tu agente puede llamar cualquiera de las 9 herramientas de abajo — probá create_user primero.

Variables de entorno · 6

Necesarias para autenticar el server. Almacenadas cifradas al usar el hosting gestionado de CodeSpar.

POMELO_CLIENT_ID
obligatoriosecret

OAuth2 client id

POMELO_CLIENT_SECRET
obligatoriosecret

OAuth2 client secret

POMELO_ENV
opcional

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

POMELO_BASE_URL
opcional

API base URL override. Defaults per environment.

POMELO_AUTH_URL
opcional

Auth base URL override. Defaults per environment.

POMELO_AUDIENCE
opcional

OAuth2 audience override. Defaults per environment.

Herramientas disponibles · 9

Cada herramienta es independiente — tu agente carga solo lo que necesita para reducir contexto y tiempo de respuesta.

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.

Frameworks compatibles

MCP es un protocolo — cualquier framework que lo hable puede montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Cualquier cliente MCPProtocolo

Preguntas frecuentes

Corré `npx -y @codespar/mcp-pomelo` y agregá el bloque de config de arriba a tu cliente MCP — Claude, Cursor, VS Code o cualquier cliente compatible con MCP. Sin build, sin SDK. ¿Preferís hosted? El tier gestionado de CodeSpar lo corre por vos, con la auth resuelta.
Pomelo — MCP server · 9 tools | CodeSpar