Skip to main content
Glama
Rift Finance MCP Server

Rift Finance MCP Server

Official
by Rift-FI

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_approval reports 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 build

2. 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_KEY is optional in the config — users can also set it at runtime by telling Claude "my Rift API key is sk_..." which calls rift_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-finance

  • Command: node /absolute/path/to/rift-mcp-server/dist/index.js

  • Environment 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-server

MCP 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

RIFT_API_URL

No

https://rift-sdk-wrapper-j9qe.onrender.com

Rift API Wrapper URL

RIFT_API_KEY

No

(empty)

Project API key. Can be set at runtime via rift_set_api_key tool

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

rift_get_wallet_status

Wallet mode, passkey count, per-chain owner mode, needsPasskeySetup

rift_get_approval

Status + result of an approval request (API key alone is enough)

rift_list_approvals

The user's approval requests (default: pending)

Setup & Docs (6)

Tool

Description

rift_set_api_key

Set API key at runtime

rift_set_api_url

Override API URL

rift_status

Check connection status

rift_search_docs

Search SDK/API docs

rift_get_api_endpoints

Get REST endpoints for a service

rift_get_supported_chains

List chains, tokens, fiat currencies

Auth & User (12)

Tool

Description

rift_signup

Create account. Email/phone: call rift_send_otp first and pass otpCode, then rift_login with the SAME code. externalId + password needs no OTP

rift_send_otp

Send OTP

rift_verify_otp

Verify OTP

rift_login

Login (stores session)

rift_logout

Logout

rift_get_user

Get profile

rift_update_user

Update profile / auto-swap config. Changing email/phone needs an OTP for the NEW value (otpCode, or emailOtpCode + phoneOtpCode when changing both)

rift_delete_user

Delete account

rift_create_recovery

Setup recovery methods

rift_get_recovery_options

Get recovery options

rift_request_password_reset

Request password reset

rift_reset_password

Reset password with OTP

Wallet & Transactions (4)

Tool

Description

rift_get_balance

Check balance (by chain/token)

rift_send_crypto

Send crypto (gasless). Returns an approval link

rift_get_transaction_history

Transaction history

rift_get_transaction_fee

Calculate fees

Offramp — Crypto to Fiat (6)

Tool

Description

rift_preview_exchange_rate

Preview FX rate

rift_get_payment_methods

Banks/mobile money by currency

rift_offramp

Cash out to M-Pesa/bank. Returns an approval link

rift_get_withdrawal_fee

Get withdrawal fee

rift_poll_offramp_status

Track offramp order

rift_get_offramp_orders

List offramp orders

Onramp — Fiat to Crypto (3)

Tool

Description

rift_buy_crypto

Buy crypto with mobile money

rift_get_onramp_status

Track purchase

rift_get_onramp_orders

List purchases

Bridge (3)

Tool

Description

rift_get_bridge_routes

Available routes

rift_bridge_quote

Get quote

rift_bridge_execute

Execute bridge. Returns an approval link

KYC (6)

Tool

Description

rift_kyc_get_token

Get KYC verification URL

rift_kyc_check_user_exists

Check if user exists

rift_kyc_status

KYC status

rift_kyc_verify

Verify KYC job

rift_kyc_is_verified

Am I verified?

rift_kyc_job_status

Poll job status

WalletConnect (6)

Tool

Description

rift_wc_pair

Pair with DApp

rift_wc_get_requests

Pending requests

rift_wc_approve

Approve request. Returns an approval link

rift_wc_reject

Reject request

rift_wc_sessions

List sessions

rift_wc_disconnect

Disconnect session

Merchant (3)

Tool

Description

rift_create_invoice

Create invoice

rift_get_invoices

List invoices

rift_merchant_status

KYB status

Notifications (3)

Tool

Description

rift_notifications_register

Register device

rift_notifications_send

Send notification

rift_notifications_subscriptions

Get/delete subscriptions

Signer (4)

Tool

Description

rift_get_wallet_instance

Get wallet for chain

rift_sign_transaction

Removed upstream (410 EOA_SIGNING_REMOVED); kept for a clear error

rift_send_transaction

UserOperation through the Safe. Returns an approval link

rift_sign_message

ERC-1271 message signature by the Safe. Returns an approval link

Assets (3)

Tool

Description

rift_get_tokens

List tokens

rift_get_user_tokens

User's tokens

rift_get_chains

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

rift_suspend_user

Suspend user

rift_unsuspend_user

Unsuspend user

rift_get_suspended_users

List suspended

rift_get_user_status

Look up a user / check suspension status

Deposits (1)

Tool

Description

rift_get_deposits

Get USDC deposits

Available Tools

83 tools
rift_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_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

    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

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An 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 npm
      8
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      AI-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
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that gives AI agents real-time access to DeFi across multiple chains, enabling non-custodial crypto trading, portfolio queries, and transaction execution.
      7
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A 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.
      7
      MIT