Rift Finance MCP Server
OfficialAllows pairing with DApps via WalletConnect, managing pending requests, approving/rejecting sessions, listing sessions, and disconnecting.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Rift Finance MCP Server Send 10 USDC to alice@example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Rift Finance MCP Server
MCP (Model Context Protocol) server that gives AI assistants full access to the Rift Finance platform. Users can send crypto, check balances, offramp to M-Pesa, bridge across chains, and more — just by chatting.
83 tools covering every Rift API endpoint plus documentation search.
Passkey-owned wallets (v3.0.0 of this server). Every Rift wallet is a Safe smart account owned only by the user's passkeys. Neither Rift nor this MCP server can move funds. Fund-moving tools (
rift_send_crypto,rift_offramp,rift_offramp_create_order,rift_bridge_execute,rift_swap,rift_wc_approve,rift_send_transaction,rift_sign_message) return an approval link (https://app.riftfi.com/approve/<id>). The agent gives it to the user, who approves with their passkey;rift_get_approvalreports the outcome. No OTP or password is needed for these any more, and Google / Apple sign-in is login only.rift_sign_transaction(raw EOA signing) was removed upstream (410 EOA_SIGNING_REMOVED).
Quick Setup
1. Install
cd rift-mcp-server
npm install
npm run build2. Add to Claude Desktop
Edit ~/.claude/claude_desktop_config.json (Mac: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"rift-finance": {
"command": "node",
"args": ["/absolute/path/to/rift-mcp-server/dist/index.js"],
"env": {
"RIFT_API_KEY": "sk_your_project_api_key"
}
}
}
}Restart Claude Desktop. You'll see the Rift tools available.
Note:
RIFT_API_KEYis optional in the config — users can also set it at runtime by telling Claude "my Rift API key is sk_..." which callsrift_set_api_key.
3. Add to Claude Code
Edit ~/.claude/settings.json:
{
"mcpServers": {
"rift-finance": {
"command": "node",
"args": ["/absolute/path/to/rift-mcp-server/dist/index.js"],
"env": {
"RIFT_API_KEY": "sk_your_project_api_key"
}
}
}
}4. Add to Cursor
Go to Settings > MCP Servers > Add Server:
Name:
rift-financeCommand:
node /absolute/path/to/rift-mcp-server/dist/index.jsEnvironment Variables:
RIFT_API_KEY:sk_your_project_api_key
5. Add to Any MCP-Compatible Agent
The server uses stdio transport (stdin/stdout JSON-RPC). Any MCP client can connect:
# Run directly
RIFT_API_KEY=sk_your_key node /path/to/rift-mcp-server/dist/index.js
# Or with npx (if published)
RIFT_API_KEY=sk_your_key npx @rift-finance/mcp-serverMCP client config (generic):
{
"command": "node",
"args": ["/path/to/rift-mcp-server/dist/index.js"],
"transport": "stdio",
"env": {
"RIFT_API_URL": "https://rift-sdk-wrapper-j9qe.onrender.com",
"RIFT_API_KEY": "sk_your_key"
}
}6. Using with the OpenAI Agents SDK / LangChain / Vercel AI SDK
Any framework that supports MCP can use this server. Example with the official MCP client:
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
const transport = new StdioClientTransport({
command: "node",
args: ["/path/to/rift-mcp-server/dist/index.js"],
env: {
RIFT_API_KEY: "sk_your_key",
RIFT_API_URL: "https://rift-sdk-wrapper-j9qe.onrender.com",
},
});
const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);
// List available tools
const tools = await client.listTools();
// Call a tool
const result = await client.callTool({
name: "rift_get_balance",
arguments: { chain: "BASE", token: "USDC" },
});Related MCP server: maxia-mcp
Environment Variables
Variable | Required | Default | Description |
| No |
| Rift API Wrapper URL |
| No | (empty) | Project API key. Can be set at runtime via |
User Flow
When a user chats with an AI that has this MCP server connected, here's the typical flow:
User: "I want to send some USDC"
AI: I'll need your Rift API key first. Do you have one?
User: "Yeah it's sk_abc123..."
AI: [calls rift_set_api_key] → Got it, key set.
Now let's log you in. What's your email?
User: "user@example.com"
AI: [calls rift_send_otp] → OTP sent to your email. What's the code?
User: "482910"
AI: [calls rift_login] → You're logged in!
[calls rift_get_balance] → You have 150.25 USDC on Base.
How much do you want to send and to what address?
User: "Send 50 USDC to 0xABC... on Base"
AI: You want to send 50 USDC to 0xABC... on Base (gasless). Confirm?
User: "Yes"
AI: [calls rift_send_crypto] → APPROVAL REQUIRED
Please open https://app.riftfi.com/approve/6f1c... and approve
with your passkey (Face ID / Touch ID). It expires in 30 minutes.
User: "Done"
AI: [calls rift_get_approval] → approved. Tx hash: 0xdef...If rift_get_wallet_status says needsPasskeySetup: true, the user must first create a passkey in the Rift app ("Secure your wallet with a passkey"); existing wallets keep their address. Recommend a second passkey (another device or a security key) for recovery. rift_guide covers this: tasks "passkey", "passkey recovery", "approvals".
All 83 Tools
Passkey Wallet & Approvals (3)
Tool | Description |
| Wallet mode, passkey count, per-chain owner mode, |
| Status + result of an approval request (API key alone is enough) |
| The user's approval requests (default: pending) |
Setup & Docs (6)
Tool | Description |
| Set API key at runtime |
| Override API URL |
| Check connection status |
| Search SDK/API docs |
| Get REST endpoints for a service |
| List chains, tokens, fiat currencies |
Auth & User (12)
Tool | Description |
| Create account. Email/phone: call |
| Send OTP |
| Verify OTP |
| Login (stores session) |
| Logout |
| Get profile |
| Update profile / auto-swap config. Changing email/phone needs an OTP for the NEW value ( |
| Delete account |
| Setup recovery methods |
| Get recovery options |
| Request password reset |
| Reset password with OTP |
Wallet & Transactions (4)
Tool | Description |
| Check balance (by chain/token) |
| Send crypto (gasless). Returns an approval link |
| Transaction history |
| Calculate fees |
Offramp — Crypto to Fiat (6)
Tool | Description |
| Preview FX rate |
| Banks/mobile money by currency |
| Cash out to M-Pesa/bank. Returns an approval link |
| Get withdrawal fee |
| Track offramp order |
| List offramp orders |
Onramp — Fiat to Crypto (3)
Tool | Description |
| Buy crypto with mobile money |
| Track purchase |
| List purchases |
Bridge (3)
Tool | Description |
| Available routes |
| Get quote |
| Execute bridge. Returns an approval link |
KYC (6)
Tool | Description |
| Get KYC verification URL |
| Check if user exists |
| KYC status |
| Verify KYC job |
| Am I verified? |
| Poll job status |
WalletConnect (6)
Tool | Description |
| Pair with DApp |
| Pending requests |
| Approve request. Returns an approval link |
| Reject request |
| List sessions |
| Disconnect session |
Merchant (3)
Tool | Description |
| Create invoice |
| List invoices |
| KYB status |
Notifications (3)
Tool | Description |
| Register device |
| Send notification |
| Get/delete subscriptions |
Signer (4)
Tool | Description |
| Get wallet for chain |
| Removed upstream (410 |
| UserOperation through the Safe. Returns an approval link |
| ERC-1271 message signature by the Safe. Returns an approval link |
Assets (3)
Tool | Description |
| List tokens |
| User's tokens |
| List chains |
User Management (4)
Project-owner only. These tools use the logged-in session: log in (rift_send_otp + rift_login) as the account that owns the project before calling them. projectOwnerEmail / projectOwnerPhone are no longer accepted.
Tool | Description |
| Suspend user |
| Unsuspend user |
| List suspended |
| Look up a user / check suspension status |
Deposits (1)
Tool | Description |
| Get USDC deposits |
Available Tools
83 toolsrift_add_recovery_methodA
Add a new recovery method (email or phone). Requires login + externalId/password for verification.
Inputs: value (required), method (required), password (required), externalId (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.
Inputs: token (required), amount (required), sourceChain (required), destinationChain (required), +1 more.
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.
Inputs: token (required), amount (required), sourceChain (required), destinationChain (required).
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.
Inputs: asset (required), chain (required), amount (required), shortcode (required), +2 more.
rift_create_invoiceA
Create a payment invoice and get a payment URL. No OTP required. KYC required for >$20. Requires login.
Inputs: chain (required), token (required), amount (required), description (required), +2 more.
rift_create_recoveryB
Set up account recovery methods (email and/or phone). User can later reset their password via these methods. Requires login + OTP.
Inputs: password (required), externalId (required), emailRecovery, phoneRecovery.
rift_delete_all_recoveryA
Delete ALL recovery methods. DESTRUCTIVE — confirm with user. Requires login + externalId/password.
Inputs: password (required), externalId (required).
rift_delete_userB
PERMANENTLY delete user account and all data. DESTRUCTIVE — confirm with user TWICE before calling.
Inputs: email, otpCode, password, externalId, +1 more.
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.
Inputs: no named parameters.
rift_get_api_endpointsB
Get REST API endpoint details for a service group. Returns methods, paths, auth requirements, and request body schemas.
Inputs: service (required).
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.
Inputs: approvalId (required).
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.
Inputs: chain, token.
rift_get_bridge_routesB
Get available cross-chain bridge routes and supported tokens. No auth required.
Inputs: no named parameters.
rift_get_chainsB
Get supported chains or details for a specific chain. No auth required.
Inputs: chainId.
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.
Inputs: no named parameters.
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.
Inputs: no named parameters.
rift_get_invoicesB
List invoices. Filter by status, date range, and sort order. Requires login.
Inputs: sortBy, status, sortOrder.
rift_get_my_recovery_methodsA
Get the current user's recovery methods. Requires login + externalId/password for verification.
Inputs: password (required), externalId (required).
rift_get_offramp_ordersA
Get all past offramp orders for the user. Requires login.
Inputs: no named parameters.
rift_get_onramp_ordersB
Get onramp purchase history. Requires login.
Inputs: userId (required).
rift_get_onramp_statusC
Check status of a crypto purchase. Requires login.
Inputs: transactionCode (required).
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.
Inputs: currency (required).
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.
Inputs: externalId (required).
rift_get_supported_chainsB
Get all supported blockchains (with chain IDs), tokens, and fiat currencies with payment methods.
Inputs: no named parameters.
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.
Inputs: no named parameters.
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.
Inputs: chainId.
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.
Inputs: chain (required), token (required), amount (required), recipient (required).
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.
Inputs: page, chain, limit, token.
rift_get_userA
Get the logged-in user's profile. Returns: email, phone, displayName, address (smart wallet), autoSwapEnabled, autoSwapTargetChain, and more. Requires login.
Inputs: no named parameters.
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.
Inputs: email, userId, externalId, phoneNumber.
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.
Inputs: no named parameters.
rift_get_wallet_instanceB
Get wallet address and details for a specific chain. Requires login.
Inputs: chain (required).
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.
Inputs: no named parameters.
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.
Inputs: no named parameters.
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.
Inputs: no named parameters.
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.
Inputs: task (required).
rift_kyc_check_user_existsC
Check if a user exists and their KYC status. No auth required.
Inputs: email, externalId, phoneNumber.
rift_kyc_get_tokenA
Start KYC verification — returns a verification URL the user must visit. No auth required.
Inputs: identifier (required), country_code (required).
rift_kyc_is_verifiedA
Check if the currently logged-in user is KYC verified. Requires login.
Inputs: no named parameters.
rift_kyc_job_statusB
Poll the status of a KYC verification job. Requires login.
Inputs: jobId (required).
rift_kyc_statusB
Check KYC verification status. Returns: verified, pending, failed, or provisional. No auth required.
Inputs: email, externalId, phoneNumber.
rift_kyc_verifyC
Verify a specific KYC job by ID. Requires login.
Inputs: jobId (required).
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.
Inputs: status.
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.
Inputs: email, otpCode, password, externalId, +1 more.
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.
Inputs: idToken (required), referrer, displayName.
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.
Inputs: idToken (required), referrer.
rift_logoutA
Logout and clear the session. After this, user must login again to use authenticated tools.
Inputs: no named parameters.
rift_merchant_statusA
Check if the user's account has merchant (KYB) approval. Required for offramp/onramp operations. Requires login.
Inputs: no named parameters.
rift_notifications_registerB
Register a device for push notifications. Requires login.
Inputs: subscriberId (required), platform, deviceInfo.
rift_notifications_sendA
Send a push notification to all of the user's registered devices. Requires login.
Inputs: message (required), title, targetUrl.
rift_notifications_subscriptionsB
Get or delete all notification subscriptions. Requires login.
Inputs: action.
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.
Inputs: chain (required), token (required), currency (required), recipient (required), +2 more.
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.
Inputs: chain (required), token (required), currency (required), recipient (required), +2 more.
rift_poll_offramp_statusA
Check the status of an offramp order. Call after rift_offramp. Status: PENDING → COMPLETED or FAILED. Requires login.
Inputs: currency (required), transactionCode (required).
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.
Inputs: type (required), currency (required), amount.
rift_remove_recovery_methodA
Remove a recovery method. Requires login + externalId/password for verification.
Inputs: method (required), password (required), externalId (required).
rift_request_password_resetA
Start password reset flow. Sends OTP to recovery email or phone. Does NOT require login.
Inputs: method (required), externalId (required).
rift_reset_passwordB
Complete password reset with OTP from recovery method. Does NOT require login.
Inputs: otpCode (required), username (required), newPassword (required), email, +1 more.
rift_search_docsA
Search Rift Finance SDK/API documentation. Returns method signatures, code examples, and auth requirements.
Inputs: query (required).
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.
Inputs: to (required), chain (required), token (required), value (required), +1 more.
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.
Inputs: email, phone.
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.
Inputs: message (required), paymentLink (required), recipientEmail, recipientPhone.
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.
Inputs: to (required), chain (required), data, value, +1 more.
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.
Inputs: apiKey (required).
rift_set_api_urlA
Override the Rift API URL. Only needed if using a custom deployment (not the default).
Inputs: url (required).
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.
Inputs: chain (required), message (required).
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.
Inputs: chain (required), to, data, value.
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.
Inputs: displayName (required), email, otpCode, password, +2 more.
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.
Inputs: no named parameters.
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.
Inputs: email, reason, userId, externalId, +1 more.
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.
Inputs: chain (required), value (required), token_to_buy (required), token_to_sell (required), +6 more.
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.
Inputs: email, userId, externalId, phoneNumber.
rift_update_recoveryA
Update existing recovery methods. Requires login + externalId/password for verification (verifyOtp middleware).
Inputs: password (required), externalId (required), emailRecovery, phoneRecovery.
rift_update_recovery_methodB
Update the value of an existing recovery method. Requires login + externalId/password.
Inputs: value (required), method (required), password (required), externalId (required).
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.
Inputs: email, otpCode, displayName, phoneNumber, +5 more.
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.
Inputs: code (required), email, phone.
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.
Inputs: id (required).
rift_wc_disconnectA
Disconnect from a DApp session. Requires login.
Inputs: topic (required).
rift_wc_get_requestsA
Get pending transaction requests from connected DApps. Show these to the user for approval. Requires login.
Inputs: no named parameters.
rift_wc_pairA
Pair with a DApp via WalletConnect. User provides a wc: URI (usually from a QR code). Requires login.
Inputs: uri (required), chain (required).
rift_wc_rejectA
Reject a pending DApp request. Requires login.
Inputs: id (required).
rift_wc_sessionsA
List active WalletConnect sessions. Requires login.
Inputs: no named parameters.
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.
Inputs: mode, apiKey, framework.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
An MCP server that integrates with Discord to provide AI-powered features.
Remote MCP server for AI.TV creators — delegate account operations to your AI agent over MCP.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceAn AI-powered crypto trading MCP server providing technical analysis, market sentiment, and token swap execution via 0x and DexScreener. It enables users to manage portfolios with built-in risk limits and search historical trade data using vector-based memory.15 npm8MIT
- AlicenseNot gradedqualityDmaintenanceAI-to-AI marketplace MCP server with 46 tools — swap 65+ crypto tokens on 7 chains, rent GPUs, trade 25 tokenized stocks, on-chain escrow (Solana + Base), DeFi yields, sentiment analysis, wallet monitoring, and image generation. Supports USDC payments across 14 blockchains.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents real-time access to DeFi across multiple chains, enabling non-custodial crypto trading, portfolio queries, and transaction execution.7MIT
- AlicenseNot gradedqualityCmaintenanceA Discord MCP server that gives AI agents full control of a Discord bot — messages, channels, roles, threads, forums, events, webhooks, reactions, moderation, image generation, and real-time voice.7MIT