@airwallex/developer-mcp
Deprecated: This local npm package is deprecated. Use the hosted Remote MCP server instead (OAuth, streamable HTTP, and ongoing feature support).
The Airwallex Developer Model Context Protocol (MCP) server empowers AI coding agents with the tools they need to assist developers integrating with Airwallex APIs. It enables agents to search Airwallex documentation and interact with the sandbox environment for testing and simulation.
Installation
Cursor
{
"mcpServers": {
"airwallex-dev": {
"command": "npx",
"args": ["-y", "@airwallex/developer-mcp@latest"],
"env": {
"AIRWALLEX_SANDBOX_CLIENT_ID": "",
"AIRWALLEX_SANDBOX_API_KEY": "",
"AIRWALLEX_SANDBOX_ACCOUNT_ID": ""
}
}
}
}
Claude Code
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": "" } }'
Gemini CLI
{
"mcpServers": {
"airwallex-dev": {
"command": "npx",
"args": ["-y", "@airwallex/developer-mcp@latest"],
"env": {
"AIRWALLEX_SANDBOX_CLIENT_ID": "",
"AIRWALLEX_SANDBOX_API_KEY": "",
"AIRWALLEX_SANDBOX_ACCOUNT_ID": ""
}
}
}
}
OpenAI Codex
[mcp_servers.airwallex-dev]
command = "npx"
args = ["-y", "@airwallex/developer-mcp@latest"]
[mcp_servers.airwallex-dev.env]
AIRWALLEX_SANDBOX_CLIENT_ID = ""
AIRWALLEX_SANDBOX_API_KEY = ""
AIRWALLEX_SANDBOX_ACCOUNT_ID = ""
Example prompts
Integrate Airwallex's Drop-in element with this website
Using Airwallex, can you find me test card numbers for the 3DS authentication failure case?
I tried to make a payout with Airwallex and got this error: amount_below_transfer_method_limit. What does that mean?
With sandbox tools
Can you create a new billing plan on Airwallex called Startup for $29.99/month and create a hosted URL to subscribe to it?
Environment variables
To access sandbox tools, ensure that your sandbox API credentials are set using the following environment variables. If you don't already have a sandbox account, create one using this link.
| Name | Description | Default | Required |
|---|---|---|---|
AIRWALLEX_SANDBOX_API_KEY | The API key, either an admin key or a scoped key with limited permissions, generated in the sandbox environment. Note that the sandbox tools work as expected only if the API key has the required permissions to access the underlying APIs. | N/A | No |
AIRWALLEX_SANDBOX_CLIENT_ID | The client ID associated with the API key generated in the sandbox environment. | N/A | No |
AIRWALLEX_SANDBOX_ACCOUNT_ID | Specifies the account ID for a scoped API key that can either access both organization & account resources or resources belonging to multiple accounts of an organization. Starts with acct_. | N/A | No |
DISABLE_TELEMETRY | Set this variable to true to opt out of telemetry. | 0 | No |
Tools
Developer tools
| Name | Description |
|---|---|
search_public_docs | Search the Airwallex documentation. Covers the following sources: Product docs, API reference, Airwallex.js, Payments iOS and Android SDKs |
Sandbox tools
All data retrieved and actions performed with the tools below are in the authenticated Sandbox account.
| Name | Description |
|---|---|
list_global_accounts | List all available global accounts |
get_balances | List balances in all currencies |
simulate_create_deposit | Simulate a deposit to an available global account |
list_billing_products | List available billing products |
list_billing_prices | List available billing prices |
create_billing_product | Create a new billing product |
create_billing_price | Create a new billing price |
create_billing_checkout | Create a new hosted billing checkout page |
get_fx_quote | Get a quote for a FX conversion |
list_transfers | List transfers initiated |
create_transfer | Initiate a new transfer to a recipient |
list_beneficiaries | List available transfer recipients |
simulate_transfer_result | Simulate the status of a transfer |
create_payment_link | Create a new payment link |
list_payment_links | List created payment links |
get_default_api_version | Get the default API version associated with the account or organization. |
Disclaimer
This MCP server can help minimize hallucinations in Airwallex-related integration code produced by your coding agent but does not eliminate hallucinations entirely. Please always review, validate, and thoroughly test any AI-generated code before deploying it to production.
Feedback
This MCP server is developed and maintained by the Airwallex Developer Experience team. We welcome your feedback — please contact us at [email protected]. Remember to mention the AI model your coding agent was connected to.
Telemetry
Telemetry is enabled by default. To disable telemetry, set the DISABLE_TELEMETRY environment variable to true.
Telemetry data includes:
- MCP tool usage events
- MCP client name & version (when available)
- Stable device identifier and device OS
- The
AIRWALLEX_SANDBOX_CLIENT_IDif configured (defaults tounknownwhen not set)