mcp-airwallex

Name: mcp-airwallex
Author: codespar

本地服务

github.com/codespar金融数据2754 周前更新

代码仓库

关于 mcp-airwallex

mcp-airwallex 是 Airwallex 的 MCP 服务，覆盖跨境收款、全球账户、外汇兑换与向收款人付款。它面向在拉美地区经营、需要从海外收取 USD、EUR、GBP 并进行本地结算的卖家。与 mcp-ebanx 方向相反，二者可配合使用。

主要功能

01支付意向的创建、确认、捕获与取消
02退款与客户管理
03收款人创建与跨境转账
04外汇兑换与钱包余额查询
05每个创建类工具需传入 request_id 以保证幂等

适用场景

01拉美卖家从海外买家收取外币款项
02向境外收款人发起跨境转账
03查询钱包余额并在不同币种之间兑换

MCP 相关

该服务以工具形式向 MCP 客户端暴露 Airwallex 的支付、收款人、转账及余额操作。认证使用 Token 流程，由服务端在内存中缓存并自动刷新。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-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>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-airwallex

需要配置的环境变量

AIRWALLEX_CLIENT_IDAirwallex client id (sent as x-client-id on /authentication/login)

AIRWALLEX_API_KEY密钥Airwallex API key, secret (sent as x-api-key on /authentication/login)

AIRWALLEX_ENVAirwallex environment. 'demo' (default, https://api-demo.airwallex.com) or 'production' (https://api.airwallex.com).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@codespar/mcp-airwallex0.2.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
order	object	否	订单详情（商品、配送、类型）。结构遵循 Airwallex /pa/payment_intents/create。
amount	number	是	以主要货币单位表示的金额（例如，10.50 = 10.50 USD）
currency	string	是	ISO-4217 货币代码（USD、EUR、GBP 等）
metadata	object	否	自由格式的元数据键值对
descriptor	string	否	显示在买家账单上的账单描述
request_id	string	是	幂等键（建议使用 UUID）。幂等性由 Agent 控制——请勿重复使用。
return_url	string	否	托管流程完成后浏览器返回的 URL
customer_id	string	否	可选的 Airwallex 客户 ID（来自 create_customer），用于将支付意图关联到已保存的客户
merchant_order_id	string	是	商户侧订单引用

详细介绍

@codespar/mcp-airwallex

适用于 Airwallex 的 MCP 服务——为跨境收款和付款提供嵌入式金融服务。

EBANX 让全球平台能够从拉美收款并以 USD 结算。Airwallex 则相反：拉美卖家从海外（USD、EUR、GBP）收款至全球账户，进行外汇兑换，并向遍布 150 多个国家/地区的受益人付款。两项服务结合使用，可覆盖双向跨境资金流。

工具（20）

工具	用途
`create_payment_intent`	创建 Airwallex 付款意图（收款）。
`confirm_payment_intent`	使用付款方式确认先前创建的付款意图。
`retrieve_payment_intent`	按 ID 获取付款意图。
`cancel_payment_intent`	取消尚未扣款的付款意图。
`capture_payment_intent`	扣取先前已授权的付款意图（两步式授权 + 扣款流程）。
`list_payment_intents`	列出付款意图，可选筛选条件（状态、merchant_order_id、日期范围）。
`create_refund`	退还已扣款的付款意图（全额或部分退款）。
`retrieve_refund`	按 ID 获取退款。
`create_customer`	创建 Airwallex 客户，以保存付款方式并进行定期扣款。
`retrieve_customer`	按 ID 获取客户。
`update_customer`	更新现有客户的字段（电子邮件、电话、地址、元数据）。
`create_beneficiary`	使用银行详细信息创建转账受益人（收款人）。
`retrieve_beneficiary`	按 ID 获取受益人。
`list_beneficiaries`	列出受益人。
`create_transfer`	向已创建的受益人发送跨境转账。
`retrieve_transfer`	按 ID 获取转账。
`cancel_transfer`	取消尚未结算的转账。
`list_transfers`	列出转账，可选筛选条件（状态、日期范围）。
`create_conversion`	执行钱包币种之间的外汇兑换（例如
`retrieve_balance`	获取账户持有的每种币种的当前钱包余额。

安装

npm install @codespar/mcp-airwallex

环境

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'

基础 URL：

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

身份验证

令牌流程。首次调用时，服务会向 /authentication/login 发送 POST 请求，并附带 x-client-id 和 x-api-key 标头（不带请求体）。Airwallex 会返回 { token, expires_at }（JWT，有效期约 30 分钟）。服务会在内存中缓存令牌，并在过期前 60 秒刷新。之后的每次调用都会发送 Authorization: Bearer <token>。

幂等性

每个 create_* 工具都需要 request_id 参数。Airwallex 会将其用作幂等键。服务不会自动生成该值——Agent 必须为每个逻辑操作传入稳定的 UUID，以确保重试安全。

运行

# 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

与 EBANX 的定位对比

流程	用途
全球平台向拉美买家收款，并以 USD 结算	@codespar/mcp-ebanx
拉美卖家向全球买家收取 USD/EUR/GBP，并在当地结算	`@codespar/mcp-airwallex`

两者配合使用，可覆盖双向跨境业务。