ClaudeCodeMod
SubmitAdvertise

All shelves / MCP servers

io.github.codespar/mcp-airwallex

io.github.codespar/mcp-airwallex · 273 stars · TypeScript · MIT

MCP server MCP server for Airwallex — cross-border collection + payouts, global accounts, FX, transfers

Install

The repo has no one-line install. Follow its README.

Published as

  • npm@codespar/mcp-airwallexstdio

From the server's entry in the official MCP Registry.

Open the repo

Configuration

NameSet asWhat it is
AIRWALLEX_CLIENT_IDRequiredEnv varAirwallex client id (sent as x-client-id on /authentication/login)
AIRWALLEX_API_KEYRequired · SecretEnv varAirwallex API key, secret (sent as x-api-key on /authentication/login)
AIRWALLEX_ENVOptionalEnv varAirwallex environment. 'demo' (default, https://api-demo.airwallex.com) or 'production' (https://api.airwallex.com).

Files

packages/payments/airwallex/README.md

@codespar/mcp-airwallex

MCP server for Airwallex — embedded finance for cross-border collection and payouts.

EBANX lets global platforms collect FROM LatAm and settle to USD. Airwallex is the inverse: LatAm sellers collect FROM abroad (USD, EUR, GBP) into global accounts, convert FX, and pay beneficiaries out across 150+ countries. Together the two servers bracket the cross-border flow both ways.

Tools (20)

Tool Purpose
create_payment_intent Create an Airwallex payment intent (pay-in).
confirm_payment_intent Confirm a previously-created payment intent with a payment method.
retrieve_payment_intent Retrieve a payment intent by id.
cancel_payment_intent Cancel a payment intent that has not yet been captured.
capture_payment_intent Capture a previously-authorized payment intent (two-step auth + capture flow).
list_payment_intents List payment intents with optional filters (status, merchant_order_id, date range).
create_refund Refund a captured payment intent (full or partial).
retrieve_refund Retrieve a refund by id.
create_customer Create an Airwallex customer for saved payment methods and recurring charges.
retrieve_customer Retrieve a customer by id.
update_customer Update fields on an existing customer (email, phone, address, metadata).
create_beneficiary Create a transfer beneficiary (recipient) with bank details.
retrieve_beneficiary Retrieve a beneficiary by id.
list_beneficiaries List beneficiaries.
create_transfer Send a cross-border transfer to a pre-created beneficiary.
retrieve_transfer Retrieve a transfer by id.
cancel_transfer Cancel a transfer that has not yet settled.
list_transfers List transfers with optional filters (status, date range).
create_conversion Execute an FX conversion between wallet currencies (e.g.
retrieve_balance Retrieve the current wallet balance for every currency the account holds.

Install

npm install @codespar/mcp-airwallex

Environment

AIRWALLEX_CLIENT_ID="..."   # x-client-id header on /authentication/login
AIRWALLEX_API_KEY="..."     # x-api-key header on /authentication/login (secret)
AIRWALLEX_ENV="demo"        # 'demo' (default) or 'production'

Base URLs:

  • demo → https://api-demo.airwallex.com/api/v1
  • production → https://api.airwallex.com/api/v1

Authentication

Token flow. On first call the server POSTs to /authentication/login with headers x-client-id and x-api-key (no body). Airwallex returns { token, expires_at } (JWT, ~30 min lifetime). The server caches the token in memory and refreshes it 60 seconds before expiry. Every subsequent call sends Authorization: Bearer <token>.

Idempotency

Every create_* tool takes a required request_id parameter. Airwallex uses this as the idempotency key. The server never auto-generates it — agents must pass a stable UUID per logical operation so retries are safe.

Run

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-airwallex

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-airwallex

Positioning vs EBANX

Flow Use
Global platform collecting from LatAm buyers, settling to USD @codespar/mcp-ebanx
LatAm seller collecting from global buyers in USD/EUR/GBP, settling locally @codespar/mcp-airwallex

Pair both for bidirectional cross-border coverage.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Facts

Kind
MCP server
Repo
codespar/mcp-dev-latam
Group
Uncategorized
Stars
273
License
MIT
Language
TypeScript
Last push
2026-09-27
Forks
50
MCP Registry
io.github.codespar/mcp-airwallex
Homepage
codespar.dev/servers
Topics
agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix

More on this shelf

  1. 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
  2. 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
  3. 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
  4. 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
  5. 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
  6. 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k