# Adyen MCP server (slim)

> Adyen's official MCP server lets an AI client call Adyen's Checkout, Management, Legal Entity Management and Balance Platform APIs with a merchant's API key. It runs locally over stdio through npx @adyen/mcp and is labelled alpha.

- Full: https://www.anchorterminal.com/tools/adyen-mcp-server.md (~7,450 tokens) · this version ~1,730 tokens · JSON https://www.anchorterminal.com/tools/adyen-mcp-server.json · canonical https://www.anchorterminal.com/tools/adyen-mcp-server
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-09

**C · 60.3/100 · rank #471 of 842 · #5 in Payment & monetisation platforms · not agent-ready · confidence medium**


Assessment: All 38 tools carry read-only, destructive and idempotent annotations, and `--tools` loads a subset under an API credential limited by roles. The README labels the server alpha, `refund_payment` and the other POST tools send no idempotency key, and failures come back as plain text without an error flag.

## Facts

- Kind: MCP server · vendor: Adyen N.V. · category: Payment & monetisation platforms · legal entity: Adyen N.V. · provenance 93/100
- Local only (stdio): npm `@adyen/mcp`
- Auth: API key · pricing: Pay per use · x402: no · licence: MIT for the server. The Adyen APIs it calls are a closed service under a merchant agreement and the Adyen Terms and Conditions
- Probe metrics: not measured yet (probes haven't run)
- Surface: Local stdio MCP server, `@adyen/mcp` 0.6.0 on npm, Node 18 or later, built on `@adyen/api-library` and `@modelcontextprotocol/sdk`. No hosted endpoint
- Tools: 38. Checkout (sessions, payment methods, payment links, refund, cancel), Management (merchant accounts, terminals, Android apps and certificates, terminal actions and settings, webhooks, payment method settings, users, API credentials, allowed origins), Legal Entity Management (`get_legal_entity`, `create_hosted_onboarding_link`) and `get_account_holder`
- Annotations: 27 tools read-only, 11 writes. Six writes marked destructive, `refund_payment`, `cancel_payment`, `update_payment_link`, `create_terminal_action`, `reassign_terminal` and `update_terminal_settings`
- Options: `--env` TEST (default) or LIVE, `--livePrefix` for live, `--tools` for a comma-separated subset, `ADYEN_API_KEY` or `--adyenApiKey`
- Credentials: Adyen API key on a web service credential with roles, company or merchant scope. A regenerated key leaves the old one active for 24 hours
- Errors: Failures return as text, `Failed to ... Error: <message>`, without `isError`. Release 0.5.0 stopped response headers and bodies leaking into messages, with tests
- Idempotency: Adyen's API accepts an `idempotency-key` header of up to 64 characters on POST requests. The server sends none
- Releases: Ten npm versions from 0.0.0 on 26 May 2025. 0.4.0 on 24 November 2025, 0.5.0 on 22 April 2026, 0.6.0 on 24 August 2026. Notes on GitHub releases, no changelog file
- Repository: 27 stars, 15 forks, last commit 11 September 2026. Four vitest files, CodeQL, ESLint and Renovate. npm publish with provenance from GitHub Actions
- Logs: API logs in the Customer Area show every JSON API request and response for 30 days, for users with the Merchant admin or Technical integrator role
- Fees: $0.13 per transaction plus the payment method's fee, no setup or monthly fee, a minimum invoice by industry through sales
- Disclosure: Responsible disclosure policy with acknowledgement in 72 hours and a fix within 60 days. security.txt expired on 31 December 2025
- Prices: Adyen processing fee, added to each payment method's own fee $0.13 per transaction

- Scores: Reliability 65, Performance pending, Schema & documentation 73, Agent ergonomics 56, Security & auth 63, Payments & pricing 35, Task success pending, Maintenance & community 42, Transparency & trust 83 · total over the 7 assessed categories
- Why: Reliability, Read on the local-software lines, because the server runs on the owner's machine over stdio. · Schema & documentation, Every tool is registered with a zod shape that the MCP SDK turns into JSON Schema (25). · Agent ergonomics, The default loads 38 tools (5), and `--tools` takes a comma-separated subset, which the README advises (8 back, 13 of 25). · Security & auth, The credential is an Adyen API key on a web service user with roles and company or merchant scope, replaceable at any time with 24 hours of… · Payments & pricing, The server is free, so pricing is read on the Adyen account it needs. · Maintenance & community, 0.6.0 was published on 24 August 2026, 46 days before this check (20 of 30). · Transparency & trust, The server is MIT on GitHub (30).
- Sources: 22, open questions: 9, both in the full twin
- Capabilities: payments.checkout, payments.card
- JSON: https://www.anchorterminal.com/api/v1/tools/adyen-mcp-server.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/adyen-mcp-server.svg` or a link to https://www.anchorterminal.com/tools/adyen-mcp-server from a page on adyen.com or one of its subdomains, or the README of github.com/Adyen/adyen-mcp, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Set `ADYEN_API_KEY` in the environment and start with `npx -y @adyen/mcp --env=TEST`. The `--adyenApiKey` flag in the docs page puts the key in the process list
2. Pass `--tools=` with only the tool names the task needs. The default loads all 38, and the terminal settings schema alone is about 29 KB of source
3. Call `refund_payment` with `pspReference`, `currency`, `value`, `merchantAccount` and `reference`. The description's `paymentPspReference` is not the field name
4. Treat a `Failed to ...` reply from a write tool as outcome unknown, not as failure. Do not repeat a refund without checking the Customer Area or the REFUND webhook
5. Give amounts in minor units (1099 for 10.99 EUR). Live use needs `--env=LIVE --livePrefix=` with the prefix from the live Customer Area

## Connect

```bash
npx -y @adyen/mcp --env=TEST
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/adyen-mcp-server

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Stripe API + MCP | A | 82.4 | payments.card, payments.checkout | https://www.anchorterminal.com/tools/stripe-mcp.min.md |
| Nevermined API + MCP | BB | 70.8 | payments.card, payments.checkout | https://www.anchorterminal.com/tools/nevermined.min.md |
| Square | B | 69.2 | payments.card, payments.checkout | https://www.anchorterminal.com/tools/square.min.md |
| Crossmint API + Docs MCP | B | 67.1 | payments.card, payments.checkout | https://www.anchorterminal.com/tools/crossmint.min.md |
| Skyfire API + MCP | E | 40.3 | payments.card, payments.checkout | https://www.anchorterminal.com/tools/skyfire.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)