Rapyd

v0.2.0API Key

Global 100+ country collect + disburse platform. Complements dLocal (LatAm-focused) with cash pickup (OXXO Pay, 7-Eleven) and merchant-managed wallets — unique vs other servers in the catalog.

22 tools3 env vars🌐 GLOBALstable on npm

Install

terminal

$ npm install @codespar/mcp-rapyd

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "rapyd": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-rapyd"
      ],
      "env": {
        "RAPYD_ACCESS_KEY": "<your_rapyd_access_key>",
        "RAPYD_SECRET_KEY": "<your_rapyd_secret_key>"
      }
    }
  }
}

After restart, your agent can call any of the 22 tools below — try create_checkout_page first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

RAPYD_ACCESS_KEY

required

Rapyd access key (sent in the access_key header)

RAPYD_SECRET_KEY

requiredsecret

Rapyd secret key used to sign HMAC-SHA256 requests (never transmitted)

RAPYD_ENV

optional

Rapyd environment: 'sandbox' (https://sandboxapi.rapyd.net) or 'production' (https://api.rapyd.net). Defaults to sandbox.

Available tools · 22

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEcreate_checkout_page

Create a Rapyd hosted checkout page. Returns a redirect_url the payer opens in a browser. Rapyd renders the appropriate local methods (cards, cash pickup, bank transfer, wallets) for the country + currency combination, so one call supports 100+ countries.

WRITEcreate_payment

Create a direct payment with a fully-specified payment_method. Use when you already have a payment_method id/token or when you want server-to-server flow without the hosted page. For voucher/cash methods the response contains redirect/display data.

WRITEget_payment

Retrieve a payment by Rapyd payment id (payment_xxx). Returns status, amount, method, and any next-action data.

DELETEcancel_payment

Cancel a payment that has not yet been captured/completed. For auth-only card payments this voids the auth; for pending redirect payments it cancels the expectation.

DELETEcreate_refund

Refund a completed payment. Omit amount for a full refund or set amount for partial.

WRITEcreate_payout

Create a payout (disbursement) to a beneficiary. Rapyd supports bank transfer, wallet top-up, and cash pickup (OXXO Pay, 7-Eleven, etc). Use list_payout_methods_by_country first to find the right payout_method_type for the destination country.

WRITEget_payout

Retrieve a payout by Rapyd payout id (payout_xxx).

WRITEconfirm_payout

Second step of Rapyd's two-step payout approval. After create_payout returns a payout in 'Created' state, call confirm_payout to release funds. Used when your Rapyd account requires dual-approval.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.