@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.
| 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="..."
AIRWALLEX_API_KEY="..."
AIRWALLEX_ENV="demo"
Base URLs:
demo → https://api-demo.airwallex.com/api/v1production → 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
npx @codespar/mcp-airwallex
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