Set up Developer MCP

To connect a compatible AI assistant to the Airwallex Developer Model Context Protocol (MCP) server and search Airwallex documentation or run sandbox operations from your coding environment, complete the steps in this guide.

Before you begin

Before you connect your AI assistant to the Developer MCP server, ensure you have:

• A compatible AI assistant installed (Cursor, Claude Code, or other MCP-compatible tool).
• Network access to https://mcp-demo.airwallex.com.
• A sandbox account if you want to use the remote /developer endpoint or the local server.
• Sandbox API credentials (Client ID and API Key) if you want to use the local server.
• Node.js version 18.x or later installed and available on your PATH if you want to use the local server.

Connect your AI assistant

Cursor

You can use one-click installation links or manual configuration.

Developer
Docs
Local

Documentation and sandbox tools at /developer. Cursor initiates OAuth to authenticate with Airwallex.

Or manually add to your Cursor MCP settings:

JSON

1{
2  "mcpServers": {
3    "airwallex-dev": {
4      "type": "http",
5      "url": "https://mcp-demo.airwallex.com/developer"
6    }
7  }
8}

Documentation-only access at /docs, without authentication.

Or manually add to your Cursor MCP settings:

JSON

1{
2  "mcpServers": {
3    "airwallex-docs": {
4      "type": "http",
5      "url": "https://mcp-demo.airwallex.com/docs"
6    }
7  }
8}

Full tool access including billing tools, without OAuth.

Or manually add the following to your Cursor MCP settings and fill in your sandbox credentials:

JSON

1{
2  "mcpServers": {
3    "airwallex-dev": {
4      "command": "npx",
5      "args": ["-y", "@airwallex/developer-mcp@latest"],
6      "env": {
7        "AIRWALLEX_SANDBOX_CLIENT_ID": "",
8        "AIRWALLEX_SANDBOX_API_KEY": "",
9        "AIRWALLEX_SANDBOX_ACCOUNT_ID": ""
10      }
11    }
12  }
13}

Claude Code

You can use one-click installation commands or manual configuration.

1claude mcp add-json airwallex-dev '{ "type": "http", "url": "https://mcp-demo.airwallex.com/developer" }'

1claude mcp add-json airwallex-docs '{ "type": "http", "url": "https://mcp-demo.airwallex.com/docs" }'

1claude 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": "" } }'

Claude.ai/Claude Desktop

Connect using the built-in Airwallex Developer connector or a custom connector for documentation-only access.

Gemini CLI

Add the MCP configuration to your Gemini CLI MCP settings file.

1{
2  "mcpServers": {
3    "airwallex-dev": {
4      "type": "http",
5      "url": "https://mcp-demo.airwallex.com/developer"
6    }
7  }
8}

1{
2  "mcpServers": {
3    "airwallex-docs": {
4      "type": "http",
5      "url": "https://mcp-demo.airwallex.com/docs"
6    }
7  }
8}

1{
2  "mcpServers": {
3    "airwallex-dev": {
4      "command": "npx",
5      "args": ["-y", "@airwallex/developer-mcp@latest"],
6      "timeout": 30000,
7      "env": {
8        "AIRWALLEX_SANDBOX_CLIENT_ID": "",
9        "AIRWALLEX_SANDBOX_API_KEY": "",
10        "AIRWALLEX_SANDBOX_ACCOUNT_ID": ""
11      }
12    }
13  }
14}

OpenAI Codex

Add the MCP configuration to your OpenAI Codex MCP settings file.

1[mcp_servers.airwallex-dev]
2type = "http"
3url = "https://mcp-demo.airwallex.com/developer"

1[mcp_servers.airwallex-docs]
2type = "http"
3url = "https://mcp-demo.airwallex.com/docs"

1[mcp_servers.airwallex-dev]
2command = "npx"
3args = ["-y", "@airwallex/developer-mcp@latest"]
4
5[mcp_servers.airwallex-dev.env]
6AIRWALLEX_SANDBOX_CLIENT_ID = ""
7AIRWALLEX_SANDBOX_API_KEY = ""
8AIRWALLEX_SANDBOX_ACCOUNT_ID = ""

Lovable

Lovable is a web-based coding agent that only supports remote MCP servers. MCP server support requires a paid plan. Connect using the MCP server settings in your Lovable project.

V0

V0 by Vercel is a web-based AI coding agent that only supports remote MCP servers. MCP server support requires a paid plan. Connect using the MCP server settings in your V0 project.

1{
2  "mcpServers": {
3    "airwallex-docs": {
4      "type": "http",
5      "url": "https://mcp-demo.airwallex.com/docs"
6    }
7  }
8}

Repl.it

Repl.it is a web-based AI coding agent that only supports remote MCP servers. Connect using the MCP server settings in your Repl.it project.

Configure the local server

Add the following environment variables to the env block in your MCP settings and fill in your sandbox credentials:

Verify your connection

After setup, confirm the MCP server is connected before using it:

1. Check that the Airwallex server appears in your editor's MCP configuration or settings panel.
2. Send a test prompt that explicitly mentions Airwallex, for example: "Using Airwallex, show me how to create a test payment link in the sandbox."
3. If the response references Airwallex documentation or invokes an Airwallex tool, the connection is working.

Next steps

Now that your AI assistant is connected, learn how to write effective prompts, explore the available tools, and troubleshoot common issues: Build integrations with Developer MCP.