Skip to main content
WO

Worldpay

v0.2.0-alpha.2API Keyalpha

Processador enterprise global (Access Worldpay REST). Alvo: multinacionais roteando volume da LatAm por um contrato global. Recém-adquirida pela Global Payments (jan/2026); estabilidade da plataforma a confirmar. Alpha no npm — fluxo HATEOAS linkData pendente de validação em sandbox.

22 ferramentas5 env vars🌐 GLOBALalpha — validação pendente

O que seu agente faz

O Worldpay dá ao seu agente 22 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer 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.
Exemplo de chamada
// 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

Adicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com 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>"
      }
    }
  }
}

Depois de reiniciar, seu agente pode chamar qualquer uma das 22 ferramentas abaixo — teste verify_account primeiro.

Variáveis de ambiente · 5

Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.

WORLDPAY_USERNAME
obrigatório

Access Worldpay API username (Basic Auth)

WORLDPAY_PASSWORD
obrigatóriosecret

Access Worldpay API password (Basic Auth)

WORLDPAY_ENTITY
obrigatório

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.

Ferramentas disponíveis · 22

Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.

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 compatíveis

MCP é um protocolo — qualquer framework que o fale pode montar este server.

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

Perguntas frequentes

Rode `npx -y @codespar/mcp-worldpay` e adicione o bloco de config acima ao seu cliente MCP — Claude, Cursor, VS Code ou qualquer cliente compatível com MCP. Sem build, sem SDK. Prefere hospedado? O tier gerenciado da CodeSpar roda pra você, com a auth resolvida.
Worldpay — MCP server · 22 tools | CodeSpar