Rift

Prerequisites

• Rust 1.75+
• Node.js 20+ (for web SDK builds)
• MongoDB (local or Atlas)
• Optional: Custom domain with DNS access (any provider)

Pick a setup path

CLI path

Best if you want the guided onboarding flow.

curl -fsSL https://raw.githubusercontent.com/saltyskip/rift/main/client/cli/install.sh | sh
rift init
rift domains setup
rift doctor

The CLI handles account setup, stores your secret key locally, helps you verify your primary and alternate domains, and tests connectivity.

Manual path

Best if you want to drive the API and DNS steps yourself.

Setup

```sh

Enable shared git hooks (auto-builds web SDK, checks mobile SDK)

git config core.hooksPath .githooks ```

Setup with Claude Code

Add a .mcp.json to your project root:

{
  "mcpServers": {
    "rift": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "x-api-key": "rl_live_YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude will then have access to these tools: create_link, get_link, list_links, update_link, delete_link.

Setup with other MCP clients

Any MCP client that supports streamable HTTP transport can connect to http://localhost:3000/mcp. Pass your API key via the x-api-key HTTP header or the _meta.api_key field during initialization.

Quick Start

Edit .env with your MongoDB URI

cargo run ```

The server starts on http://localhost:3000. MongoDB is optional — the server boots without it (auth, links, and webhooks will be disabled).

Environment Variables

See .env.example for the full list.

Get an API key

curl -X POST http://localhost:3000/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'