Rift Finance MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RIFT_API_KEY | No | Project API key. Can be set at runtime via rift_set_api_key tool. | |
| RIFT_API_URL | No | Rift API Wrapper URL | https://rift-sdk-wrapper-j9qe.onrender.com |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| rift_guideA | START HERE. Get step-by-step instructions for any Rift operation. Call this FIRST when a user asks to do something and you're not sure of the exact flow. Covers: send crypto, withdraw to M-Pesa, buy crypto, bridge, check balance, login, passkey setup and recovery, approvals, KYC, invoices, WalletConnect, auto-swap, and more. |
| rift_search_docsA | Search Rift Finance SDK/API documentation. Returns method signatures, code examples, and auth requirements. |
| rift_get_api_endpointsB | Get REST API endpoint details for a service group. Returns methods, paths, auth requirements, and request body schemas. |
| rift_get_supported_chainsB | Get all supported blockchains (with chain IDs), tokens, and fiat currencies with payment methods. |
| rift_widget_snippetA | Return a ready-to-paste embed snippet for the Rift sign-in widget. Use this when a developer asks 'how do I add Rift to my site/app'. The output is a fully runnable code block keyed by their framework (html/react/nextjs). Each snippet uses the project's actual API key. |
| rift_get_widget_configA | Fetch the widget configuration for the currently-set project: display name, branding (colors / logo / font), and allowed origins. Useful for diagnosing why the widget shows defaults instead of project branding. Requires rift_set_api_key first. |
| rift_docs_urlA | Return the URL of the public Rift docs portal. Use this to point a developer at integration walkthroughs (client-side, server SDK, HTTP API, transaction signing) without requiring them to log in to the dashboard. |
| rift_set_api_keyA | Set the Rift project API key. MUST be called before any other live tool if no key is configured. The key starts with 'sk_'. Ask the user for it if you don't have it. |
| rift_set_api_urlA | Override the Rift API URL. Only needed if using a custom deployment (not the default). |
| rift_statusA | Check current connection and auth status. Call this if you're unsure whether the user is logged in or the API key is set. |
| rift_signupA | Create a new Rift user account. Two ways: (1) email or phone sign-up: FIRST call rift_send_otp for that email/phone, ask the user for the code, then call this with email (or phoneNumber) + displayName + otpCode. Afterwards call rift_login with the SAME otpCode (no new code needed). (2) externalId + password sign-up: no OTP needed. After signup the user still has to log in via rift_login. |
| rift_send_otpA | Send a one-time password to user's email or phone. Call this BEFORE: (1) rift_login — to authenticate, (2) rift_send_crypto — to authorize a transaction, (3) rift_offramp — to authorize a withdrawal. The user receives the code via SMS or email and must tell you the code. |
| rift_verify_otpA | Verify an OTP code WITHOUT logging in. Rarely needed — for login, use rift_login directly (it verifies OTP internally). For transactions/offramp, pass otpCode directly to rift_send_crypto/rift_offramp. Only use this for standalone OTP checks. |
| rift_loginA | Login to Rift. Stores the session so all authenticated tools work. Three methods: (1) email + otpCode — call rift_send_otp first, (2) phoneNumber + otpCode — call rift_send_otp first, (3) externalId + password — no OTP needed. After login, you do NOT need to login again for subsequent tool calls in this session. |
| rift_login_googleA | Sign in (or sign up on first use) with a Google ID token. The frontend obtains the idToken from Google's identity flow — for example, the |
| rift_login_appleA | Sign in (or sign up on first use) with an Apple identity token. The frontend obtains the idToken from 'Sign in with Apple' — |
| rift_logoutA | Logout and clear the session. After this, user must login again to use authenticated tools. |
| rift_get_userA | Get the logged-in user's profile. Returns: email, phone, displayName, address (smart wallet), autoSwapEnabled, autoSwapTargetChain, and more. Requires login. |
| rift_update_userA | Update user profile. Can change display name, email, phone, notification email, and auto-swap settings. Requires login. Changing email or phone needs an OTP for the NEW value: call rift_send_otp with the new email/phone first, then pass otpCode (changing one of them) or emailOtpCode + phoneOtpCode (changing both). Other fields need no OTP. |
| rift_delete_userB | PERMANENTLY delete user account and all data. DESTRUCTIVE — confirm with user TWICE before calling. |
| rift_create_recoveryB | Set up account recovery methods (email and/or phone). User can later reset their password via these methods. Requires login + OTP. |
| rift_get_recovery_optionsA | Get available recovery options for a user. Shows masked email/phone. Does NOT require login — for users who are locked out. |
| rift_request_password_resetA | Start password reset flow. Sends OTP to recovery email or phone. Does NOT require login. |
| rift_reset_passwordB | Complete password reset with OTP from recovery method. Does NOT require login. |
| rift_update_recoveryA | Update existing recovery methods. Requires login + externalId/password for verification (verifyOtp middleware). |
| rift_add_recovery_methodA | Add a new recovery method (email or phone). Requires login + externalId/password for verification. |
| rift_remove_recovery_methodA | Remove a recovery method. Requires login + externalId/password for verification. |
| rift_update_recovery_methodB | Update the value of an existing recovery method. Requires login + externalId/password. |
| rift_get_my_recovery_methodsA | Get the current user's recovery methods. Requires login + externalId/password for verification. |
| rift_delete_all_recoveryA | Delete ALL recovery methods. DESTRUCTIVE — confirm with user. Requires login + externalId/password. |
| rift_get_balanceA | Get wallet balance. Returns crypto balances (USDC, USDT, ETH, etc), NOT fiat amounts. Call with no params for all balances across all chains. To display in local fiat: call rift_preview_exchange_rate with type='offramp', then multiply USDC balance × buying_rate. Requires login. |
| rift_send_cryptoA | Send crypto to an address. REAL TRANSACTION — always confirm with user first. Does NOT execute directly: returns an APPROVAL REQUIRED link the user must open and approve with their passkey. Give the link to the user, then check with rift_get_approval. Never call again to retry. No OTP/password needed. Requires login. |
| rift_get_transaction_historyA | Get on-chain transaction history (sends/receives). For offramp order history, use rift_get_offramp_orders. For onramp order history, use rift_get_onramp_orders. Requires login. |
| rift_get_transaction_feeA | Calculate the gas/network fee for sending crypto (rift_send_crypto). This is the on-chain transaction fee, NOT the offramp/exchange fee. For offramp fees, use rift_preview_exchange_rate with amount and type='offramp'. Requires login. |
| rift_preview_exchange_rateA | Preview exchange rate. IMPORTANT: offramp and onramp rates are DIFFERENT — always set type correctly. Rate fields explained:
To show a user's balance in local fiat: USDC balance × buying_rate. To show how much USDC they get for fiat: fiat amount / selling_rate. Pass an amount to get feeBreakdown with exact fee, feePercentage, userReceivesFiat, and totalUsdcNeeded. |
| rift_get_payment_methodsA | Get supported banks and mobile money providers for a currency. Use the bankCode values from here in rift_offramp. E.g. for Kenya: MPESA for M-Pesa. Requires login. |
| rift_offrampA | Withdraw crypto to fiat. REAL PAYMENT — confirm with user. Requires: login + merchant approval + KYC (>$20) + a passkey. Does NOT execute directly: returns an APPROVAL REQUIRED link. Give it to the user to approve with their passkey; check with rift_get_approval, then track the payout with rift_poll_offramp_status. Never call again to retry. No OTP/password needed. WARNING: after approval, settlement can take 30-60+ seconds (on-chain tx + fiat settlement). A timeout does NOT mean failure — always check rift_poll_offramp_status with the transactionCode to confirm the actual status. The 'recipient' field is a JSON string whose structure depends on the currency: KES (Kenya Mobile — Pretium): {"type":"MOBILE","accountIdentifier":"+254...","institution":"Safaricom"} — accountName is NOT required for KES/M-Pesa KES (Kenya Paybill): {"type":"PAYBILL","accountIdentifier":"shortcode","accountNumber":"acct_num","institution":"Safaricom"} NGN (Nigeria Bank — Paycrest): {"bankCode":"GTBINGLA","accountIdentifier":"0123456789","accountName":"John Doe","institution":"GTBank"} UGX (Uganda Mobile): {"bankCode":"MOMOUGPC","accountIdentifier":"+256...","accountName":"Name","institution":"MTN"} GHS (Ghana Mobile): {"bankCode":"MOMOGHPC","accountIdentifier":"+233...","accountName":"Name","institution":"MTN"} ETB (Ethiopia Mobile): {"bankCode":"TELEBPC","accountIdentifier":"+251...","accountName":"Name","institution":"Telebirr"} CDF (Congo Mobile): {"bankCode":"OMONDFPC","accountIdentifier":"+243...","accountName":"Name","institution":"Orange Money"} TZS (Tanzania Mobile): {"bankCode":"TIGOTZPC","accountIdentifier":"+255...","accountName":"Name","institution":"Vodacom"} MWK (Malawi Mobile): {"bankCode":"AIRTMWPC","accountIdentifier":"+265...","accountName":"Name","institution":"Airtel"} BRL (Brazil PIX): {"bankCode":"PIXKBRPC","accountIdentifier":"pix_key","accountName":"Name","institution":"pix"} Call rift_get_payment_methods first to get valid bankCode and institution values for the user's currency. Use amount (USDC) or localAmount (exact fiat payout). Use rift_preview_exchange_rate with type='offramp' to show rates/fees first. |
| rift_offramp_create_orderA | DO NOT USE — use rift_offramp instead. This is a legacy endpoint that does the same thing. REAL PAYMENT — confirm with user. Returns an APPROVAL REQUIRED link for the user (passkey); never call again to retry. |
| rift_send_payment_linkA | Send an existing payment link URL to someone via SMS and/or email. This does NOT create a payment — it just delivers an existing URL. You need to have a payment link URL already (e.g. from an invoice). At least one of recipientPhone or recipientEmail is required. Requires login. |
| rift_get_withdrawal_feeA | DO NOT USE THIS to show users their withdrawal fee — it only returns the raw KES buy/sell spread, not the actual fee on a withdrawal. Instead, use rift_preview_exchange_rate with an amount and type='offramp' — that returns feeBreakdown with the real fee, feePercentage, userReceivesFiat, and totalUsdcNeeded. This tool exists only for internal diagnostics. |
| rift_poll_offramp_statusA | Check the status of an offramp order. Call after rift_offramp. Status: PENDING → COMPLETED or FAILED. Requires login. |
| rift_get_offramp_ordersA | Get all past offramp orders for the user. Requires login. |
| rift_buy_cryptoA | Buy crypto with mobile money (M-Pesa, etc). REAL PAYMENT — confirm with user. The 'amount' here is in LOCAL FIAT currency (e.g. 1000 = 1000 KES), NOT in USDC. Use rift_preview_exchange_rate with type='onramp' first to show how much USDC they'll get. Requires: login + merchant approval + KYC (for >$20). Does NOT require OTP. User receives a mobile money prompt on their phone. |
| rift_get_onramp_statusC | Check status of a crypto purchase. Requires login. |
| rift_get_onramp_ordersB | Get onramp purchase history. Requires login. |
| rift_get_bridge_routesB | Get available cross-chain bridge routes and supported tokens. No auth required. |
| rift_bridge_quoteA | Get fee and output amount for a bridge transfer. Call before rift_bridge_execute to show user what they'll receive. No auth required. |
| rift_bridge_executeA | Execute cross-chain bridge. MOVES REAL FUNDS — confirm with user. Does NOT execute directly: returns an APPROVAL REQUIRED link the user approves with their passkey (check with rift_get_approval; never call again to retry). Tokens arrive 1-5 minutes after approval. Call rift_bridge_quote first to show fees. Requires login. |
| rift_swapA | Swap one token for another on a single chain via the user's smart wallet. SAME-CHAIN ONLY — for cross-chain use rift_bridge_execute. REAL TX — confirm with user. DEPRECATED upstream: the backend swap endpoint may be unavailable; if it fails, tell the user to swap in the Rift app. When it works it returns an APPROVAL REQUIRED link for the user (passkey); check with rift_get_approval, never call again to retry. Use 'flow: gasless' (recommended) for sponsored gas via UserOperation; use 'normal' to pay gas yourself. For known tokens (USDC, USDT, WETH, etc.) the chain's defaults are used; pass token_to_sell_address / token_to_buy_address only for arbitrary ERC-20s. For native ETH legs set isEth (selling ETH) or isBuyingEth (buying ETH). 'value' is the amount of token_to_sell, in human units (e.g. '10' for 10 USDC). To target a specific output, pass amountOut instead. Requires login. |
| rift_kyc_get_tokenA | Start KYC verification — returns a verification URL the user must visit. No auth required. |
| rift_kyc_check_user_existsC | Check if a user exists and their KYC status. No auth required. |
| rift_kyc_statusB | Check KYC verification status. Returns: verified, pending, failed, or provisional. No auth required. |
| rift_kyc_verifyC | Verify a specific KYC job by ID. Requires login. |
| rift_kyc_is_verifiedA | Check if the currently logged-in user is KYC verified. Requires login. |
| rift_kyc_job_statusB | Poll the status of a KYC verification job. Requires login. |
| rift_wc_pairA | Pair with a DApp via WalletConnect. User provides a wc: URI (usually from a QR code). Requires login. |
| rift_wc_get_requestsA | Get pending transaction requests from connected DApps. Show these to the user for approval. Requires login. |
| rift_wc_approveA | Approve a pending DApp request. Always show the request details to user first. Returns an APPROVAL REQUIRED link: the user signs with their passkey there, then the DApp gets its answer. Check with rift_get_approval; never call again to retry. Requires login. |
| rift_wc_rejectA | Reject a pending DApp request. Requires login. |
| rift_wc_sessionsA | List active WalletConnect sessions. Requires login. |
| rift_wc_disconnectA | Disconnect from a DApp session. Requires login. |
| rift_create_invoiceA | Create a payment invoice and get a payment URL. No OTP required. KYC required for >$20. Requires login. |
| rift_get_invoicesB | List invoices. Filter by status, date range, and sort order. Requires login. |
| rift_merchant_statusA | Check if the user's account has merchant (KYB) approval. Required for offramp/onramp operations. Requires login. |
| rift_notifications_registerB | Register a device for push notifications. Requires login. |
| rift_notifications_sendA | Send a push notification to all of the user's registered devices. Requires login. |
| rift_notifications_subscriptionsB | Get or delete all notification subscriptions. Requires login. |
| rift_get_wallet_instanceB | Get wallet address and details for a specific chain. Requires login. |
| rift_sign_transactionA | REMOVED: raw EOA transaction signing. Rift wallets are passkey-owned Safe smart accounts with no EOA key, so the server answers 410 EOA_SIGNING_REMOVED. Use rift_send_transaction (executes through the Safe, returns an approval link) instead. Kept only so old prompts get a clear error. |
| rift_send_transactionA | Execute a call through the user's SMART WALLET (Safe) as an ERC-4337 UserOperation. For advanced use (contract calls, native transfers) — for simple token sends use rift_send_crypto instead. REAL TX — confirm with user. Does NOT execute directly: returns an APPROVAL REQUIRED link the user approves with their passkey. Check with rift_get_approval (result has userOpHash / transactionHash). Never call again to retry. Semantics an AI MUST know:
Requires login. |
| rift_sign_messageA | Sign a message with the user's Safe smart wallet (ERC-1271 contract signature; ERC-6492-wrapped if the wallet isn't deployed on that chain yet). Used for DApp authentication, off-chain signatures, etc. Returns an APPROVAL REQUIRED link the user approves with their passkey; the signature is in rift_get_approval's result. Never call again to retry. Requires login. |
| rift_get_wallet_statusA | Passkey wallet status: mode (none | legacy | passkey), walletAddress, passkeyCount, per-chain owner mode and needsPasskeySetup. If needsPasskeySetup is true the user must create a passkey in the Rift app before anything can be signed (see rift_guide 'passkey'). If passkeyCount is 1, suggest adding a second passkey for recovery. Requires login. |
| rift_get_approvalA | Check an approval request returned by a fund-moving tool (send, offramp, bridge, swap, WalletConnect approve, send transaction, sign message). Status: pending (user hasn't approved yet — remind them of the link), approved (result has transactionHash / userOpHash / signature), rejected, expired (start over with a new call), failed. Works with the API key alone. |
| rift_list_approvalsA | List the user's approval requests (default: pending). Use it to remind the user of links they haven't approved yet. Requires login. |
| rift_get_tokensA | Get the list of supported token TYPES (metadata: name, contract address, chain). This is NOT balances — use rift_get_balance for balances. No auth required. |
| rift_get_user_tokensA | Get the list of token TYPES the user has interacted with (metadata, not balances). For actual balances, use rift_get_balance. Requires login. |
| rift_get_chainsB | Get supported chains or details for a specific chain. No auth required. |
| rift_suspend_userB | Suspend a user from the platform. PROJECT OWNER only: uses the logged-in session, so the user must be logged in (rift_send_otp + rift_login) as the account that owns this project. Other accounts are rejected. |
| rift_unsuspend_userB | Unsuspend a previously suspended user. PROJECT OWNER only: uses the logged-in session, so the user must be logged in (rift_send_otp + rift_login) as the account that owns this project. Other accounts are rejected. |
| rift_get_suspended_usersA | List all suspended users in the project. PROJECT OWNER only: uses the logged-in session, so the user must be logged in (rift_send_otp + rift_login) as the account that owns this project. Other accounts are rejected. |
| rift_get_user_statusB | Look up a user and check whether they are suspended. PROJECT OWNER only: uses the logged-in session, so the user must be logged in (rift_send_otp + rift_login) as the account that owns this project. Other accounts are rejected. |
| rift_get_depositsA | Get onchain deposit history for the user (queried live from The Graph). Shows inbound transfers to the user's smart wallets with USDC amounts, KES conversion, sender address, tx hash, and timestamp. This is NOT a balance check — use rift_get_balance for current balances. Requires login. |
| rift_get_deposit_statsA | Get deposit statistics: totalDeposits (count), totalUsdcAmount, totalKesAmount, plus the full deposits list. Summary of all onchain deposits to the user's wallets. Requires login. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 83 tools
Multiple tools overlap or are explicitly legacy aliases: rift_update_recovery_method vs rift_update_recovery, rift_add_recovery_method vs rift_create_recovery, rift_offramp vs rift_offramp_create_order, rift_get_chains vs rift_get_supported_chains, and several KYC status checks. Descriptions often warn which to use, but an agent can still misselect among near-duplicates.
All tools use snake_case with a rift_ prefix, and most follow rift_<verb>_<noun>. Deviations are minor: some are noun-only (rift_status, rift_offramp, rift_swap, rift_guide) or service-prefixed (rift_kyc_get_token, rift_wc_pair, rift_notifications_register).
83 tools is far beyond a well-scoped MCP surface of roughly 3-15 tools and is inflated by legacy, removed, diagnostic, admin, and duplicate endpoints. Even for a broad fintech platform, this count makes discovery and correct selection difficult.
Core workflows are well covered: auth, user/recovery, wallet, send/approve, offramp/onramp, bridge, swap, KYC, WalletConnect, invoices, notifications, and admin. Minor gaps remain, such as invoice get/update/cancel and swap quoting, and the surface includes removed/legacy tools.