Worldpay MCP

🚀 Simple Worldpay APIs MCP Server

This is a straightforward Worldpay APIs MCP (Model Context Protocol) server that implements the Model Context Protocol for creating and querying payments.

There are two versions of the server:

• server-stdio.js - A simple server using stdio transmission.
• server-sse.js - A server using SSE transmission.

The stdio version has been tested on Claude Desktop, and the sse version has been tested on Cursor.

✨ Features

Payment Creation

Payment Query

Generate Checkout Form

The generateCheckoutForm tool is used to quickly generate customized checkout form code for integrating Worldpay payment processing into applications. It supports both Web and React frameworks.

Parameters:

• checkoutId: Your Worldpay checkout ID.
• framework: The framework you are using (web or react).

Response:

The tool returns several content items:

• HTML/React component code.
• CSS style sheets.
• JavaScript initialization code (for the Web framework).

This provides everything needed to quickly implement a Worldpay checkout form in your application.

Generate Payment Server Code

The generatePaymentServerCode tool provides server - side code for processing payments through the Worldpay API. It generates code based on your specific payment method, instrument type, and programming language.

Parameters:

• method: Payment method (card, paypal).
• instrument: Instrument type (plain, session).
• language: Programming language (node, java).

Response:

The tool returns:

• Server - side implementation code.
• Example API responses for reference.

Currently, it supports processing card payments in Node.js using session tokens.

Generate Payment Query

The generatePaymentQuery tool provides documentation and examples for querying Worldpay's Payment Queries API. It helps you understand how to use various parameters to filter and retrieve payment data.

Parameters:

• startDate: The start date of the query range (in ISO 8601 format).
• endDate: The end date of the query range (in ISO 8601 format).
• pageSize: The maximum number of results to return (optional, default is 20).
• currency: Filter by currency code (optional).
• minAmount: Minimum payment amount (optional).
• maxAmount: Maximum payment amount (optional).
• last4Digits: The last 4 digits of the card number (optional).
• entityReferences: Merchant entity references (optional).
• receivedEvents: Payment event types (optional).

Response:

The tool returns:

• Comprehensive documentation on query parameters.
• Example API requests for different parameter combinations.
• Example API responses for reference.

📦 Installation

npm install

💻 Usage Examples

Build the Server Distribution

npm run build

Configuration

stdio

The MCP stdio server is configured using the claude_desktop_config.json file. This is a JSON file containing the MCP server configuration.

{
    "mcpServers": {
        "worldpay": {
            "name": "worldpay-server",
            "command": "node",
            "args": ["PATH TO server-stdio.js"],
            "env": {
                "WORLDPAY_USERNAME": "USERNAME",
                "WORLDPAY_PASSWORD": "PASSWORD"
            }
        }

sse

The SSE server is configured using environment variables.

export WORLDPAY_USERNAME=USERNAME
export WORLDPAY_PASSWORD=PASSWORD

Run the Server

stdio

Claude will automatically start the MCP stdio server.

sse

The command to run the SSE server is as follows:

node server-sse.js