{"name":"io.github.codespar/mcp-rinne","slug":"codespar-mcp-rinne","title":null,"description":"Brazilian card acquiring API — merchants, cards-on-file, 3DS, PIX, banking, pricing.","url":"https://mcp.market/server/codespar-mcp-rinne","rating":null,"grade":"B","score":82,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":44,"stars":271,"forks":50,"downloads_week":11,"last_push_at":"2026-08-29T02:02:48.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/codespar/mcp-dev-latam","website":null,"version":"0.1.0","remotes":[],"packages":[{"registryType":"npm","identifier":"@codespar/mcp-rinne","version":"0.1.0","transport":{"type":"stdio"},"environmentVariables":[{"description":"API key sent as x-api-key header on every request. Organization-level keys see all merchants; merchant-level keys are scoped to one merchant.","isRequired":true,"format":"string","isSecret":true,"name":"RINNE_API_KEY"},{"description":"Defaults to sandbox (https://api-sandbox.rinne.com.br/core). Set to \"false\" for production (https://api.rinne.com.br/core).","format":"string","name":"RINNE_SANDBOX"},{"description":"Login 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.","format":"string","name":"RINNE_EMAIL"},{"description":"Login password paired with RINNE_EMAIL.","format":"string","isSecret":true,"name":"RINNE_PASSWORD"},{"description":"Company to select after JWT login, for accounts with access to multiple companies.","format":"string","name":"RINNE_COMPANY_ID"}]}],"tools":[{"name":"activate_user","description":"JWT required (org users only). Reactivate a suspended user.","write_action":false,"price_micros":0,"input_schema":null},{"name":"authenticate_transaction","description":"Complete 3DS authentication for a transaction that came back AWAITING_3DS (transaction-first flow).","write_action":false,"price_micros":0,"input_schema":null},{"name":"cancel_refund","description":"Cancel a refund that hasn't settled yet.","write_action":true,"price_micros":0,"input_schema":null},{"name":"cancel_transaction","description":"Cancel a pending transaction (e.g. an unpaid BOLEPIX charge before its due date).","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_3ds_session","description":"Create a 3D Secure authentication session for a card, ahead of (or alongside) creating a transaction. Returns an id to pass as `three_d_secure_session_id` to create_transaction / authenticate_transaction.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_affiliation","description":"Create a merchant account with a payment provider (e.g. RINNE, CAPPTA, CELCOIN), enabling transaction processing for the given payment methods and capture channels. Starts in PENDING_APPROVAL.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_api_key","description":"JWT required (RINNE_EMAIL/RINNE_PASSWORD) — API keys can't create other API keys. The full key is returned once only; store it immediately.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_bank_account","description":"Register an external bank account (payout destination).","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_cashout","description":"Create a cashout (payout) to a bank account or PIX key. Provide exactly one of destination_bank_account_id or destination_pix_key_id.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_fee_policy","description":"Create a fee policy — pricing rules applied to merchants.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_internal_transfer","description":"Transfer funds between two of your organization's own bank accounts.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_merchant","description":"Create a new merchant under your organization. Requires KYC data. Financial fields may be required by specific affiliation providers later.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_pix_collection_key","description":"Create a PIX key the merchant uses to RECEIVE payments, tied to a provider affiliation. Different resource from register_cashout_pix_key (which registers a key as a payout destination).","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_role","description":"JWT required. Create a custom role.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_transaction","description":"Create a transaction — card (raw, stored, or Apple Pay/Google Pay) or PIX. For card, either: (1) \"session-first\" — call create_3ds_session first and pass its id as three_d_secure_session_id; or (2) \"transaction-first\" — pass require_3ds: true and the transaction comes back AWAITING_3DS, then call authenticate_transaction. For PIX, set payment_method: \"PIX\" and fill pix_data + consumer; the transac","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_user","description":"Create a user. With merchant_id, uses the merchant's x-api-key scope; without it, creates an org user and requires JWT (RINNE_EMAIL/RINNE_PASSWORD).","write_action":true,"price_micros":0,"input_schema":null},{"name":"delete_card","description":"Delete a stored card.","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_affiliation","description":"Get a specific affiliation for a merchant.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_balance","description":"Get the current balance.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_card","description":"Get a stored card by ID.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_cashout","description":"Get a single cashout by ID.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_cashout_receipt","description":"Get a cashout's receipt.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_company","description":"Get the authenticated company (organization or merchant, depending on the API key's scope).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_current_session","description":"JWT required. Get the current JWT session's identity/company context — a whoami for the JWT scope, distinct from get_company (x-api-key scope).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_health","description":"Check Rinne API health status.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_ledger_entry","description":"Get a single ledger entry by ID.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_merchant","description":"Get merchant details by ID.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_sandbox_guide","description":"Return Rinne sandbox rules: the card-encryption requirement, test card numbers, the amount-based approve/decline rule, and which tools need a JWT session.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_statement","description":"Get a merchant's balance statement (movements) for a date range.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_transaction","description":"Get transaction details and current status by ID, including any refunds.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_transaction_receipt","description":"Get a transaction's receipt(s) (returns base64 PDF).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_webhook_dashboard_url","description":"Get the URL of the webhook management dashboard, to configure endpoints and subscribed events (webhooks themselves are configured there, not via this API). Requires the webhook.list permission. Events are Svix-signed; verify with the Svix SDK and your webhook secret.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_affiliations","description":"List affiliations. With merchant_id, scoped to that merchant; without it, lists across all merchants in the organization.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_api_keys","description":"JWT required. List API keys (shows prefix + last 4 only, not the full key).","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_cards","description":"List cards on file.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_cashouts","description":"List cashouts.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_cost_policies","description":"List cost policies (what providers charge you).","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_fee_policies","description":"List fee policies (what you charge merchants).","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_judicial_blockages","description":"List judicial blockages (court-ordered account freezes) affecting balances.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_ledger_entries","description":"List ledger entries for the authenticated company.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_mccs","description":"List Merchant Category Codes (MCCs), for use in create_merchant.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_merchants","description":"List merchants under your organization.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_permissions","description":"JWT required. List all available permissions (read-only, system-defined), optionally filtered by resource.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_pix_collection_keys","description":"List the merchant's PIX collection keys.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_roles","description":"JWT required. List roles.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_transactions","description":"List transactions. With merchant_id, scoped to that merchant; without it, lists across all merchants in the organization.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_users","description":"List users. With merchant_id, uses the merchant's x-api-key scope; without it, lists org users and requires JWT.","write_action":false,"price_micros":0,"input_schema":null},{"name":"lookup_zipcode","description":"JWT required — unlike almost every other endpoint in this API, zipcode lookup rejects x-api-key. Look up a Brazilian address by CEP.","write_action":false,"price_micros":0,"input_schema":null},{"name":"refund_transaction","description":"Refund a transaction, fully or partially.","write_action":true,"price_micros":0,"input_schema":null},{"name":"register_affiliation","description":"Register a gateway-mode affiliation — bring an existing account/credentials with the provider instead of having Rinne provision a new one.","write_action":false,"price_micros":0,"input_schema":null},{"name":"register_cashout_pix_key","description":"Register an external PIX key as a payout (cashout) destination. Different resource from create_pix_collection_key (which registers a key to receive payments).","write_action":false,"price_micros":0,"input_schema":null},{"name":"replace_fee_policy","description":"Replace a fee policy in full (PUT).","write_action":false,"price_micros":0,"input_schema":null},{"name":"revoke_api_key","description":"JWT required. Revoke an API key.","write_action":false,"price_micros":0,"input_schema":null},{"name":"simulate_pay_transaction","description":"SANDBOX ONLY. Mark a WAITING_PAYMENT transaction (typically PIX) as paid, simulating the payer completing payment.","write_action":true,"price_micros":0,"input_schema":null},{"name":"store_card","description":"Save a card on file for reuse in future transactions (via card_id).","write_action":false,"price_micros":0,"input_schema":null},{"name":"suspend_user","description":"JWT required (org users only). Suspend a user's access.","write_action":false,"price_micros":0,"input_schema":null},{"name":"topup_balance","description":"SANDBOX ONLY. Simulate funding the balance — not a real deposit call.","write_action":false,"price_micros":0,"input_schema":null},{"name":"update_bank_account","description":"Set a bank account as primary.","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_company","description":"Update the authenticated company. All fields optional.","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_fee_policy","description":"Partially update a fee policy (PATCH) — any subset of fields.","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_merchant","description":"Update a merchant. All fields optional besides merchant_id.","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_user","description":"JWT required (org users only). Update a user's name/roles.","write_action":true,"price_micros":0,"input_schema":null}],"scan":{"score":82,"grade":"B","scanned_at":"2026-09-23T21:40:41.239Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-23T21:40:41.220Z","components":{"code":{"score":25,"max":25,"notes":["5 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 26 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"@codespar/mcp-rinne","version":"0.1.0","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":1,"publishedAt":"2026-08-09T18:45:15.893Z","weeklyDownloads":11}],"repo":{"found":true,"owner":"codespar","repo":"mcp-dev-latam","archived":false,"pushedAt":"2026-08-29T02:02:48Z","stars":271,"forks":50,"openIssues":10,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/269058982?v=4","ownerCreatedAt":"2026-03-18T00:40:56Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/269058982?v=4&s=128","source":"github"},"presence":{"stars":271,"forks":50,"downloadsWeek":11,"license":"MIT","lastPushAt":"2026-08-29T02:02:48.000Z","score":44}}}},"grade_history":[],"reviews":[]}