mcp-airwallex

@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)

Tool	Purpose
create_payment_intent	Create an Airwallex payment intent (pay-in).
confirm_payment_intent	Confirm a previously-created payment intent with a payment method.
retrieve_payment_intent	Retrieve a payment intent by id.
cancel_payment_intent	Cancel a payment intent that has not yet been captured.
capture_payment_intent	Capture a previously-authorized payment intent (two-step auth + capture flow).
list_payment_intents	List payment intents with optional filters (status, merchant_order_id, date range).
create_refund	Refund a captured payment intent (full or partial).
retrieve_refund	Retrieve a refund by id.
create_customer	Create an Airwallex customer for saved payment methods and recurring charges.
retrieve_customer	Retrieve a customer by id.
update_customer	Update fields on an existing customer (email, phone, address, metadata).
create_beneficiary	Create a transfer beneficiary (recipient) with bank details.
retrieve_beneficiary	Retrieve a beneficiary by id.
list_beneficiaries	List beneficiaries.
create_transfer	Send a cross-border transfer to a pre-created beneficiary.
retrieve_transfer	Retrieve a transfer by id.
cancel_transfer	Cancel a transfer that has not yet settled.
list_transfers	List transfers with optional filters (status, date range).
create_conversion	Execute an FX conversion between wallet currencies (e.g.
retrieve_balance	Retrieve the current wallet balance for every currency the account holds.

Install

npm install @codespar/mcp-airwallex

Environment

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'

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

# 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

Flow	Use
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