Airwallex

v0.2.0API 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

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

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.