# mcp-rinne

Connect an AI agent to Rinne for merchants, card and PIX payments, balances, payouts, and access management.

- 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/rinne
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-rinne

## What it does

mcp-rinne wraps the Rinne REST API so an agent can administer merchants, affiliations, users, and payment flows. Its 62 tools cover card and PIX transactions, refunds, receipts, stored cards, 3DS sessions, ledger entries, bank accounts, cashouts, pricing, webhooks, and API access.

Claude Code runs it through `npx` with Rinne credentials such as `RINNE_API_KEY`; sandbox mode and account settings can be passed with environment variables. The API rejects raw card numbers and CVV values. Card payments therefore require encrypted tokens created by the browser-side `rinne-js` element, so the server cannot encrypt card data on its own.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `RINNE_API_KEY`, `RINNE_SANDBOX`, `RINNE_EMAIL`, `RINNE_PASSWORD`, `RINNE_COMPANY_ID` — 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 RINNE_API_KEY=<RINNE_API_KEY> --env RINNE_SANDBOX=<RINNE_SANDBOX> --env RINNE_EMAIL=<RINNE_EMAIL> --env RINNE_PASSWORD=<RINNE_PASSWORD> --env RINNE_COMPANY_ID=<RINNE_COMPANY_ID> --transport stdio rinne -- npx -y @codespar/mcp-rinne
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add rinne --env RINNE_API_KEY=<RINNE_API_KEY> --env RINNE_SANDBOX=<RINNE_SANDBOX> --env RINNE_EMAIL=<RINNE_EMAIL> --env RINNE_PASSWORD=<RINNE_PASSWORD> --env RINNE_COMPANY_ID=<RINNE_COMPANY_ID> -- npx -y @codespar/mcp-rinne
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "rinne": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-rinne"
            ],
            "env": {
                "RINNE_API_KEY": "<RINNE_API_KEY>",
                "RINNE_SANDBOX": "<RINNE_SANDBOX>",
                "RINNE_EMAIL": "<RINNE_EMAIL>",
                "RINNE_PASSWORD": "<RINNE_PASSWORD>",
                "RINNE_COMPANY_ID": "<RINNE_COMPANY_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "rinne": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-rinne"
            ],
            "env": {
                "RINNE_API_KEY": "<RINNE_API_KEY>",
                "RINNE_SANDBOX": "<RINNE_SANDBOX>",
                "RINNE_EMAIL": "<RINNE_EMAIL>",
                "RINNE_PASSWORD": "<RINNE_PASSWORD>",
                "RINNE_COMPANY_ID": "<RINNE_COMPANY_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e RINNE_API_KEY=<RINNE_API_KEY> -e RINNE_SANDBOX=<RINNE_SANDBOX> -e RINNE_EMAIL=<RINNE_EMAIL> -e RINNE_PASSWORD=<RINNE_PASSWORD> -e RINNE_COMPANY_ID=<RINNE_COMPANY_ID> rinne npx -y @codespar/mcp-rinne
```
Replace <…> with your own values

## When to use it
- onboard and update merchants
- run card or PIX transactions
- issue full or partial refunds
- inspect balances, statements, and receipts
- configure fees and payout destinations

## Example prompts
- Create a merchant and connect it to a payment provider through an affiliation.
- List the merchant’s recent transactions and explain their current statuses.
- Check the balance, statement, and available cashout destinations.

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