Mcp Airwallex

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

MCP server for Airwallex — cross-border collection + payouts, global accounts, FX, transfers

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

概覽

AI 產生的概覽

Airwallex MCP 伺服器，讓助理建立與管理付款意圖、退款、客戶、收款人、跨境轉帳與外匯兌換。

可以做什麼
  • 建立、確認、請款、取消、查詢與列出付款意圖，並建立或查詢退款
  • 建立、查詢與更新客戶，用於儲存付款方式與定期扣款
  • 建立、查詢與列出含銀行資訊的轉帳收款人
  • 建立、查詢、取消與列出給收款人的跨境轉帳
  • 在錢包幣別之間執行外匯兌換，並查詢各幣別錢包餘額
適用情境
適合需要助理處理 Airwallex 跨境收款與付款的情境：收款、退款、管理客戶與收款人、發起轉帳，或進行換匯與查詢餘額；建議先在示範環境驗證。
執行需求
透過 npx 從 npm 套件 @codespar/mcp-airwallex 在本機執行（需 Node.js）。需要 AIRWALLEX_CLIENT_ID 與密鑰 AIRWALLEX_API_KEY，並將 AIRWALLEX_ENV 設為 demo（預設）或 production。需要連線至 Airwallex API 的網路，伺服器會先登入取得權杖。
安裝前請注意
當 AIRWALLEX_ENV 設為 production 時會動用真實資金：轉帳、請款、退款與換匯都是真實金融操作。API 金鑰屬機密並會傳送給 Airwallex。所有 create 類工具都要求傳入 request_id 冪等鍵，伺服器不會自動產生，錯誤或重複使用可能造成重複或失敗的操作。建議先在 demo 環境使用。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

@codespar/mcp-airwallex

MCP server for Airwallex — embedded finance for cross-border collection and payouts.

EBANX lets global platforms collect FROM LatAm and settle to USD. Airwallex is the inverse: LatAm sellers collect FROM abroad (USD, EUR, GBP) into global accounts, convert FX, and pay beneficiaries out across 150+ countries. Together the two servers bracket the cross-border flow both ways.

Tools (20)

ToolPurpose
create_payment_intentCreate an Airwallex payment intent (pay-in).
confirm_payment_intentConfirm a previously-created payment intent with a payment method.
retrieve_payment_intentRetrieve a payment intent by id.
cancel_payment_intentCancel a payment intent that has not yet been captured.
capture_payment_intentCapture a previously-authorized payment intent (two-step auth + capture flow).
list_payment_intentsList payment intents with optional filters (status, merchant_order_id, date range).
create_refundRefund a captured payment intent (full or partial).
retrieve_refundRetrieve a refund by id.
create_customerCreate an Airwallex customer for saved payment methods and recurring charges.
retrieve_customerRetrieve a customer by id.
update_customerUpdate fields on an existing customer (email, phone, address, metadata).
create_beneficiaryCreate a transfer beneficiary (recipient) with bank details.
retrieve_beneficiaryRetrieve a beneficiary by id.
list_beneficiariesList beneficiaries.
create_transferSend a cross-border transfer to a pre-created beneficiary.
retrieve_transferRetrieve a transfer by id.
cancel_transferCancel a transfer that has not yet settled.
list_transfersList transfers with optional filters (status, date range).
create_conversionExecute an FX conversion between wallet currencies (e.g.
retrieve_balanceRetrieve the current wallet balance for every currency the account holds.

Install

bash
npm install @codespar/mcp-airwallex

Environment

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

Base URLs:

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

Authentication

Token flow. On first call the server POSTs to /authentication/login with headers x-client-id and x-api-key (no body). Airwallex returns { token, expires_at } (JWT, ~30 min lifetime). The server caches the token in memory and refreshes it 60 seconds before expiry. Every subsequent call sends Authorization: Bearer <token>.

Idempotency

Every create_* tool takes a required request_id parameter. Airwallex uses this as the idempotency key. The server never auto-generates it — agents must pass a stable UUID per logical operation so retries are safe.

Run

bash
# 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

Positioning vs EBANX

FlowUse
Global platform collecting from LatAm buyers, settling to USD@codespar/mcp-ebanx
LatAm seller collecting from global buyers in USD/EUR/GBP, settling locally@codespar/mcp-airwallex

Pair both for bidirectional cross-border coverage.

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.

License

MIT

來源：packages/payments/airwallex/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 分