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

License

MIT