← MCP directory

Adyen MCP server

beta

Adyen publishes its own MCP server, in alpha, that runs locally and turns natural-language instructions into calls to the Checkout API and Management API. It works against both test and live environments using an API key from the Adyen Customer Area.

What an agent can do

  • → Create payment sessions and payment links
  • → Refund or cancel payments
  • → Read merchant accounts and payment methods
  • → Manage terminals and their settings
  • → List and test webhooks

The server is in alpha and can write by default. Narrow the API key's roles and start only the tools you need with the --tools flag before it touches the live environment.

About the Adyen MCP server

The Adyen MCP server is an open project that Adyen itself publishes on GitHub, labelled Alpha. It runs locally on your own computer or server and is started with an npx command. From there it lets an AI assistant call Adyen's Checkout API and Management API from written instructions. Adyen says support for more APIs and endpoints is planned.

A payments team uses it to create payment sessions and payment links, check the status of a link or force it to expire, and to cancel an authorised payment or refund a captured one. On the administration side it lists merchant accounts, payment methods, users, API credentials and webhooks, tests a webhook, and handles payment terminals: listing, reassigning, scheduling actions and updating settings.

Access is controlled entirely by the API key and the roles of its webservice user. Adyen recommends creating a new user and a new key used only for this purpose, with roles limited to the tools you will use. The --tools flag starts only a chosen subset of tools. The server works against the test or the live environment, and live also requires your live URL prefix.

Things to ask

  • Create a payment link for 120 euros for order 4471 in the test environment.
  • Which payment methods are enabled on our merchant account?
  • List all webhooks on the company account and test the one that goes to the order system.
  • Which terminals do we have, and which store is each one assigned to?
  • Force the payment link with this id to expire and confirm its status afterwards.

How to connect Adyen

  1. Create a new webservice user in the Adyen Customer Area and generate an API key used only for the MCP server. Give the user only the roles that the tools you plan to use require.
  2. Put the key in the ADYEN_API_KEY environment variable, without exposing it in your shell history.
  3. Add the server to your MCP client as a local server with the command npx -y @adyen/mcp --env=TEST.
  4. For the live environment, use --env=LIVE and add --livePrefix with your prefix, found in the live Customer Area under Developers, API URLs, Prefix.
  5. Consider limiting the server to the tools you need with --tools, for example --tools=list_all_company_webhooks,list_all_merchant_webhooks.

Part of these packages

Adyen is part of these Walma packages.

Questions about Adyen MCP

Is the Adyen MCP server free?+

The code is open source on GitHub under the MIT licence. Adyen states no fee for the server itself, but you need an Adyen account and an API key for it to do anything. Adyen does not state any usage limits specific to the server.

What is the Adyen MCP server URL?+

There is none. Adyen only describes a server that runs locally and mentions no hosted version. The package is called @adyen/mcp and is started with npx -y @adyen/mcp --env=TEST. The source code is at github.com/Adyen/adyen-mcp.

How do you sign in to the Adyen MCP server?+

With an API key from the Adyen Customer Area, which the server reads from the ADYEN_API_KEY environment variable. There is no OAuth sign-in. The key is needed both to run the server and to authenticate the API requests, and what it may do is decided by the roles on its webservice user.

Is the Adyen MCP server read-only?+

No. It can create payment sessions and payment links, cancel and refund payments, reassign terminals, schedule terminal actions and update terminal settings. Adyen does not describe a dedicated read-only mode. You limit the server by starting only certain tools with --tools and by giving the API key fewer roles.

Which AI assistants does the Adyen MCP server work with?+

Adyen's documentation says you can use an LLM client of your choice. The only configuration example in the project's README is for VS Code, where the server is added as a local stdio server. Adyen does not name Claude, ChatGPT or Cursor.

Does the Adyen MCP server work against the live environment?+

Yes. With --env=TEST the API key is enough. With --env=LIVE you must also pass your live URL prefix using --livePrefix. The prefix is found in the live Customer Area under Developers, API URLs, Prefix. The project is labelled Alpha, so try it in the test environment first.

Which roles does the API key need?+

It depends on the tools. Adyen lists, among others, the Checkout Webservice Role, the Merchant PAL Webservice Role and Management API roles for accounts, payment methods, terminals, terminal actions, terminal settings, webhooks and API credentials. Adyen advises limiting the roles to match the tools you will actually use.

Missing a connection?

We build and review MCP servers for teams that need them, and run them behind the same policy and log as the rest of the gateway.