Airwallex MCP Server

The Airwallex Developer MCP is the official Model Context Protocol server from Airwallex, built and maintained by the Airwallex Developer Experience team. It connects AI coding assistants like Claude, Cursor, Claude Code, Gemini CLI, and other MCP-compatible clients to Airwallex documentation, API reference, mobile SDK docs, and the Airwallex sandbox environment, so agents can help developers integrate Airwallex APIs without leaving their editor.

The server exposes two broad categories of capabilities. Developer tools let agents search the full Airwallex documentation set (products, API reference, mobile SDKs) to ground integration code and reduce hallucinations. Sandbox tools, gated behind sandbox API credentials, let agents perform real API calls in a test environment: managing accounts and balances, creating transfers and deposits, generating payment links, retrieving FX quotes, and configuring billing products and pricing plans.

It can be run locally via the @airwallex/developer-mcp npm package (Node.js 18+) or used as a remote connector. Airwallex hosts a docs-only remote endpoint at https://mcp-demo.airwallex.com/docs, and Claude users can install the Airwallex connector from Settings > Connectors, which uses OAuth to authenticate. Telemetry is on by default and can be disabled with DISABLE_TELEMETRY.

Tools

Prerequisites

• Node.js 18 or later (for local install)
• Airwallex sandbox account
• Sandbox Client ID and API key from Account > Developer > API keys in the Airwallex sandbox web app
• Sandbox account ID

Option 1: Local install via npx (Claude Desktop, Cursor, VS Code)

Add the server to your MCP client config:

{
  "mcpServers": {
    "airwallex-dev": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@airwallex/developer-mcp@latest"],
      "env": {
        "AIRWALLEX_SANDBOX_CLIENT_ID": "",
        "AIRWALLEX_SANDBOX_API_KEY": "",
        "AIRWALLEX_SANDBOX_ACCOUNT_ID": ""
      }
    }
  }
}

For Claude Code, the same config can be added with:

claude mcp add-json airwallex-dev '{ "type": "stdio", "command":"npx", "args": ["-y", "@airwallex/developer-mcp@latest"], "env": { "AIRWALLEX_SANDBOX_CLIENT_ID": "", "AIRWALLEX_SANDBOX_API_KEY": "", "AIRWALLEX_SANDBOX_ACCOUNT_ID": "" } }'

If you omit the sandbox env vars, only the documentation search tools will be available.

Option 2: Remote docs-only endpoint

Point your MCP client at the hosted, no-auth docs endpoint:

https://mcp-demo.airwallex.com/docs

Option 3: Claude connector

In Claude, go to Settings > Connectors, find the official Airwallex connector, and follow the OAuth flow to authenticate against your Airwallex account.

Optional environment variables

• DISABLE_TELEMETRY: set to disable telemetry (enabled by default)

Verify the connection

Send a test prompt that explicitly references Airwallex, for example: "Using Airwallex, show me how to create a test payment link in the sandbox." If the response cites Airwallex documentation or invokes an Airwallex tool, the server is connected.

• Ground AI-generated Airwallex integration code in the official docs and API reference to reduce hallucinations.
• Spin up end-to-end sandbox test flows: create a customer, generate a payment link, simulate a successful payment, and verify the resulting balance entries from inside Cursor or Claude Code.
• Build and test subscription billing flows by having the agent create billing products, pricing plans, and recurring payment links in the sandbox.
• Prototype cross-currency transfer flows: request an FX quote, create a transfer to an overseas beneficiary, and simulate status updates.
• Let an agent answer integration questions ("how do I authenticate?", "what fields does the Payment Intents API take?") using only verified Airwallex documentation via the docs-only remote endpoint.

• "Using Airwallex, show me how to create a test payment link in the sandbox for a $50 USD product."
• "Get an FX quote for converting 10,000 USD to SGD using Airwallex."
• "Create a sandbox transfer of 1,000 AUD to a beneficiary in Singapore and then simulate it being completed."
• "Set up an Airwallex billing product called Pro Plan at 29 USD per month and generate a subscription payment link."
• "Look up the Airwallex API reference for Payment Intents and draft a Node.js function that creates one."

• Official server maintained by the Airwallex Developer Experience team, not a community fork.
• Combines grounded documentation search with real sandbox API access for end-to-end integration testing.
• Multiple deployment options: local npx install, remote docs-only URL, and an OAuth-based Claude connector.
• Works across Claude, Cursor, Claude Code, Gemini CLI, and other MCP-compatible clients.

• Still in beta (current version 0.3.0-beta.x), so behavior and tool surface may change.
• Write operations are scoped to the sandbox environment; the local server is not intended for production credentials.
• No public GitHub repository, so source code is not available for inspection or community contributions; documentation lives on the Airwallex docs site.

• Stripe MCP server: official Stripe MCP server for payments, customers, and invoices.
• PayPal MCP server: PayPal's official MCP offering for payments and order management.
• Plaid MCP: financial data and ACH-focused alternative for banking integrations rather than global payments.