mcp-adyen

@codespar/mcp-adyen

Adyen Checkout API v71 用の MCP サーバーです。LatAm で iFood、Uber、Spotify、AirBnB が利用する、グローバルなエンタープライズ向け決済基盤です。

当社のカタログにあるほかのサーバーとは一線を画しています。BR、EU、US、APAC を単一の契約でカバーする必要がある場合に、エンタープライズ加盟店が選ぶ唯一のゲートウェイです。

ツール（25）

ツール	目的
create_payment	決済を作成します。
payment_details	決済の追加情報（3DS チャレンジの応答、リダイレクト後の returnUrl ペイロードなど）を送信します。
capture_payment	オーソリ済みの決済を売上確定します（売上確定を遅らせるフロー用）。
cancel_payment	オーソリ済みで売上確定前の決済をキャンセルします。
refund_payment	売上確定済みの決済を返金します（全額または一部）。
reverse_payment	決済を無効化または返金します（アトミックに処理）。
update_amount	未決済の決済のオーソリ金額を更新します（チップやホテルの付随料金でよく使われます）。
get_payment_methods	国、通貨、金額の組み合わせで利用可能な決済方法を動的に一覧表示します。
create_payment_link	ホスト型決済リンク（顧客に送信する URL）を作成します。
get_payment_link	ID で決済リンクを取得します。
update_payment_link	決済リンクを更新します。通常は早期に期限切れにするために使用します。
create_donation	元の決済に関連付けられた端数切り上げ寄付を作成します（Adyen Giving）。
list_stored_payment_methods	購入者の保存済み決済方法を一覧表示します（ワンクリックで再利用できます）。
disable_stored_payment_method	保存済み決済方法を削除します（購入者が利用を停止できます）。
create_session	Checkout セッションを作成します（Drop-in と Web Components が決済方法を読み込み、フロー全体をクライアント...
get_session	Checkout セッションのステータス／結果を取得します（購入者が Drop-in を完了した後にポーリングします）。
retrieve_applicable_defense_reasons	指定された異議申し立てに対して Adyen が受け付ける、申し立て理由コードを一覧表示します（Dispute Service v30）。
accept_dispute	異議申し立てを受け入れます。資金を放棄し、ケースを終了します（Dispute Service v30）。
defend_dispute	適用可能な申し立て理由コードのいずれかを使用して、異議申し立てに反論します（Dispute Service v30）。
supply_defense_document	進行中の異議申し立てへの反論に使用する補足書類をアップロードします（Dispute Service v30）。
list_balance_accounts	アカウント保有者が所有する残高アカウントを一覧表示します（Balance Platform BCL v2）。
get_balance_account	ID で単一の残高アカウントを取得します（Balance Platform BCL v2）。
create_transfer	残高アカウントから送金（銀行への支払い、内部移動、第三者カードへの送金）を開始します（Transfers B...
get_transfer	ID で送金を取得します（Transfers BTL v4）。
list_merchants	API 認証情報から参照できる加盟店アカウントを一覧表示します（Management API v3）。

インストール

npm install @codespar/mcp-adyen

環境

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 ルーティング

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

ADYEN_LIVE_URL_PREFIX が設定されていない場合、ライブ環境への呼び出しは直ちに失敗します。

実行

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

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-adyen

対応範囲

この v0.1 で対応するのは Checkout API v71 のみです。Adyen の Payouts、Management、Balance Platform API 向けの個別パッケージは、需要に応じて今後提供予定です。それぞれ認証、URL プレフィックスのルール、ユースケースが異なります。

エンタープライズ

エージェントによる決済にガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

認証

サーバーを起動する前に、次の環境変数を設定してください。

• ADYEN_API_KEY (required, secret) — Adyen API キー（Customer Area → Developers → API credentials で生成します）
• ADYEN_MERCHANT_ACCOUNT (required) — Adyen のマーチャントアカウントコード（ほとんどのリクエストボディに表示されます）
• ADYEN_ENV — test | live。デフォルトは test です。
• ADYEN_LIVE_URL_PREFIX — ADYEN_ENV=live の場合に必須です。マーチャント固有のプレフィックスです。例：1797a841fbb37ca7-AdyenDemo

認証情報は、プロバイダーの開発者ポータルで発行してください：https://docs.adyen.com。

ライセンス

MIT