mcp-rinne — Claude Code MCP server: payments
Connect an AI agent to Rinne for merchants, card and PIX payments, balances, payouts, and access management.
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-rinneWhat mcp-rinne 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.
What it helps with
- 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 for the agent
- 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.
How to install mcp-rinne
Platform CLI
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-rinneReplace <…> with your own values
Platform CLI
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-rinneReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-rinneReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-rinne
How do I install mcp-rinne in Claude Code?
Run claude mcp add mcp-rinne -e RINNE_API_KEY=<RINNE_API_KEY> -e RINNE_PASSWORD=<RINNE_PASSWORD> -- npx -y @codespar/mcp-rinne.
What does mcp-rinne do?
It gives an agent access to Rinne operations for merchants, payments, PIX, banking, payouts, pricing, webhooks, and access control.
What is required for card payments with mcp-rinne?
Card and CVV fields must already contain encrypted tokens produced by the browser-based rinne-js element. Raw card data is rejected by the API.
