Adyen

v0.2.0API 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

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

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.