Skip to main content
R

Rapyd

@codespar/mcp-rapyd Β· v0.2.2

🌐 GlobalPaymentsAuth · API Keybeta22 tools3 env vars

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.

Get started Β· freeView docs

MIT Β· runs locally with your own credentials

Limitations

  • Hosted calls with a test key are not available: the runtime has not recorded this provider's test behaviour (test venue unclassified).
Package
@codespar/mcp-rapyd
Version
0.2.2
npm dist-tag
latest
Category
Payments
Auth
API Key
Country
🌐 Global
License
MIT
Transport
stdio Β· streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables3 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 22 tools. Try create_checkout_page first.
terminal
# Claude Code claude mcp add rapyd -e RAPYD_ACCESS_KEY=… -e RAPYD_ENV=… -e RAPYD_SECRET_KEY=… -- npx -y @codespar/mcp-rapyd@0.2.2 # then: /mcp to confirm the server is connected
Environment variables3 variables
RAPYD_ACCESS_KEYRapyd access key (sent in the access_key header)required
RAPYD_ENVRapyd environment: 'sandbox' (https://sandboxapi.rapyd.net) or 'production' (https://api.rapyd.net). Defaults to sandbox.optional
RAPYD_SECRET_KEYRapyd secret key used to sign HMAC-SHA256 requests (never transmitted)requiredsecret

Names read from the package code (@codespar/mcp-rapyd@0.2.2). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call democreate_checkout_page

"Create a Rapyd hosted checkout page. Returns a redirect_url the payer opens in a browser. Rapyd renders the appropriate local methods"

tools/callcreate_checkout_pageresult returned

Tools

What your agent can call.

22 tools, as the package's tools/list returns them.

create_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.

create_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.

get_payment

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

cancel_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.

create_refund

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

create_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.

get_payout

Retrieve a payout by Rapyd payout id (payout_xxx).

confirm_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.

list_payment_methods_by_country

List all inbound (collect) payment methods Rapyd supports for a given country + currency. Use to dynamically discover local methods (OXXO in MX, Pix in BR, UPI in IN, MoMo in GH) rather than hard-coding.

list_payout_methods_by_country

List all outbound (disburse) payout method types Rapyd supports for a given beneficiary country. Returns the payout_method_type strings you pass to create_payout and the required beneficiary/sender field shapes for each.

create_wallet

Create a Rapyd managed wallet (user) for an end user. Rapyd's wallet differentiator: the merchant holds a master account and provisions sub-wallets per end user, enabling marketplace balances, creator payouts, and cross-border P2P without opening bank accounts per user. Returns an ewallet id (ewallet_xxx).

list_payments

List payments with optional filters. Returns a paginated slice β€” use starting_after / ending_before cursors for the next page. Handy for reconciliation and dashboards.

Names and descriptions come from the package's tools/list (@codespar/mcp-rapyd@0.2.2). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

codespar_discover lists this server's tools, but a project with a test key cannot call them yet: the runtime has not recorded what this provider does in test mode, and refuses rather than guess.

Protocol

Any MCP client

stdio Β· streamable-http

Questions

Before you install.

How do I install the Rapyd MCP server?

Run npx -y @codespar/mcp-rapyd@0.2.2 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Rapyd?

Rapyd exposes 22 tools for payments. Your agent calls them directly; the full list is above.

How does Rapyd authenticate, and how are credentials stored?

Rapyd uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Rapyd handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.2, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Rapyd open source? How do I report a bug?

Yes. Rapyd is MIT-licensed and published on npm as @codespar/mcp-rapyd, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
Rapyd β€” MCP server Β· 22 tools | CodeSpar