Skip to main content
OP

Openpay

v0.2.1API Key

Gateway mexicano de BBVA — la alternativa MX a Conekta. Tarjetas, OXXO, SPEI, suscripciones (nativas), payouts de marketplace. Cierra la historia de los rieles BBVA para México.

23 herramientas3 env vars🇲🇽 Méxicoestable en npm

Qué puede hacer tu agente

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

  • create_chargeCreate a charge. Pass customer_id to charge at a customer scope (POST /customers/{customer_id}/charges); omit to charge at merchant scope (POST /charges). Methods: 'card' (requires source_id token), 'bank_account' (SPEI — returns CLABE reference), 'store' (OXXO — returns barcode/reference). Amounts are in major units (e.g. 100 = 100 MXN).
  • get_chargeRetrieve a charge. Pass customer_id to fetch at customer scope (GET /customers/{customer_id}/charges/{id}); omit for merchant scope (GET /charges/{id}).
  • capture_chargeCapture a previously authorized charge (when the original charge used capture=false). Pass amount to capture less than the authorized total; omit to capture the full authorized amount.
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_charge", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-openpay

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": {
    "openpay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-openpay"
      ],
      "env": {
        "OPENPAY_MERCHANT_ID": "<your_openpay_merchant_id>",
        "OPENPAY_PRIVATE_KEY": "<your_openpay_private_key>"
      }
    }
  }
}

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

Variables de entorno · 3

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

OPENPAY_MERCHANT_ID
obligatorio

Openpay merchant id (forms part of the API URL path)

OPENPAY_PRIVATE_KEY
obligatoriosecret

Openpay private API key (used as HTTP Basic auth username with empty password)

OPENPAY_ENV
opcional

Environment: 'sandbox' (default) or 'production'. Selects between https://sandbox-api.openpay.mx and https://api.openpay.mx.

Herramientas disponibles · 23

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

WRITEcreate_charge
Create a charge. Pass customer_id to charge at a customer scope (POST /customers/{customer_id}/charges); omit to charge at merchant scope (POST /charges). Methods: 'card' (requires source_id token), 'bank_account' (SPEI — returns CLABE reference), 'store' (OXXO — returns barcode/reference). Amounts are in major units (e.g. 100 = 100 MXN).
WRITEget_charge
Retrieve a charge. Pass customer_id to fetch at customer scope (GET /customers/{customer_id}/charges/{id}); omit for merchant scope (GET /charges/{id}).
WRITEcapture_charge
Capture a previously authorized charge (when the original charge used capture=false). Pass amount to capture less than the authorized total; omit to capture the full authorized amount.
DELETErefund_charge
Refund a captured charge. Supports partial refunds via amount; omit amount for a full refund.
WRITEcreate_customer
Create a customer record. Set requires_account=true to create an associated Openpay wallet for the customer; false for a payment-only record.
READget_customer
Retrieve a customer by Openpay customer id.
READlist_customers
List customers with optional filters. All parameters are passed as query params.
WRITEcreate_card
Tokenize a card. Pass customer_id to attach to a stored customer (POST /customers/{customer_id}/cards); omit for a merchant-level token (POST /cards). Prefer tokenizing client-side with Openpay.js to avoid PCI scope.

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-openpay` 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.
Openpay — MCP server · 23 tools | CodeSpar