Skip to main content
A

Airwallex

@codespar/mcp-airwallex Β· v0.2.2

🌐 GlobalPaymentsAuth · API Keybeta20 tools3 env vars

Cross-border inverse of EBANX β€” LatAm sellers collect from abroad (USD/EUR/GBP) and settle locally. Payment intents, refunds, beneficiaries, transfers, FX conversions, multi-currency balances.

Get started Β· freeView docs

MIT Β· runs locally with your own credentials

Limitations

  • Hosted calls with a test key are not available: the runtime has not recorded this provider's test behaviour (test venue unclassified).
Package
@codespar/mcp-airwallex
Version
0.2.2
npm dist-tag
latest
Category
Payments
Auth
API Key
Country
🌐 Global
License
MIT
Transport
stdio Β· streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables3 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 20 tools. Try create_payment_intent first.
terminal
# Claude Code claude mcp add airwallex -e AIRWALLEX_API_KEY=… -e AIRWALLEX_CLIENT_ID=… -e AIRWALLEX_ENV=… -- npx -y @codespar/mcp-airwallex@0.2.2 # then: /mcp to confirm the server is connected
Environment variables3 variables
AIRWALLEX_API_KEYAirwallex API key, secret (sent as x-api-key on /authentication/login)requiredsecret
AIRWALLEX_CLIENT_IDAirwallex client id (sent as x-client-id on /authentication/login)required
AIRWALLEX_ENVAirwallex environment. 'demo' (default, https://api-demo.airwallex.com) or 'production' (https://api.airwallex.com).optional

Names read from the package code (@codespar/mcp-airwallex@0.2.2). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call democreate_payment_intent

"Create an Airwallex payment intent"

tools/callcreate_payment_intentresult returned

Tools

What your agent can call.

20 tools, as the package's tools/list returns them.

create_payment_intent

Create an Airwallex payment intent (pay-in). Used when a LatAm seller needs to collect USD/EUR/GBP from buyers abroad. Returns the intent with client_secret for client-side confirmation.

confirm_payment_intent

Confirm a previously-created payment intent with a payment method. For card intents this triggers authorization; for APM intents this returns a next_action (redirect, QR, etc).

retrieve_payment_intent

Retrieve a payment intent by id. Returns current status, payment_attempts, and latest payment_method.

cancel_payment_intent

Cancel a payment intent that has not yet been captured. Fails on already-captured intents; use create_refund instead.

capture_payment_intent

Capture a previously-authorized payment intent (two-step auth + capture flow). Use this after confirm_payment_intent on intents created with capture_method=manual. Amount may be less than authorized for partial capture.

list_payment_intents

List payment intents with optional filters (status, merchant_order_id, date range). Supports pagination via page_num / page_size.

create_refund

Refund a captured payment intent (full or partial). Returns the refund object with status.

retrieve_refund

Retrieve a refund by id. Returns current status (RECEIVED, ACCEPTED, PROCESSING, SUCCEEDED, FAILED).

create_customer

Create an Airwallex customer for saved payment methods and recurring charges. Returns a customer object whose id can be passed into create_payment_intent.customer_id.

retrieve_customer

Retrieve a customer by id. Returns the customer profile plus metadata.

update_customer

Update fields on an existing customer (email, phone, address, metadata). Immutable fields like merchant_customer_id cannot be changed.

create_beneficiary

Create a transfer beneficiary (recipient) with bank details. Required before sending cross-border payouts via create_transfer. Entity type, bank details fields, and required IDs vary by destination country.

Names and descriptions come from the package's tools/list (@codespar/mcp-airwallex@0.2.2). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

codespar_discover lists this server's tools, but a project with a test key cannot call them yet: the runtime has not recorded what this provider does in test mode, and refuses rather than guess.

Protocol

Any MCP client

stdio Β· streamable-http

Questions

Before you install.

How do I install the Airwallex MCP server?

Run npx -y @codespar/mcp-airwallex@0.2.2 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Airwallex?

Airwallex exposes 20 tools for payments. Your agent calls them directly; the full list is above.

How does Airwallex authenticate, and how are credentials stored?

Airwallex uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Airwallex handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.2, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Airwallex open source? How do I report a bug?

Yes. Airwallex is MIT-licensed and published on npm as @codespar/mcp-airwallex, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
Airwallex β€” MCP server Β· 20 tools | CodeSpar