Skip to main content
Glama
Rift Finance MCP Server

Rift Finance MCP Server

Official
by Rift-FI

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
RIFT_API_KEYNoProject API key. Can be set at runtime via rift_set_api_key tool.
RIFT_API_URLNoRift API Wrapper URLhttps://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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 credential from Google One-Tap, or an ID token from useGoogleLogin({ flow: 'implicit' }) exchanged via Google's OAuth2 endpoint. NOT something the agent can produce on its own — ask the user / client for the idToken. Once an account is bound to Google, password/OTP login is rejected for that account; the user must keep using Google. After this call, all authenticated tools work.

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' — authorization.id_token from AppleID.auth.signIn() on web, the identity token from ASAuthorizationAppleIDCredential on iOS, or expo-apple-authentication on RN. NOT something the agent can produce — ask the user / client for the idToken. Apple only delivers email/name on the FIRST sign-in (and only the privaterelay alias if 'Hide My Email' is on); pass displayName then. Apple-bound accounts are NOT locked to Apple — email/OTP still works for users with a non-relay email on file. After this call, all authenticated tools work.

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:

  • buying_rate = OFFRAMP/withdrawal rate — fiat per USDC when cashing out. Multiply USDC × buying_rate to get fiat the user receives.

  • selling_rate = ONRAMP/deposit rate — fiat per USDC when buying crypto. User pays this much fiat per USDC.

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:

  • The on-chain sender is the user's SMART WALLET (a passkey-owned Safe). There is no EOA.

  • The returned 'hash' is a UserOperation hash (NOT a classic Ethereum tx hash). Do NOT link it as etherscan.io/tx/ — that will 404. To track, use a bundler-aware explorer (jiffyscan.xyz/userOpHash/) or poll a bundler via eth_getUserOperationByHash.

  • Gas is sponsored by default. Pass 'paymasterToken' (ERC-20 contract address) to pay gas in a token like USDC instead.

  • After approval, rift_get_approval's result carries userOpHash and transactionHash. Fields 'nonce', 'gasPrice', 'blockNumber' are NOT returned — UserOps don't have them.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.1/5.0

Scored across 83 tools

Disambiguation2/5

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.

Naming Consistency4/5

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).

Tool Count1/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues