Worldpay

What your agent can do

Worldpay gives your agent 22 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →verify_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.
• →authorize_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.
• →capture_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.

// 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", { /* ... */ });

Install

$ npm install @codespar/mcp-worldpay@alpha

Quickstart

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

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

After restart, your agent can call any of the 22 tools below — try verify_account first.

Environment variables · 5

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

Available tools · 22

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

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions