Raindex Server

A Model Context Protocol (MCP) server that wraps the Raindex SDK (@rainlanguage/orderbook), enabling AI agents to query, manage, and interact with Raindex onchain orderbook positions.

Features

• 17 MCP tools covering orders, vaults, strategies, deployment, transactions, and token info
• Calldata-only writes — never holds keys or signs transactions
• Multi-chain — queries all configured chains from a single settings file
• Registry integration — browse and deploy strategies from a dotrain registry

Prerequisites

• Nix with flakes enabled
• A Raindex settings YAML file (see example)

Setup

# Enter dev shell (provides Node.js 22)
nix develop

# Install dependencies
npm ci

# Build
npm run build

# Run tests
npm test

Configuration

Set environment variables before starting the server:

*One of RAINDEX_SETTINGS_PATH or RAINDEX_SETTINGS_YAML is required.

Usage

As an MCP server (stdio transport)

RAINDEX_SETTINGS_PATH=./settings.yaml node dist/index.js

MCP client configuration (e.g. Claude Desktop)

{
  "mcpServers": {
    "raindex": {
      "command": "node",
      "args": ["/path/to/raindex-mcp/dist/index.js"],
      "env": {
        "RAINDEX_SETTINGS_PATH": "/path/to/settings.yaml",
        "RAINDEX_REGISTRY_URL": "https://example.com/registry.txt"
      }
    }
  }
}

Tools

Orders

Vaults

Strategies & Deployment

Info

Architecture

• Transport: stdio (standard MCP pattern)
• Client: Single RaindexClient instance from settings YAML
• Write ops: Return { calldata, to, chainId } — agent signs externally
• SDK: @rainlanguage/orderbook (Rust/WASM bindings)

Development

nix develop -c npm test          # Run tests
nix develop -c npm run lint      # Lint
nix develop -c npm run fmt       # Format
nix develop -c npm run fmt:check # Check formatting
nix develop -c npm run build     # Compile TypeScript

License

MIT