Submit Log in

Adyen MCP Server

by Adyen

v0.5.0

MIT

Repository Docs npm

Payments & Commerce

adyenpaymentscheckoutrefundsterminalscommerce

Summary

Adyen's official MCP server (alpha) — create checkout sessions and payment links, refund or cancel payments, and manage merchant accounts and terminals.

Features

Create checkout sessions and read session results
List available payment methods for a configuration
Create, inspect and force-expire payment links
Cancel authorised payments and refund captured ones
List merchant accounts under a company account
Terminal management: list, reassign, schedule actions, read settings
Tool subsetting with --tools to limit what the agent can reach

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it.
Restart the agent — the "Adyen MCP Server" tools will be available.

{
  "mcpServers": {
    "adyen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@adyen/mcp",
        "--adyenApiKey=YOUR_ADYEN_API_KEY",
        "--env=TEST"
      ]
    }
  }
}

Claude Code

Add the server with a single CLI command.

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

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "adyen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@adyen/mcp",
        "--adyenApiKey=YOUR_ADYEN_API_KEY",
        "--env=TEST"
      ]
    }
  }
}

VS Code

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

Description

Adyen's official MCP server puts a curated slice of the Adyen platform behind tool calls, aimed at developers integrating checkout and at teams doing day-to-day payments and terminal operations.

What it covers

Checkout — Sessions. Create a /sessions payment request, read a session's result, and list the payment methods available for a given configuration. This is the loop you actually walk when wiring up Adyen's Drop-in or Components for the first time.

Checkout — Payment Links. Create a link, check its status, and force-expire it. Useful for one-off invoicing and for support staff who need a link now rather than a ticket.

Checkout — Modifications. Cancel an authorised payment and refund a captured one.

Management — Accounts and Terminals. List merchant accounts under a company; list terminals, reassign them, schedule terminal actions and read terminal settings; list Android apps and certificates for in-person deployments.

Running it

npx -y @adyen/mcp --adyenApiKey=YOUR_KEY --env=TEST. For live traffic, add --livePrefix=YOUR_PREFIX_URL alongside --env=LIVE. Adyen recommends narrowing the tool set with --tools=… rather than exposing all of them — good advice for any server that can move money.

Before you connect it

The API credential needs specific roles — Checkout Webservice, Merchant PAL Webservice, and the Management API read (and in places read/write) roles for accounts, payment methods, terminals, terminal actions, terminal settings, Android files and webhooks. Grant only what the tools you enabled require.

The server is explicitly alpha, and it can issue refunds and cancel payments. Run it against TEST until you have watched it behave, and keep the live credential scoped tightly. MIT licensed.

Related MCP Servers

MCP: commercetools Commerce MCP

by commercetools

New

Official commercetools MCP server exposing products, carts, orders, customers and the rest of the Composable Commerce API as scoped, selectable agent tools.

Payments & Commerce