# mcp-airwallex

Wires the Airwallex API into your coding agent: 20 tools for pay-ins, refunds, cross-border transfers and FX.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/airwallex
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-airwallex

## What it does

This server exposes Airwallex to the agent. It creates and confirms payment intents, supports the two-step auth-then-capture flow, issues full or partial refunds, manages customers and transfer beneficiaries, sends payouts and converts between wallet currencies. One more tool returns the balance for every currency the account holds.

Auth runs on a token. The first call logs in with `AIRWALLEX_CLIENT_ID` and `AIRWALLEX_API_KEY`, the token stays cached in memory and is renewed a minute before it lapses. You need an Airwallex account and both keys to start. `AIRWALLEX_ENV` picks demo or production, and `demo` is what you get when you leave it out — ship that to production and your requests hit the sandbox.

Every `create_*` tool demands a `request_id` used as the idempotency key. The server will not make one up. Pass the same UUID when you retry the same logical operation, otherwise a retry becomes a second payment. That is the part to get right first.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `AIRWALLEX_CLIENT_ID`, `AIRWALLEX_API_KEY`, `AIRWALLEX_ENV` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env AIRWALLEX_CLIENT_ID=<AIRWALLEX_CLIENT_ID> --env AIRWALLEX_API_KEY=<AIRWALLEX_API_KEY> --env AIRWALLEX_ENV=<AIRWALLEX_ENV> --transport stdio airwallex -- npx -y @codespar/mcp-airwallex
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add airwallex --env AIRWALLEX_CLIENT_ID=<AIRWALLEX_CLIENT_ID> --env AIRWALLEX_API_KEY=<AIRWALLEX_API_KEY> --env AIRWALLEX_ENV=<AIRWALLEX_ENV> -- npx -y @codespar/mcp-airwallex
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "airwallex": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-airwallex"
            ],
            "env": {
                "AIRWALLEX_CLIENT_ID": "<AIRWALLEX_CLIENT_ID>",
                "AIRWALLEX_API_KEY": "<AIRWALLEX_API_KEY>",
                "AIRWALLEX_ENV": "<AIRWALLEX_ENV>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "airwallex": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-airwallex"
            ],
            "env": {
                "AIRWALLEX_CLIENT_ID": "<AIRWALLEX_CLIENT_ID>",
                "AIRWALLEX_API_KEY": "<AIRWALLEX_API_KEY>",
                "AIRWALLEX_ENV": "<AIRWALLEX_ENV>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e AIRWALLEX_CLIENT_ID=<AIRWALLEX_CLIENT_ID> -e AIRWALLEX_API_KEY=<AIRWALLEX_API_KEY> -e AIRWALLEX_ENV=<AIRWALLEX_ENV> airwallex npx -y @codespar/mcp-airwallex
```
Replace <…> with your own values

## When to use it
- create a payment intent and capture it in two steps
- refund a captured payment fully or in part
- register a beneficiary with bank details
- send a cross-border transfer and cancel it before settlement
- check the wallet balance in every currency

## Example prompts
- Create a payment intent for 250 USD for customer `cus_123` and give me the id
- Refund half of captured payment `pi_456`
- Show the Airwallex wallet balance across all currencies

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md