Rift Finance MCP Server

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.

64 tools covering every Rift API endpoint plus documentation search.

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" },
});

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).
    I'll need an OTP to authorize. Check your email.
    [calls rift_send_otp]

User: "Code is 193847"

AI: [calls rift_send_crypto] → Done! Tx hash: 0xdef...

All 64 Tools

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

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 | | 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 / Proxy Wallet (4)

| Tool | Description | |------|-------------| | rift_get_wallet_instance | Get wallet for chain | | rift_sign_transaction | Sign without broadcast | | rift_send_transaction | Sign + broadcast | | rift_sign_message | Sign message |

Assets (3)

| Tool | Description | |------|-------------| | rift_get_tokens | List tokens | | rift_get_user_tokens | User's tokens | | rift_get_chains | List chains |

User Management (4)

| Tool | Description | |------|-------------| | rift_suspend_user | Suspend user | | rift_unsuspend_user | Unsuspend user | | rift_get_suspended_users | List suspended | | rift_get_user_status | Check suspension status |

Deposits (1)

| Tool | Description | |------|-------------| | rift_get_deposits | Get USDC deposits |