# mcp-rapyd

Connects Rapyd to AI coding clients for payments, payouts, refunds, and managed wallets. Useful for global collection, cash pickup, and marketplace balances.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/rapyd
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-rapyd

## What it does

mcp-rapyd exposes Rapyd operations through MCP tools. An agent can create hosted checkout pages, direct payments, refunds, and beneficiary payouts, then retrieve or cancel those records. It can also list country-specific payment and payout methods and save reusable payment methods for customers.

Wallet tools cover user wallet creation, profile updates, contact verification, wallet listing, and transfers between wallets. The server builds Rapyd request signatures and generates salt, timestamps, and idempotency values itself. Set `RAPYD_ACCESS_KEY` and `RAPYD_SECRET_KEY` before use; `RAPYD_ENV` selects `sandbox` or `production`, with `sandbox` as the default. Without the two keys, Rapyd requests cannot be signed.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `RAPYD_ACCESS_KEY`, `RAPYD_SECRET_KEY`, `RAPYD_ENV` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env RAPYD_ACCESS_KEY=<RAPYD_ACCESS_KEY> --env RAPYD_SECRET_KEY=<RAPYD_SECRET_KEY> --env RAPYD_ENV=<RAPYD_ENV> --transport stdio rapyd -- npx -y @codespar/mcp-rapyd
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add rapyd --env RAPYD_ACCESS_KEY=<RAPYD_ACCESS_KEY> --env RAPYD_SECRET_KEY=<RAPYD_SECRET_KEY> --env RAPYD_ENV=<RAPYD_ENV> -- npx -y @codespar/mcp-rapyd
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "rapyd": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-rapyd"
            ],
            "env": {
                "RAPYD_ACCESS_KEY": "<RAPYD_ACCESS_KEY>",
                "RAPYD_SECRET_KEY": "<RAPYD_SECRET_KEY>",
                "RAPYD_ENV": "<RAPYD_ENV>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "rapyd": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-rapyd"
            ],
            "env": {
                "RAPYD_ACCESS_KEY": "<RAPYD_ACCESS_KEY>",
                "RAPYD_SECRET_KEY": "<RAPYD_SECRET_KEY>",
                "RAPYD_ENV": "<RAPYD_ENV>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e RAPYD_ACCESS_KEY=<RAPYD_ACCESS_KEY> -e RAPYD_SECRET_KEY=<RAPYD_SECRET_KEY> -e RAPYD_ENV=<RAPYD_ENV> rapyd npx -y @codespar/mcp-rapyd
```
Replace <…> with your own values

## When to use it
- create a hosted checkout page
- send a payment through Rapyd
- issue a payout to a beneficiary
- refund a completed transaction
- move funds between managed wallets

## Example prompts
- Create a Rapyd checkout page for the current order and return its details.
- List the payment methods available for the target country and currency.
- Create a managed wallet for this user, then transfer funds from another wallet.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md