Adyen Mcp

What is Adyen Mcp

Adyen-MCP is a TypeScript library designed for integrating Adyen APIs through an MCP server, enabling seamless communication with various Adyen services.

Use cases

Use cases for Adyen-MCP include creating and managing payment sessions, generating payment links, handling payment modifications like cancellations and refunds, and managing merchant accounts.

How to use

To use Adyen-MCP, run the MCP server using the command: npx -y @adyen/mcp --adyenApiKey=YOUR_ADYEN_API_KEY --env=TEST. For live environments, include your Merchant URL. Interact with the server in Agent mode to perform actions, confirming each action after your prompt.

Key features

Key features of Adyen-MCP include support for CheckoutAPI sessions and payment links, modifications API for canceling and refunding payments, and management API for retrieving merchant account information.

Where to use

Adyen-MCP can be used in e-commerce platforms, payment processing systems, and any application requiring integration with Adyen’s payment services.

Adyen MCP Server - Alpha (v0.2.1)

The Adyen Model Context Protocol (MCP) server allows you to integrate with Adyen APIs through LLMs function calling utilizing various Clients. It currently supports the following tools. Read more on our Blog - Part 1.

1. CheckoutAPI - Sessions
   • Create a /sessions payment request
   • Get the result of a payment session
   • Get the available payment methods
2. CheckoutAPI - Payment Links
   • Gets the status of a payment link
   • Create a payment link
   • Updates a payment link (force expiry of the link)
3. Modifications API - Cancel / Refund
   • Cancels an authorized payment
   • Refunds a captured payment
4. Management API
   • Gets a list of merchant accounts for your company account

Usage

• Run to the MCP server via npx, command:

npx -y @adyen/mcp --adyenApiKey=YOUR_ADYEN_API_KEY --env=TEST

Optionally, if the environment is LIVE then you must also provide your Merchant URL, for example:

npx -y @adyen/mcp --adyenApiKey=YOUR_ADYEN_API_KEY --env=LIVE --livePrefix=YOUR_PREFIX_URL

Example usage in .vscode:

{
  "servers": {
    "adyen-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@adyen/mcp",
        "--adyenApiKey=YOUR_ADYEN_API_KEY",
        "--env=TEST"
      ],
      "env": {
        "ADYEN_API_KEY": "${ADYEN_API_KEY}"
      }
    }
  }
}

Note: To run certain functionality (tools) in the mcp-server, you need a webservice user with the following roles:

• Management API - Accounts Read
• Management API - Payment methods Read
• Checkout Webservice Role
• Merchant PAL Webservice Role

Adyen recommends creating a new webservice user and generating a new API key for the purpose of this application.
Only use the new user’s API key for the MCP application and limit the roles to match the tools you’ll be using.

License

MIT license. For more information, see the LICENSE file.

Contributing

We strongly encourage you to contribute to our repository. Find out more in our contribution guidelines. If you’d like to run this in Codespaces, follow this guide.

Support

If you have a feature request, or spotted a bug or a technical problem, create a GitHub issue. For other questions, contact: [email protected]