Card acquiring, PIX, cards-on-file and 3D Secure across an organization/merchant hierarchy. Your agent onboards merchants, runs card and PIX transactions, and moves payouts through cashouts and banking.
Rinne gives your agent 62 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.
get_company — Get the authenticated company (organization or merchant, depending on the API key's scope).update_company — Update the authenticated company. All fields optional.create_merchant — Create a new merchant under your organization. Requires KYC data. Financial fields may be required by specific affiliation providers later.// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("get_company", { /* ... */ });$ npm install @codespar/mcp-rinneAdd this entry to your claude_desktop_config.json (or any MCP-compatible client config).
{
"mcpServers": {
"rinne": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-rinne"
],
"env": {
"RINNE_API_KEY": "<your_rinne_api_key>"
}
}
}
}After restart, your agent can call any of the 62 tools below — try get_company first.
Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.
RINNE_API_KEYAPI key sent as x-api-key header on every request. Organization-level keys see all merchants; merchant-level keys are scoped to one merchant.
RINNE_SANDBOXDefaults to sandbox (https://api-sandbox.rinne.com.br/core). Set to "false" for production (https://api.rinne.com.br/core).
RINNE_EMAILLogin identifier for the access-management tools (API Keys, Roles, Permissions, org Users, Zipcode lookup), which reject x-api-key by design and require a JWT session.
RINNE_PASSWORDLogin password paired with RINNE_EMAIL.
RINNE_COMPANY_IDCompany to select after JWT login, for accounts with access to multiple companies.
Each tool is independent — your agent loads only what it needs to reduce context and response time.
get_companyupdate_companycreate_merchantlist_merchantsget_merchantupdate_merchantcreate_affiliationregister_affiliationMCP is a protocol — any framework that speaks it can mount this server.