mcp-rapyd

@codespar/mcp-rapyd

Rapyd 用の MCP サーバーです。100 以上の国で、グローバルな資金回収と送金に対応します。

Rapyd は dLocal のグローバル版にあたります。dLocal がラテンアメリカに特化（15 以上の国、Pix／OXXO／PSE／SPEI）しているのに対し、Rapyd は単一の API でアジア、アフリカ、ヨーロッパ、中東、ラテンアメリカを網羅します。また、dLocal にはない次の 2 つのカテゴリに対応していることも重要です。

• 現金受け取り — 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 の 2 段階送金承認の第 2 ステップです。
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 ewallet（ユーザー）を取得します。
update_wallet	Rapyd ewallet（ユーザー）のプロフィール項目を更新します。
list_wallets	加盟店アカウントにある Rapyd ewallet を一覧表示します。
wallet_contact_verify	検証トークン（通常は SMS またはメールで受信）を送信し、ウォレット連絡先の本人確認を行います。
transfer_between_wallets	2 つの Rapyd ewallet 間で資金を移動します（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>

サーバーがソルト、タイムスタンプ、署名、冪等性キーを自動生成するため、設定が必要なのは 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（ブラジルのみ、メキシコのみ）	国別サーバー（Mercado Pago、Conekta など）

エンタープライズ

エージェントの決済にガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT