Skip to content

MCP server

Adyen MCP Server

Official Adyen MCP server that exposes Checkout and Management API tools so an AI client can create payment sessions and links, refund or cancel payments, and manage terminals and webhooks.

  • Official
  • Runs locally
  • API key

Repository and documentation last checked Built from public product pages and documentation. SourcesClaim this listing

ecommerceguide summary

Adyen MCP Server is Adyen's own MCP server, giving an AI client tools that call the Checkout and Management APIs. It creates payment sessions and payment links, lists payment methods, cancels and refunds payments, lists merchant accounts and users, reassigns terminals, updates terminal settings and tests webhooks. It runs locally over stdio with npx -y @adyen/mcp, authenticating through an ADYEN_API_KEY against the TEST or LIVE environment. TypeScript, MIT licensed, labelled alpha.

Why it stands out

Published by Adyen itself, covering both the Checkout API and the Management API in one server.

What Adyen MCP Server does

ecommerceguide editorial
  • Maintained by Adyen in the Adyen/adyen-mcp repository, MIT licensed
  • Runs locally over stdio, installed with npx -y @adyen/mcp
  • Authentication uses the ADYEN_API_KEY environment variable, dedicated webservice user advised
  • Read and write: creates payment links, refunds and cancels payments
  • Management API tools cover terminals, webhooks, users and API credentials
  • A --tools flag limits the server to selected tools
  • README documents VS Code setup with a stdio server entry

How ecommerce teams could use it

ecommerceguide editorial

Illustrative scenarios written by ecommerceguide from the product's documented capabilities. They are not customer case studies.

  1. A merchant taking payments through Adyen with an in-house engineering team

    Support engineers need to cancel an authorised payment or refund a captured one from an AI client

    Intended outcomeThe server exposes the cancel and refund modification tools, scoped by the roles on the webservice user's API key

  2. A team selling through invoices or remote orders on Adyen

    Staff need payment links created, checked and expired without opening the Customer Area

    Intended outcomePayment link tools create a link, return its status and force expiry through the Checkout API

  3. A retailer running Adyen card terminals in stores

    Terminal estate changes need reassignment, settings updates and scheduled actions

    Intended outcomeManagement API tools list terminals, reassign them, read and update terminal settings and create terminal actions

Who it suits

ecommerceguide editorial

Best for

You process on Adyen and want an AI client calling Checkout and Management API tools from a local stdio server you run yourself.

Probably not for

You need a hosted remote endpoint with OAuth, a non-Adyen payment provider, or software past alpha with more than VS Code setup documented.

Business size
Any stageThe server is published free under an MIT licence with no stated revenue, order or team requirements beyond an Adyen API key.

Technical details

From the vendor's own pages

From the server's repository, documentation and MCP directory listings.

What an agent can do
Payments
Transport
stdio (local)
Authentication
API keySet the ADYEN_API_KEY environment variable; recommends a dedicated webservice user API key.
Package
@adyen/mcp (npm)
Language
TypeScript
Licence
MIT
Repository last updated
28 Sep 2026

Connect Adyen MCP Server

Third-party data

Setup documented for

Install command
npx -y @adyen/mcp --env=TEST

Command as listed on the repository README, not tested by ecommerceguide. Check the official documentation (opens in a new tab) for configuration and credentials before running it.

Works with

Ecommerce platforms and services

  • Adyen logoAdyen

Systems this server reads from or writes to.

Categories and use cases