Skip to main content
WO

Worldpay

v0.2.0-alpha.2API Keyalpha

Procesador enterprise global (Access Worldpay REST). Objetivo: multinacionales ruteando volumen de LatAm por un contrato global. Recién adquirida por Global Payments (ene/2026); estabilidad de la plataforma a confirmar. Alpha en npm — flujo HATEOAS linkData pendiente de validación en sandbox.

22 herramientas5 env vars🌐 GLOBALalpha — validación pendiente

Qué puede hacer tu agente

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

  • verify_accountRun an AVS/CVC account verification on a card without charging it. Returns the verification outcome and a card-on-file or one-time verification record. merchant.entity is injected automatically.
  • authorize_paymentAuthorize a card payment. Returns an outcome plus HATEOAS action links (settle, cancel, refund, reverse). Extract the linkData from those links and pass it to capture_payment / cancel_payment / refund_payment / reverse_payment.
  • capture_paymentCapture (settle) an authorized payment. Omit amount for a full settlement; pass amount+currency for a partial settlement. Pass linkData from the authorization's action link (_links.payments:settle.href segment) for HATEOAS-correct routing.
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("verify_account", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-worldpay@alpha

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": {
    "worldpay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-worldpay@alpha"
      ],
      "env": {
        "WORLDPAY_USERNAME": "<your_worldpay_username>",
        "WORLDPAY_PASSWORD": "<your_worldpay_password>",
        "WORLDPAY_ENTITY": "<your_worldpay_entity>"
      }
    }
  }
}

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

Variables de entorno · 5

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

WORLDPAY_USERNAME
obligatorio

Access Worldpay API username (Basic Auth)

WORLDPAY_PASSWORD
obligatoriosecret

Access Worldpay API password (Basic Auth)

WORLDPAY_ENTITY
obligatorio

Merchant entity identifier assigned during onboarding. Injected as merchant.entity into every request body.

WORLDPAY_ENV
opcional

sandbox | production. Defaults to sandbox. sandbox -> https://try.access.worldpay.com, production -> https://access.worldpay.com.

WORLDPAY_API_VERSION
opcional

Payments API version for the Content-Type/Accept media-type header. Defaults to v7.

Herramientas disponibles · 22

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

READverify_account
Run an AVS/CVC account verification on a card without charging it. Returns the verification outcome and a card-on-file or one-time verification record. merchant.entity is injected automatically.
WRITEauthorize_payment
Authorize a card payment. Returns an outcome plus HATEOAS action links (settle, cancel, refund, reverse). Extract the linkData from those links and pass it to capture_payment / cancel_payment / refund_payment / reverse_payment.
WRITEcapture_payment
Capture (settle) an authorized payment. Omit amount for a full settlement; pass amount+currency for a partial settlement. Pass linkData from the authorization's action link (_links.payments:settle.href segment) for HATEOAS-correct routing.
DELETEcancel_payment
Void an authorization that has not yet been captured. Pass linkData from _links.payments:cancel.href.
DELETErefund_payment
Refund a captured payment. Omit amount for a full refund; pass amount+currency for a partial refund. Pass linkData from _links.payments:refund.href or _links.payments:partialRefund.href.
DELETEreverse_payment
Reverse a payment atomically — voids if not yet captured, refunds if already captured. Pass linkData from _links.payments:reverse.href.
WRITEget_payment
Retrieve the detail of a payment event by its Worldpay eventId.
WRITEcreate_token
Tokenize a card for reuse (card-on-file). Returns a token you can pass as the paymentInstrument on subsequent authorizations.

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-worldpay` 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.
Worldpay — MCP server · 22 tools | CodeSpar