@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