mcp-rapyd

@codespar/mcp-rapyd

适用于 Rapyd 的 MCP 服务 — 面向 100 多个国家/地区提供全球收款和付款服务。

Rapyd 是 dLocal 的全球对应方案。dLocal 深耕拉美（15 个以上国家/地区，支持 Pix/OXXO/PSE/SPEI），Rapyd 则覆盖全球：通过单一 API 服务亚洲、非洲、欧洲、中东和拉美 — 更重要的是，它还支持 dLocal 不具备的两类服务：

• 现金领取 — OXXO Pay、7-Eleven，以及针对未开户收款人的各国家/地区专属现金网络
• 托管钱包 — 商户持有主账户，并为每位最终用户开设子钱包（市场余额、创作者付款，以及无需为每位用户开立银行账户的跨境 P2P）

需要深入覆盖拉美时使用 dLocal。需要全球覆盖、现金领取或钱包基础设施时使用 Rapyd。

工具（22 个）

工具	用途
create_checkout_page	创建 Rapyd 托管结账页面。
create_payment	使用完整指定的 payment_method 创建直接付款。
get_payment	根据 Rapyd 付款 ID（payment_xxx）检索付款。
cancel_payment	取消尚未捕获/完成的付款。
create_refund	退还已完成的付款。
create_payout	向受益人创建一笔付款（出款）。
get_payout	根据 Rapyd 出款 ID（payout_xxx）检索出款。
confirm_payout	Rapyd 两步出款审批的第二步。
list_payment_methods_by_country	列出 Rapyd 针对指定国家/地区和货币支持的所有入站（收款）付款方式。
list_payout_methods_by_country	列出 Rapyd 针对指定受益人国家/地区支持的所有出站（付款）方式类型。
create_wallet	为最终用户创建 Rapyd 托管钱包（用户）。
list_payments	列出付款，可选使用筛选条件。
update_payment	更新现有付款的元数据/描述信息/收据详情。
create_payment_method	将可重复使用的付款方式（卡令牌、银行账户、钱包）保存到 Rapyd 客户名下。
delete_payment_method	从 Rapyd 客户名下移除已保存的付款方式。
list_payouts	列出出款（付款），可选使用筛选条件。
cancel_payout	取消仍处于 'Created' 状态的出款（在 confirm_payout 放款之前）。
get_wallet	根据 ID 检索 Rapyd 电子钱包（用户）。
update_wallet	更新 Rapyd 电子钱包（用户）的个人资料字段。
list_wallets	列出商户账户下的 Rapyd 电子钱包。
wallet_contact_verify	提交验证令牌（通常通过短信/电子邮件接收），以验证钱包联系人的身份。
transfer_between_wallets	在两个 Rapyd 电子钱包之间转移资金（source_ewallet → destination_ewallet）。

安装

npm install @codespar/mcp-rapyd

环境

RAPYD_ACCESS_KEY="..."   # Public access key (sent in the access_key header)
RAPYD_SECRET_KEY="..."   # Secret key (used to sign requests; never transmitted)
RAPYD_ENV="sandbox"      # Optional. 'sandbox' (default) or 'production'

基础 URL：

• sandbox → https://sandboxapi.rapyd.net
• production → https://api.rapyd.net

身份验证

每个请求都会按照 Rapyd 的签名规则使用 HMAC-SHA256 签名：

toSign    = http_method_lowercase + url_path + salt + timestamp + access_key + secret_key + body_string
hmac_hex  = HMAC-SHA256(secret_key, toSign).digest('hex')
signature = Buffer.from(hmac_hex).toString('base64')   // hex → base64, not raw digest

每个请求都必须包含以下标头：

Content-Type: application/json
access_key:   <access_key>
salt:         <random 8-16 char string, unique per request>
timestamp:    <Unix seconds, within 60s of server time>
signature:    <computed per recipe above>
idempotency:  <unique per request>

服务会自动处理 salt、timestamp、signature 和幂等性生成 — 你只需配置 RAPYD_ACCESS_KEY、RAPYD_SECRET_KEY，以及（可选的）RAPYD_ENV。

服务会替你处理的注意事项：

• body_string 是不含空白字符的紧凑 JSON 请求体；请求体为空时为 "" — 绝不能是 "{}"。
• 存在查询字符串时，url_path 会包含该字符串。
• http_method 在签名字符串中会转换为小写，但通过网络发送时使用大写。

运行

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

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

何时选择 Rapyd 而非 dLocal

需求	选择
深入覆盖拉美（Pix、OXXO、PSE、SPEI、Boleto）	dLocal
全球覆盖（亚洲、非洲、欧洲 + 拉美）	Rapyd
为未开户收款人提供现金领取服务	Rapyd
托管钱包基础设施	Rapyd
单一国家/地区的 PSP（仅 BR、仅 MX）	各国家/地区的服务（Mercado Pago、Conekta 等）

企业版

需要为 Agent 付款提供治理、预算限制和审计记录？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、付款路由和合规模板。

许可证

MIT