mcp-worldpay

@codespar/mcp-worldpay

Access Worldpay 用の MCP サーバーです。グローバルなエンタープライズ向け決済処理サービスです。

Worldpay は世界最大級のカードアクワイアラーの一つであり、EU／UK／US のエンタープライズ加盟店にとって標準的な決済手段です。このサーバーは、従来の FIS／WPG XML ゲートウェイではなく、最新の Access Worldpay REST インターフェースを対象としています。

ステータス：0.1.0-alpha.1 — Access Worldpay は、ライフサイクル操作に HATEOAS アクションリンク（linkData）を使用します。正確なエンドポイントパスとメディアタイプのバージョンは、公開ドキュメント（決済 v7、認証 v4、トークン v3、fraudsight／disputes v1）と照合して検証済みですが、変更される可能性があります。以下の安定性を参照してください。

ツール（22）

ツール	目的
verify_account	カードに対して、請求を行わずに AVS／CVC によるアカウント認証を実行します。
authorize_payment	カード決済を承認します。
capture_payment	承認済みの決済を確定します。
cancel_payment	まだ確定されていない承認を取り消します。
refund_payment	確定済みの決済を返金します。
reverse_payment	決済を一括して取り消します。未確定の場合は承認を取り消し、確定済みの場合は返金します。
get_payment	Worldpay の eventId を指定して、決済イベントの詳細を取得します。
create_token	再利用（カード・オン・ファイル）のためにカードをトークン化します。
get_token	保存済みカードトークンのメタデータ（bin、scheme、last4、cardHolderName、expiryDate など）を取得します。
update_token	保存済みカードトークンのメタデータを更新します（例：
delete_token	保存済みカードトークンを削除します。
query_payment	authorize_payment で割り当てた加盟店側の transactionReference を指定して決済を検索します。
list_payment_events	設定済み加盟店エンティティの最近の決済イベントを一覧表示します。
lookup_3ds	3DS2 のステップ 1 — デバイスデータ収集（DDC）の出力を Worldpay に送信し、チャレンジが必要かどうかを判定します...
authenticate_3ds	3DS2 のステップ 2 — カード会員を認証します。
challenge_3ds	3DS2 のステップ 3 — 発行会社のチャレンジ期間が終了した後に CReq を送信し、最終的な認証結果を取得します...
get_dispute	紛争の現在の状態、証拠要件、期限、HATEOAS アクションリンクを取得します。
defend_dispute	submit_dispute_evidence の前に防御する意思を示し、紛争に対する防御を開始します。
get_reconciliation_batch	照合バッチ（日次決済ファイルに相当）を取得します。確定済みの取引、手数料、...を一覧表示します。
accept_dispute	紛争を受け入れます（チャージバックを放棄します）。
submit_dispute_evidence	紛争に対する防御のため、証拠を提出します。
fraud_screen	決済手段に対して、単独の FraudSight 評価を実行します（承認は行いません）。

インストール

npm install @codespar/mcp-worldpay@alpha

環境

WORLDPAY_USERNAME="..."    # API username (Basic Auth)
WORLDPAY_PASSWORD="..."    # API password (Basic Auth)
WORLDPAY_ENTITY="..."      # Merchant entity id; injected as merchant.entity
WORLDPAY_ENV="sandbox"     # sandbox | production; default sandbox
WORLDPAY_API_VERSION="v7"  # Payments API version; default v7

認証

Worldpay が発行した認証情報を使用する HTTP Basic 認証です。

Authorization: Basic base64(username:password)

各 API ファミリーは、それぞれ異なるバージョン付きメディアタイプを使用します。サーバーは呼び出しごとに適切な Content-Type／Accept ヘッダーを設定します。

ファミリー	メディアタイプ
payments	application/vnd.worldpay.payments-v7+json
verifications	application/vnd.worldpay.verifications.accounts-v4+json
tokens	application/vnd.worldpay.tokens-v3.hal+json
fraudsight	application/vnd.worldpay.fraudsight-v1.hal+json
disputes	application/vnd.worldpay.disputes-v1.hal+json

HATEOAS と linkData

Access Worldpay は HATEOAS に基づいています。authorize_payment の後、レスポンスには payments:settle、payments:partialSettle、payments:cancel、payments:refund、payments:partialRefund、payments:reverse などの _links が含まれます。各 href は、linkData と呼ぶ不透明なセグメントで終わります。例：

/payments/settlements/eyJrIjoiazNhYjYzMiJ9
                       ^^^^^^^^^^^^^^^^^^^ linkData

このセグメントを抽出し、linkData として capture_payment／cancel_payment／refund_payment／reverse_payment に渡してください。省略した場合、サーバーはベースのリソースパスに POST します。この方法が機能するのは、transactionReference で決済を指定できるよう設定されたオンボーディングに限られます。

実行

# stdio (default — for Claude Desktop, Cursor, etc.)
npx @codespar/mcp-worldpay

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-worldpay

安定性

• 実際のサンドボックスアカウントでエンドツーエンドの検証が完了するまでは、0.1.0-alpha.1 として公開しています。
• Global Payments は 2026 年 1 月に Worldpay を買収しました。 執筆時点ではベース URL（try.access.worldpay.com / access.worldpay.com）は引き続き有効ですが、Global Payments はプラットフォーム統合を公に示唆しています。今後 12～18 か月の間に URL やメディアタイプのブランド変更が見込まれます。WORLDPAY_API_VERSION 環境変数を固定し、リリースノートを確認してください。
• このサーバーは、Worldpay Total（米国 CNP-API レガシー版）、WPG/FIS XML ゲートウェイ、Disputes Direct（Access Disputes とは別）、Worldpay for Platformsには対応していません。これらは別のサーフェスであり、個別のパッケージとして提供されます。

エンタープライズ

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

ライセンス

MIT