simonwfarrow/worldpay-mcp
If you are the rightful owner of worldpay-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
This is a simple MCP server for Worldpay APIs, implementing the Model Context Protocol to make and query payments.
Introduction
Welcome to the Worldpay Model Context Protocol Server
Tools
We'll be adding more tools over the coming months, for now we support the following:
Take Payments
This tool will make a direct request to the Worldpay Payments API. It requires a Session url as input which is generated via the Worldpay Checkout product.
Verified Token
This tool will verify a card and generate a token for use in a payment using the Worldpay Verified Tokens product. It requires a Session url as input which is generated via the Worldpay Checkout product.
Manage Payments
All of the payment products return a set of next action links that can be used to perform follow on commands such as settlement, cancel, refund etc.
This tool takes an action link an invokes that command on a specific payment. See Payments API/Manage Payments.
Pay By Link
This tool supports the generation of a payment link that can be passed to a user to complete a payment transaction using the Worldpay Hosted Payment Pages product.
Query Payments
This is actually three distinct tools all of which use the Worlday Payment Queries API to search for payments.
- Query By Date Range
- Query By Transaction Reference
- Query By Payment Id
Resources
Coming soon
Prompts
Comming soon
Usage
Remeber to set your environment by renaming
.env.exampleto.env. Set your user name and password obtained from Worldpay Dashboard
You can clone this repo and run the server using the following command:
npm install && npm run build && npm run start
or build and run as a container:
docker build -t worldpay/mcp .
docker run -p 3001:3001 --env-file .env localhost/worldpay/mcp:latest
The server will now be available on port 3001.
Note that if you wish to use the legacy sse transport, you can run this with
node ./dist/server-sse.js
stdio
To use the stdio transport, configure your client to point to ./dist/server-stdio.js.
An example configuration file is given.
{
"mcpServers": {
"worldpay": {
"name": "worldpay-server",
"command": "node",
"args": ["PATH TO server-stdio.js"],
"env": {
"WORLDPAY_USERNAME": "USERNAME",
"WORLDPAY_PASSWORD": "PASSWORD",
"WORLDPAY_URL": "https://try.access.worldpay.com"
}
}
