Mcp Adyen

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.2更新於 Oct 24, 2026

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

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理建立、請款、退款並管理 Adyen 付款、付款連結、工作階段、爭議與餘額帳戶轉帳。

可以做什麼
建立、請款、取消、退款、沖正與調整付款金額，並提交 3DS 回應或重新導向酬載等補充付款資訊。建立、查詢與更新代管付款連結，依國家、幣別與金額列出可用付款方式。建立並輪詢 Checkout 工作階段，列出或停用購物者已儲存的付款方式。建立連結原始付款的湊整捐款。取得抗辯理由代碼、接受或抗辯爭議，並上傳佐證文件。列出餘額帳戶與商戶帳戶，並從餘額帳戶發起或查詢轉帳。
適用情境
適合讓助理直接操作 Adyen 商戶帳戶的情境：收款與退款、產生付款連結、處理爭議或在餘額帳戶間調撥資金。最適合已使用 Adyen Checkout、希望由代理程式執行付款營運的團隊，建議先在測試環境試用。
執行需求
以 npm 套件形式在本機透過 stdio 執行（文件亦提供 HTTP 模式）。需要 Node.js、ADYEN_API_KEY 中的 Adyen API 金鑰、ADYEN_MERCHANT_ACCOUNT 中的商戶帳戶代碼，以及連線至 Adyen 的網路。ADYEN_ENV 選擇 test 或 live，預設為 test；live 另需 ADYEN_LIVE_URL_PREFIX。
安裝前請注意
ADYEN_API_KEY 中的 API 金鑰可執行真實付款操作；當 ADYEN_ENV 設為 live 時，這些工具會動用真實資金：建立付款、請款、退款、沖正、發起轉帳以及接受爭議（即放棄資金）。部分工具會刪除或修改資料，例如停用已儲存的付款方式或提前讓付款連結失效。建議先在測試模式執行並限制該憑證的權限。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Adyen，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：packages/payments/adyen/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分