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 分