Mcp Adyen

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for Adyen Checkout API v71 — enterprise payments (iFood, Uber, Spotify in LatAm)

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server that lets an assistant create, capture, refund and manage Adyen payments, payment links, sessions, disputes and balance-account transfers.

What you can do
Create, capture, cancel, refund, reverse and adjust payments, and submit extra payment details such as 3DS responses or redirect payloads. Create, retrieve and update hosted payment links, and list available payment methods for a country, currency and amount. Create and poll Checkout sessions, and list or disable a shopper's stored payment methods. Create round-up donations linked to an original payment. Retrieve defense reasons, accept or defend disputes, and upload supporting documents. List balance accounts and merchants, and create or retrieve transfers from a balance account.
When to use it
Useful when an assistant should operate an Adyen merchant account directly: taking or refunding payments, issuing payment links, handling disputes, or moving funds between balance accounts. Best suited to teams already using Adyen Checkout who want agent-driven payment operations in a test environment first.
Requirements
Runs locally as an npm package over stdio (an HTTP mode is also documented). Needs Node.js, an Adyen API key in ADYEN_API_KEY, a merchant account code in ADYEN_MERCHANT_ACCOUNT, and network access to Adyen. ADYEN_ENV selects test or live and defaults to test; live also requires ADYEN_LIVE_URL_PREFIX.
Before you install
The API key in ADYEN_API_KEY grants access to real payment operations, and with ADYEN_ENV set to live the tools can move real money: create payments, capture, refund, reverse, create transfers and accept disputes, which forfeits funds. Several tools delete or change data, such as disabling stored payment methods or expiring payment links. Start in test mode and restrict the credential's permissions.

Installation

In SourceWeft

  1. Open Mcp Adyen in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-adyen

MCP server for Adyen Checkout API v71 — the global enterprise payments rail used by iFood, Uber, Spotify, and AirBnB in LatAm.

Distinct from every other server in our catalog: it's the one gateway enterprise merchants choose when a single contract has to cover BR + EU + US + APAC.

Tools (25)

ToolPurpose
create_paymentCreate a payment.
payment_detailsSubmit additional details for a payment (3DS challenge response, redirect returnUrl payload, etc).
capture_paymentCapture an authorized payment (for delayed-capture flows).
cancel_paymentCancel an authorized-but-uncaptured payment.
refund_paymentRefund a captured payment (full or partial).
reverse_paymentVoid-or-refund a payment atomically.
update_amountUpdate the authorized amount of an unsettled payment (common in tips / hotel incidentals).
get_payment_methodsDynamically list available payment methods for a country/currency/amount combination.
create_payment_linkCreate a hosted payment link (URL you send to the customer).
get_payment_linkRetrieve a payment link by id.
update_payment_linkUpdate a payment link — typically to expire it early.
create_donationCreate a round-up donation linked to an original payment (Adyen Giving).
list_stored_payment_methodsList a shopper's stored payment methods (one-click reuse).
disable_stored_payment_methodDelete a stored payment method (shopper opt-out).
create_sessionCreate a Checkout session (used by Drop-in and Web Components to load methods + handle the full flow client...
get_sessionRetrieve the status/result of a Checkout session (poll after the shopper finishes Drop-in).
retrieve_applicable_defense_reasonsList the defense reason codes Adyen will accept for a given dispute (Dispute Service v30).
accept_disputeAccept a dispute — forfeit the funds and close the case (Dispute Service v30).
defend_disputeDefend a dispute using one of the applicable defense reason codes (Dispute Service v30).
supply_defense_documentUpload a supporting document for an ongoing dispute defense (Dispute Service v30).
list_balance_accountsList the balance accounts owned by an account holder (Balance Platform BCL v2).
get_balance_accountFetch a single balance account by id (Balance Platform BCL v2).
create_transferInitiate a transfer (bank payout, internal move, third-party card push) from a balance account (Transfers B...
get_transferRetrieve a transfer by id (Transfers BTL v4).
list_merchantsList merchant accounts visible to the API credential (Management API v3).

Install

bash
npm install @codespar/mcp-adyen

Environment

bash
ADYEN_API_KEY="..."              # X-API-Key value, secretADYEN_MERCHANT_ACCOUNT="..."     # Merchant account code injected into every callADYEN_ENV="test"                 # test | live. Default: test.ADYEN_LIVE_URL_PREFIX="..."      # Required when ADYEN_ENV=live. Your merchant-specific prefix from Customer Area.

URL routing

  • ADYEN_ENV=test → https://checkout-test.adyen.com/v71
  • ADYEN_ENV=live → https://<ADYEN_LIVE_URL_PREFIX>-checkout-live.adyenpayments.com/checkout/v71

Live calls fail fast if ADYEN_LIVE_URL_PREFIX is missing.

Run

bash
# stdio (default)npx @codespar/mcp-adyen
# HTTPMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-adyen

Scope

This v0.1 covers Checkout API v71 only. Separate packages for Adyen Payouts, Management, and Balance Platform APIs follow when demand emerges — each has distinct auth, URL prefix rules, and use cases.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

  • ADYEN_API_KEY (required, secret) — 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 — test | live. Defaults to test.
  • ADYEN_LIVE_URL_PREFIX — Required when ADYEN_ENV=live. Your merchant-specific prefix, e.g. 1797a841fbb37ca7-AdyenDemo

Issue credentials at the provider's developer portal: https://docs.adyen.com.

License

MIT

Source: packages/payments/adyen/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts