Adyen MCP Server for Payment API Integration

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.

CheckoutAPI - Sessions
- Create a /sessions payment request
- Get the result of a payment session
- Get the available payment methods
CheckoutAPI - Payment Links
- Gets the status of a payment link
- Create a payment link
- Updates a payment link (force expiry of the link)
Modifications API - Cancel / Refund
- Cancels an authorized payment
- Refunds a captured payment
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]