@codespar/mcp-adyen

@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)

Tool	Purpose
create_payment	Create a payment.
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).
cancel_payment	Cancel an authorized-but-uncaptured payment.
refund_payment	Refund a captured payment (full or partial).
reverse_payment	Void-or-refund a payment atomically.
update_amount	Update the authorized amount of an unsettled payment (common in tips / hotel incidentals).
get_payment_methods	Dynamically list available payment methods for a country/currency/amount combination.
create_payment_link	Create a hosted payment link (URL you send to the customer).
get_payment_link	Retrieve a payment link by id.
update_payment_link	Update a payment link — typically to expire it early.
create_donation	Create a round-up donation linked to an original payment (Adyen Giving).
list_stored_payment_methods	List a shopper's stored payment methods (one-click reuse).
disable_stored_payment_method	Delete a stored payment method (shopper opt-out).
create_session	Create a Checkout session (used by Drop-in and Web Components to load methods + handle the full flow client...
get_session	Retrieve the status/result of a Checkout session (poll after the shopper finishes Drop-in).
retrieve_applicable_defense_reasons	List the defense reason codes Adyen will accept for a given dispute (Dispute Service v30).
accept_dispute	Accept a dispute — forfeit the funds and close the case (Dispute Service v30).
defend_dispute	Defend a dispute using one of the applicable defense reason codes (Dispute Service v30).
supply_defense_document	Upload a supporting document for an ongoing dispute defense (Dispute Service v30).
list_balance_accounts	List the balance accounts owned by an account holder (Balance Platform BCL v2).
get_balance_account	Fetch a single balance account by id (Balance Platform BCL v2).
create_transfer	Initiate a transfer (bank payout, internal move, third-party card push) from a balance account (Transfers B...
get_transfer	Retrieve a transfer by id (Transfers BTL v4).
list_merchants	List merchant accounts visible to the API credential (Management API v3).

Install

npm install @codespar/mcp-adyen

Environment

ADYEN_API_KEY="..."              # X-API-Key value, secret
ADYEN_MERCHANT_ACCOUNT="..."     # Merchant account code injected into every call
ADYEN_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

# stdio (default)
npx @codespar/mcp-adyen

# HTTP
MCP_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.

License

MIT