Mcp Rapyd

io.github.codespar由 GitHub 账号 codespar 发布v0.2.2更新于 Oct 24, 2026

MCP server for Rapyd — global collect + disburse across 100+ countries, cash pickup, wallets

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

面向 Rapyd 的本地 MCP 服务器，让助手在 100 多个国家创建和管理全球收款、付款和托管钱包。

可以做什么
创建、查询、列出、更新和取消付款，包括托管结账页面和退款，并管理客户名下已保存的支付方式。创建、查询、列出、确认和取消向收款人的付款（放款）。创建、查询、列出和更新托管钱包，验证钱包联系人，并在钱包之间转账。按国家和币种查询支持的收款与放款方式。
适用场景
适合需要借助 Rapyd 全球支付通道的场景：跨境收款与放款、为无银行账户收款人提供现金取款，以及为市场平台或创作者付款提供托管子钱包。若主要需求是拉美地区的深度本地覆盖，应优先考虑专注拉美的服务商。
运行要求
通过 npx 以 stdio 本地进程运行（需要 Node.js）；另有 HTTP 模式用于服务器间测试。需要 Rapyd 账户并设置 RAPYD_ACCESS_KEY 和 RAPYD_SECRET_KEY，可选设置 RAPYD_ENV 选择 sandbox（默认）或 production。需要访问 Rapyd API 端点的网络连接。
安装前请注意
该服务器会操作真实资金：付款、退款、放款、钱包间转账和确认都是实际金融操作，production 模式连接 Rapyd 正式 API。RAPYD_SECRET_KEY 是签名密钥，应妥善保密；访问密钥会随请求头发送。建议先在 sandbox 中测试；README 还提到另有企业版提供治理与预算限制。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Rapyd，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-rapyd

MCP server for Rapyd — global collect + disburse across 100+ countries.

Rapyd is the global counterpart to dLocal. Where dLocal is LatAm-deep (15+ countries, Pix/OXXO/PSE/SPEI), Rapyd is worldwide-wide: Asia, Africa, Europe, the Middle East, and LatAm via a single API — and crucially covers two categories dLocal doesn't:

  • Cash pickup — OXXO Pay, 7-Eleven, and country-specific cash networks for unbanked recipients
  • Managed wallets — the merchant holds a master account and provisions sub-wallets per end user (marketplace balances, creator payouts, cross-border P2P without opening a bank account per user)

Use dLocal when LatAm depth is the requirement. Use Rapyd when global reach, cash pickup, or wallet infrastructure is the requirement.

Tools (22)

ToolPurpose
create_checkout_pageCreate a Rapyd hosted checkout page.
create_paymentCreate a direct payment with a fully-specified payment_method.
get_paymentRetrieve a payment by Rapyd payment id (payment_xxx).
cancel_paymentCancel a payment that has not yet been captured/completed.
create_refundRefund a completed payment.
create_payoutCreate a payout (disbursement) to a beneficiary.
get_payoutRetrieve a payout by Rapyd payout id (payout_xxx).
confirm_payoutSecond step of Rapyd's two-step payout approval.
list_payment_methods_by_countryList all inbound (collect) payment methods Rapyd supports for a given country + currency.
list_payout_methods_by_countryList all outbound (disburse) payout method types Rapyd supports for a given beneficiary country.
create_walletCreate a Rapyd managed wallet (user) for an end user.
list_paymentsList payments with optional filters.
update_paymentUpdate metadata / descriptor / receipt details on an existing payment.
create_payment_methodSave a reusable payment method (card token, bank account, wallet) against a Rapyd customer.
delete_payment_methodRemove a saved payment method from a Rapyd customer.
list_payoutsList payouts (disbursements) with optional filters.
cancel_payoutCancel a payout that is still in 'Created' state (before confirm_payout releases funds).
get_walletRetrieve a Rapyd ewallet (user) by id.
update_walletUpdate profile fields on a Rapyd ewallet (user).
list_walletsList Rapyd ewallets under the merchant account.
wallet_contact_verifySubmit a verification token (usually received via SMS/email) to verify a wallet contact's identity.
transfer_between_walletsMove funds between two Rapyd ewallets (source_ewallet → destination_ewallet).

Install

bash
npm install @codespar/mcp-rapyd

Environment

bash
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'

Base URLs:

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

Authentication

Every request is signed with HMAC-SHA256 per Rapyd's signature recipe:

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

Required headers on every request:

Content-Type: application/jsonaccess_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>

The server handles salt, timestamp, signature, and idempotency generation automatically — you only configure RAPYD_ACCESS_KEY, RAPYD_SECRET_KEY, and (optionally) RAPYD_ENV.

Gotchas the server handles for you:

  • body_string is the compact JSON body with no whitespace, or "" when empty — never "{}".
  • url_path includes the query string when present.
  • http_method is lowercased in the signature string but UPPERCASE on the wire.

Run

bash
# 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

When to use Rapyd vs dLocal

RequirementChoose
LatAm depth (Pix, OXXO, PSE, SPEI, Boleto)dLocal
Global reach (Asia, Africa, Europe + LatAm)Rapyd
Cash pickup for unbanked recipientsRapyd
Managed wallet infrastructureRapyd
Single-country PSP (BR-only, MX-only)Per-country server (Mercado Pago, Conekta, etc)

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

来源：packages/payments/rapyd/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分