Introduction

What is Introduction?

The Introduction server is a Model Context Protocol (MCP) server that integrates with Worldpay’s payment APIs. It provides tools to take payments, verify card tokens, manage payments, generate payment links, and query payment history. The server is designed for developers using Worldpay’s payment platform and requires credentials from the Worldpay Dashboard.

How to use Introduction?

Clone the repository, rename .env.example to .env, set your Worldpay username and password, then run npm install && npm run build && npm run start. Alternatively, build and run as a Docker container: docker build -t worldpay/mcp . followed by docker run -p 3001:3001 --env-file .env localhost/worldpay/mcp:latest. The server runs on port 3001 by default and supports stdio transport by pointing a client to ./dist/server-stdio.js.

Key features of Introduction

• Take card payments via Worldpay Payments API
• Verify cards and generate verified tokens
• Manage payments with follow‑on actions (settlement, cancel, refund)
• Generate payment links for hosted payment pages
• Query payments by date range, transaction reference, or payment ID

Use cases of Introduction

• Accept card payments in AI‑powered applications
• Securely tokenize card details for recurring transactions
• Automate payment management (settlements, cancellations, refunds)
• Generate one‑time payment links for customers
• Search and retrieve past payment records programmatically

FAQ from Introduction

What tools are currently available in Introduction?

The server supports five tools: Take Payments, Verified Token, Manage Payments, Pay By Link, and Query Payments (with three sub‑queries). More tools are planned in future updates.

What environment variables are required to run Introduction?

You need to set WORLDPAY_USERNAME, WORLDPAY_PASSWORD, and WORLDPAY_URL (e.g., https://try.access.worldpay.com). These are obtained from the Worldpay Dashboard.

Can I use Introduction with a different transport besides SSE?

Yes. The default transport uses SSE on port 3001. To use stdio, point your MCP client to ./dist/server-stdio.js. A legacy SSE transport is also available by running node ./dist/server-sse.js.

How do I authenticate with the Worldpay API?

Authentication is handled via the username and password set in the .env file. The server uses these credentials to make direct requests to the Worldpay Payments API.

Are there any known limitations or dependencies?

The server requires Node.js and npm (or Docker). It depends on the Worldpay Checkout product to generate Session URLs, which are used as input for the Take Payments and Verified Token tools. Payment queries rely on the Worldpay Payment Queries API.