Skip to main content
AI

Airwallex

v0.2.1API Key

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.

20 tools3 env vars🌐 GLOBALstable on npm

What your agent can do

Airwallex gives your agent 20 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

  • create_payment_intentCreate 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_intentConfirm 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_intentRetrieve a payment intent by id. Returns current status, payment_attempts, and latest payment_method.
Example call
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_payment_intent", { /* ... */ });

Install

terminal
$ npm install @codespar/mcp-airwallex

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json
{
  "mcpServers": {
    "airwallex": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-airwallex"
      ],
      "env": {
        "AIRWALLEX_CLIENT_ID": "<your_airwallex_client_id>",
        "AIRWALLEX_API_KEY": "<your_airwallex_api_key>"
      }
    }
  }
}

After restart, your agent can call any of the 20 tools below — try create_payment_intent first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

AIRWALLEX_CLIENT_ID
required

Airwallex client id (sent as x-client-id on /authentication/login)

AIRWALLEX_API_KEY
requiredsecret

Airwallex API key, secret (sent as x-api-key on /authentication/login)

AIRWALLEX_ENV
optional

Airwallex environment. 'demo' (default, https://api-demo.airwallex.com) or 'production' (https://api.airwallex.com).

Available tools · 20

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEcreate_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.
WRITEconfirm_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).
WRITEretrieve_payment_intent
Retrieve a payment intent by id. Returns current status, payment_attempts, and latest payment_method.
DELETEcancel_payment_intent
Cancel a payment intent that has not yet been captured. Fails on already-captured intents; use create_refund instead.
WRITEcapture_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.
WRITElist_payment_intents
List payment intents with optional filters (status, merchant_order_id, date range). Supports pagination via page_num / page_size.
DELETEcreate_refund
Refund a captured payment intent (full or partial). Returns the refund object with status.
DELETEretrieve_refund
Retrieve a refund by id. Returns current status (RECEIVED, ACCEPTED, PROCESSING, SUCCEEDED, FAILED).

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

Run `npx -y @codespar/mcp-airwallex` and add the config block above to your MCP client — Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Airwallex — MCP server · 20 tools | CodeSpar