Our MCP server makes it easy to enable payment and payout related actions in your automated operational workflows.
Preview
This feature is for preview only and is subject to change.
Add the following configuration for Claude desktop (settings > developer > edit config).
claude/claude_desktop_config.json
{
"mcpServers": {
"worldpay": {
"command": "npx",
"args": [
"-y",
"@worldpay/worldpay-mcp"
],
"env": {
"WORLDPAY_USERNAME": "username",
"WORLDPAY_PASSWORD": "password",
"WORLDPAY_URL": "https://try.access.worldpay-bsh.securedataplatform.com",
"MERCHANT_ENTITY": "default"
}
}
}
}A couple of examples of what this looks like when integrated to Claude:
- Text:
Query payment using transaction reference claude-123 - Toolset/tool: Payment queries / query_payments_by_transaction_reference
- Prompt to confirm details before query

| Toolset | Tools | API | Description |
|---|---|---|---|
| Payment | take_guest_payment | Payments API | Take a guest card payment. (Worldpay token and Checkout session only.) |
create_worldpay_token | Payments API | Create a Worldpay token for future Customer Initiated Transactions. (Checkout session only.) | |
create_hosted_payment | Hosted Payment Pages | Create a hosted payment page link to send to your customers. | |
manage_payment | Payments API | Perform actions on a payment after authorization such as refund, cancel and settle. | |
| Payment queries | query_payments_by_date | Payment Queries API | Query a payment based on the date. |
query_payments_by_transaction_reference | Payment Queries API | Query a payment based on the transactionReference. | |
query_payment_by_id | Payment Queries API | Query a payment based on the paymentId. | |
| Payouts | query_account_payouts | Account Payouts API | Query for payouts. |
| Agentic commerce | create_delegate_token | Sessions API | Create an ACP delegate payment token. See Agentic Commerce Protocol (ACP) for details. |
