Worldpay MCP Server

Introduction

This is a simple MCP server for Worldpay APIs.

It implements the Model Context Protocol to make and query payments.

There are two versions of the server:

• server-stdio.js - a simple server that uses the stdio transport.
• server-sse.js - a server that uses the SSE transport.

The stdio version has been tested using Claude Desktop.

The sse version has been tested using Cursor.

Tools

Make Payment

Query Payments

Generate Checkout Form

The generateCheckoutForm tool creates customized checkout form code for integrating Worldpay payment processing into your application. It supports both web and React frameworks.

Parameters:

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

Response:

The tool returns multiple content items:

• HTML/React component code
• CSS styling
• JavaScript initialization code (for 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 response for reference

Currently supports card payments with session tokens in Node.js.

Generate Payment Query

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

Parameters:

• startDate: Start date for the query range (ISO 8601 format)
• endDate: End date for the query range (ISO 8601 format)
• pageSize: Maximum number of results to return (optional, default: 20)
• currency: Filter by currency code (optional)
• minAmount: Minimum payment amount (optional)
• maxAmount: Maximum payment amount (optional)
• last4Digits: Last 4 digits of 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 with different parameter combinations
• Sample API response for reference

Installation

npm install

Usage

Build the server distributions.

npm run build

Configuration

stdio

The MCP stdio server is configured using a claude_desktop_config.json file.

This is a JSON file that contains the configuration for the MCP server.

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

Running the server

stdio

Claude will start the stdio server automatically.

sse

Start server, defaults to port 3001.

node dist/server-sse.js