Developer connectors

The Airwallex developer connectors connects AI coding agents — Cursor, Claude Code, Codex, and similar tools — to Airwallex documentation and the Airwallex sandbox. Use it while you build and test an integration so your agent writes more accurate Airwallex code and can exercise the sandbox without leaving your editor.

The toolkit provides two MCP servers:

Developer MCP vs. Docs MCP

• Use Docs MCP when your agent only needs to look up Airwallex documentation and API references. It requires no authentication and is safe to add to any agent.
• Use Developer MCP when you also want the agent to create test resources, simulate events, and call sandbox endpoints. It includes everything Docs MCP does, plus sandbox tools.

Benefits

• Faster information retrieval: Agents fetch documentation and API references directly in the coding environment, with access to your codebase for context.
• Reduced hallucination: Connecting agents to current Airwallex documentation and API surfaces reduces the rate of incorrect or outdated code.
• Build and test in one place: Create test resources, simulate events, and run sandbox reads through natural language prompts without context-switching.

Limitations

• Model dependency: Quality varies by model. Different AI assistants produce different results, and no model is perfect.
• Sandbox only: The Developer MCP testing tools run in sandbox only. For production reads and writes, use the Airwallex CLI or Airwallex MCP.
• Hallucination reduction, not elimination: Generated code and recommendations must always be reviewed, validated, and tested before use in production.

Install Developer MCP

Developer MCP is the sandbox MCP server. It exposes documentation tools, sandbox simulation tools, and certain endpoints.

Before you begin

• A compatible AI assistant installed (Cursor, Claude Code, or other MCP-compatible tool).
• Network access to https://mcp-demo.airwallex.com/developer.
• A sandbox account if you want to use the remote endpoint.

Cursor

You can use one-click installation links or manual configuration. Documentation and sandbox tools at the remote endpoint. Cursor initiates OAuth to authenticate with Airwallex.

Or manually add to your Cursor MCP settings:

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

Claude Code

You can use a one-click installation command or manual configuration. Documentation and sandbox tools at the remote endpoint. Claude Code initiates OAuth to authenticate with Airwallex.

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

Claude.ai / Claude Cowork

Connect using the built-in Airwallex Developer connector.

Find the official Airwallex Developer connector from Settings > Connectors.

When you try to connect, Claude initiates an OAuth flow to authenticate with Airwallex.

Gemini CLI

Add the following configuration to your Gemini CLI MCP settings. Gemini CLI initiates OAuth to authenticate with Airwallex.

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

OpenAI Codex

Add the following to your OpenAI Codex MCP settings. Codex initiates OAuth to authenticate with Airwallex.

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

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. Lovable initiates OAuth to authenticate with Airwallex.

V0

V0 by Vercel is a web-based AI coding agent. V0 does not support the Developer MCP remote endpoint today. Use the Docs MCP for documentation-only access, or another coding agent if you need sandbox tools.

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. Repl.it initiates OAuth to authenticate with Airwallex.

Install Docs MCP

Docs MCP is a documentation-only MCP server. It exposes the same documentation search tools as Developer MCP and requires no authentication. Use Docs MCP when your agent only needs to look up Airwallex docs, or when authentication is not available in the host environment.

Cursor

Or manually add to your Cursor MCP settings:

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

Claude Code

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

Claude.ai / Claude Cowork

Add a custom connector. From Settings > Connectors > Add custom connector, use https://mcp-demo.airwallex.com/docs as the Remote MCP server URL.

Gemini CLI

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

OpenAI Codex

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

Lovable

Configure the MCP server in your Lovable project settings using https://mcp-demo.airwallex.com/docs.

V0

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

Repl.it

Configure the MCP server in your Repl.it project settings using https://mcp-demo.airwallex.com/docs.

Available MCP tools

The two servers expose different tools:

For the full tool listing, prompting best practices, and troubleshooting, see Build with AI.

Verify your connection

After setup, confirm the connector is working:

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

• Build with AI — full tools reference, prompting best practices, and troubleshooting.
• Airwallex AgentOS — when you need agents to act on your production account.
• Airwallex CLI — production reads and writes from a terminal or script.