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 |