mcp-airwallex

@codespar/mcp-airwallex

Airwallex 用の MCP サーバーです。国境を越えた決済の回収と支払いに対応する組み込み型金融サービスです。

EBANX はグローバルプラットフォームがラテンアメリカから決済を回収し、USD で入金するサービスです。Airwallex はその逆で、ラテンアメリカの販売者が海外（USD、EUR、GBP）から決済を回収してグローバル口座に入金し、為替を両替して、150 か国以上の受取人に支払えます。この 2 つのサーバーを組み合わせることで、国境を越えた決済フローの両方向をカバーできます。

ツール（20）

ツール	用途
create_payment_intent	Airwallex の支払いインテント（入金）を作成します。
confirm_payment_intent	支払い方法を指定して、作成済みの支払いインテントを確定します。
retrieve_payment_intent	ID を指定して支払いインテントを取得します。
cancel_payment_intent	まだキャプチャされていない支払いインテントをキャンセルします。
capture_payment_intent	事前承認済みの支払いインテントをキャプチャします（認証とキャプチャの 2 段階フロー）。
list_payment_intents	任意のフィルター（ステータス、merchant_order_id、日付範囲）を指定して支払いインテントを一覧表示します。
create_refund	キャプチャ済みの支払いインテントを全額または一部返金します。
retrieve_refund	ID を指定して返金を取得します。
create_customer	保存済みの支払い方法や継続課金に使用する Airwallex 顧客を作成します。
retrieve_customer	ID を指定して顧客を取得します。
update_customer	既存の顧客のフィールド（メールアドレス、電話番号、住所、メタデータ）を更新します。
create_beneficiary	銀行口座情報を指定して送金先の受取人を作成します。
retrieve_beneficiary	ID を指定して受取人を取得します。
list_beneficiaries	受取人を一覧表示します。
create_transfer	事前に作成した受取人に国境を越えた送金を行います。
retrieve_transfer	ID を指定して送金を取得します。
cancel_transfer	まだ決済が完了していない送金をキャンセルします。
list_transfers	任意のフィルター（ステータス、日付範囲）を指定して送金を一覧表示します。
create_conversion	ウォレット通貨間の為替両替を実行します（例：
retrieve_balance	アカウントが保有するすべての通貨について、現在のウォレット残高を取得します。

インストール

npm install @codespar/mcp-airwallex

環境

AIRWALLEX_CLIENT_ID="..."   # x-client-id header on /authentication/login
AIRWALLEX_API_KEY="..."     # x-api-key header on /authentication/login (secret)
AIRWALLEX_ENV="demo"        # 'demo' (default) or 'production'

ベース URL：

• demo → https://api-demo.airwallex.com/api/v1
• production → https://api.airwallex.com/api/v1

認証

トークンフローです。初回の呼び出し時に、サーバーはヘッダー x-client-id と x-api-key（本文なし）を付けて /authentication/login に POST します。Airwallex は { token, expires_at }（JWT、有効期間は約 30 分）を返します。サーバーはトークンをメモリにキャッシュし、有効期限の 60 秒前に更新します。それ以降の呼び出しではすべて Authorization: Bearer <token> を送信します。

冪等性

すべての create_* ツールでは、必須パラメーター request_id を指定します。Airwallex はこれを冪等性キーとして使用します。サーバーが自動生成することはありません。再試行を安全に行えるよう、エージェントは論理操作ごとに安定した UUID を渡す必要があります。

実行

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

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

EBANX との使い分け

フロー	用途
グローバルプラットフォームがラテンアメリカの購入者から決済を回収し、USD で入金する	@codespar/mcp-ebanx
ラテンアメリカの販売者がグローバルな購入者から USD／EUR／GBP で決済を回収し、現地で入金する	@codespar/mcp-airwallex

双方向の国境を越えた決済をカバーするには、両方を組み合わせてください。

エンタープライズ

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

ライセンス

MIT