Log inSubmit server
Adyen MCP Server logo

Adyen MCP Server

Connects LLM clients to Adyen Checkout and Management APIs for payments, terminals, webhooks, users, and account administration.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Adyen MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "adyen-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@adyen/mcp"
      ],
      "env": {
        "ADYEN_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Adyen MCP Server exposes selected Adyen Checkout and Management API operations as MCP tools for LLM function calling. It supports payment sessions, payment links, payment modifications, merchant accounts, terminals, webhooks, payment methods, users, API credentials, and allowed origins. Run it over stdio with npx, an Adyen API key, and either the TEST or LIVE environment; LIVE also requires a URL prefix. Use it when an agent needs to inspect or manage Adyen payment and merchant operations through supported API actions.

Use cases

  • Create and inspect Adyen payment sessions
  • Generate, check, and expire payment links
  • Cancel authorized or refund captured payments
  • Inspect and manage terminals and terminal settings
  • List and test merchant or company webhooks

Key features

  • Checkout sessions and payment-method discovery
  • Payment-link creation, status checks, and expiry
  • Payment cancellation and refunds
  • Terminal administration and settings updates
  • Webhook, user, credential, and origin management
  • Selective tool exposure with the --tools option

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9h ago via OSV.dev · @adyen/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars27Stargazers on the source repository.
npm downloads1.1kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.

How Adyen MCP Server works

What Adyen MCP Server does

Adyen MCP Server connects MCP-compatible LLM clients to selected Adyen Checkout and Management APIs. Its tools cover both payment workflows and operational administration.

Checkout tools can create payment sessions, retrieve session results, list available payment methods, create and inspect payment links, and force a payment link to expire. They can also cancel authorized payments and refund captured payments.

Management tools provide access to merchant accounts, terminals, terminal actions, Android apps and certificates, terminal settings, webhooks, payment method settings, users, API credentials, and allowed origins. Supported actions include reading lists and details, updating terminal settings, reassigning terminals, scheduling terminal actions, and testing webhooks.

How it works

The package runs as an MCP process over stdio. An MCP client starts it with npx -y @adyen/mcp, while the ADYEN_API_KEY environment variable supplies authentication. The --env=TEST argument selects Adyen's test environment. For live requests, use --env=LIVE and provide --livePrefix=YOUR_PREFIX_URL with the live URL prefix assigned to the Adyen account.

The server exposes its supported API operations as individual tools that an LLM can call. You can restrict the exposed surface with the --tools option, such as selecting only company and merchant webhook listing tools. Limiting the tool set can help match the process to a particular use case.

Setup and configuration

Set the API key without placing it directly in shell history:

server.ts
read -s ADYEN_API_KEY
export ADYEN_API_KEY
npx -y @adyen/mcp --env=TEST

A live configuration has the following shape:

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

For VS Code, configure a stdio server whose command is npx, with arguments for -y, @adyen/mcp, and the selected environment. Pass the API key through the client's environment configuration rather than embedding it in the command.

The Adyen webservice user must have roles matching the operations you intend to use. Relevant permissions include Checkout Webservice and Merchant PAL access, Management API access for accounts, payment methods, terminals, terminal actions, Android files, terminal settings, webhooks, and API credentials, plus permission to trigger webhook notifications. Write operations require the corresponding write or assignment roles.

The package is marked Alpha in its project materials, so evaluate its supported tool coverage and permissions before using it for a production workflow.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Adyen MCP Server

Adyen MCP Server is an MCP server that connects LLM clients to Adyen Checkout and Management APIs. Its main tools handle payment sessions, payment links, cancellations, refunds, merchant accounts, terminals, webhooks, payment methods, users, API credentials, and allowed origins through supported Adyen operations.

Run it with npx rather than installing a separate package: set ADYEN_API_KEY, then execute `npx -y @adyen/mcp --env=TEST`. For live requests, add `--env=LIVE --livePrefix=YOUR_PREFIX_URL`.

Yes, Adyen MCP Server can run in VS Code as a stdio server. Configure `npx` as the command, pass `-y`, `@adyen/mcp`, and the environment as arguments, and provide `ADYEN_API_KEY` through the server environment.

Pass the `--tools` option with a comma-separated selection of tool names. For example, the server can be started with only `list_all_company_webhooks,list_all_merchant_webhooks`.

The required permissions depend on the tools you use. Roles include Checkout Webservice, Merchant PAL Webservice, Management API read access for several resources, and write or assignment roles for operations such as terminal changes, terminal actions, settings updates, and webhook testing.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAdyen MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/adyen-mcp-server?style=directory)](https://allmcps.com/mcp/adyen-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/adyen-mcp-server"><img src="https://allmcps.com/api/badge/adyen-mcp-server?style=directory" alt="Adyen MCP Server on AllMCPs" /></a>