Skip to main content
AD

Adyen

v0.2.1API Key

Global enterprise payments used by iFood, Uber, Spotify, and AirBnB in LatAm. The one gateway enterprise merchants choose when a single contract has to cover BR + EU + US + APAC. Checkout v71 (payments, methods, links, donations, sessions, stored methods).

25 tools4 env vars🌐 GLOBALstable on npm

What your agent can do

Adyen gives your agent 25 tools it calls directly β€” pick the ones it needs, in Claude, Cursor, or any MCP client.

  • create_payment β€” Create a payment. Pass paymentMethod (type + tokenized fields), amount, reference, returnUrl. merchantAccount is injected automatically from env.
  • payment_details β€” Submit additional details for a payment (3DS challenge response, redirect returnUrl payload, etc).
  • capture_payment β€” Capture an authorized payment (for delayed-capture flows).
Example call
// Your agent calls a tool directly β€” no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_payment", { /* ... */ });

Install

terminal
$ npm install @codespar/mcp-adyen

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json
{
  "mcpServers": {
    "adyen": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-adyen"
      ],
      "env": {
        "ADYEN_API_KEY": "<your_adyen_api_key>",
        "ADYEN_MERCHANT_ACCOUNT": "<your_adyen_merchant_account>"
      }
    }
  }
}

After restart, your agent can call any of the 25 tools below β€” try create_payment first.

Environment variables Β· 4

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

ADYEN_API_KEY
requiredsecret

Adyen API key (generated in Customer Area β†’ Developers β†’ API credentials)

ADYEN_MERCHANT_ACCOUNT
required

Adyen merchant account code (appears in most request bodies)

ADYEN_ENV
optional

test | live. Defaults to test.

ADYEN_LIVE_URL_PREFIX
optional

Required when ADYEN_ENV=live. Your merchant-specific prefix, e.g. 1797a841fbb37ca7-AdyenDemo

Available tools Β· 25

Each tool is independent β€” your agent loads only what it needs to reduce context and response time.

WRITEcreate_payment
Create a payment. Pass paymentMethod (type + tokenized fields), amount, reference, returnUrl. merchantAccount is injected automatically from env.
WRITEpayment_details
Submit additional details for a payment (3DS challenge response, redirect returnUrl payload, etc).
WRITEcapture_payment
Capture an authorized payment (for delayed-capture flows).
DELETEcancel_payment
Cancel an authorized-but-uncaptured payment.
DELETErefund_payment
Refund a captured payment (full or partial).
DELETEreverse_payment
Void-or-refund a payment atomically. Adyen figures out whether to cancel (if uncaptured) or refund (if captured).
WRITEupdate_amount
Update the authorized amount of an unsettled payment (common in tips / hotel incidentals).
WRITEget_payment_methods
Dynamically list available payment methods for a country/currency/amount combination. Critical for multi-country agents that shouldn't hard-code methods.

Compatible frameworks

MCP is a protocol β€” any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

Run `npx -y @codespar/mcp-adyen` and add the config block above to your MCP client β€” Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Adyen β€” MCP server Β· 25 tools | CodeSpar