Riven MCP

Riven MCP exposes the Riven platform to MCP clients: usage, chat, council and research tools, so assistants can act inside the workspace instead of beside it.

Documentation

riven-mcp

Official Model Context Protocol (MCP) server for Riven. It exposes Riven's chat, research, council, and usage capabilities as MCP tools over stdio, so any MCP-compatible client — Claude Desktop, Cursor, or your own agent — can call Riven directly.

Tools

ToolDescription
riven_chatSend a single prompt to a Riven chat model and return the completion text.
riven_researchCreate a Computer research task, run it, poll until done, and return a summary of the thread.
riven_councilCreate a Computer council task (multiple models answer the same prompt) and return the verdict and transcript.
riven_usageReturn current usage statistics for the authenticated account.

Related MCP server: gemini-cli-bridge

Install

npm install -g @rivenai/riven-mcp

Or run it directly without a global install using npx (see configuration examples below).

Configuration

The server reads its configuration from environment variables:

VariableRequiredDefaultDescription
RIVEN_API_KEYYes—Your Riven API key (starts with rvn_).
RIVEN_API_BASENohttps://api.rivenai.io/v1Override the chat completions API base URL.
RIVEN_COMPUTER_BASENohttps://computer.rivenai.ioOverride the Computer (agentic tasks) API base URL.

Usage with Claude Desktop

Add to your Claude Desktop MCP config (claude_desktop_config.json):

{
  "mcpServers": {
    "riven": {
      "command": "npx",
      "args": ["-y", "@rivenai/riven-mcp"],
      "env": {
        "RIVEN_API_KEY": "rvn_your_key_here"
      }
    }
  }
}

Usage with Cursor

Add to your Cursor MCP config (.cursor/mcp.json):

{
  "mcpServers": {
    "riven": {
      "command": "npx",
      "args": ["-y", "@rivenai/riven-mcp"],
      "env": {
        "RIVEN_API_KEY": "rvn_your_key_here"
      }
    }
  }
}

Usage with any MCP client

Any client that can spawn a stdio MCP server works the same way — set the command to npx -y @rivenai/riven-mcp (or the installed binary riven-mcp) and provide RIVEN_API_KEY in the child process environment:

{
  "mcpServers": {
    "riven": {
      "command": "riven-mcp",
      "env": {
        "RIVEN_API_KEY": "rvn_your_key_here"
      }
    }
  }
}

Building from source

git clone https://github.com/rivenai/riven-mcp
cd riven-mcp
npm install
npm run build
RIVEN_API_KEY=rvn_your_key_here node dist/index.js

Notes on long-running tools

riven_research and riven_council create a Computer task, start it, and poll its thread until the task reaches a terminal state or a timeout elapses (default 120 seconds, configurable per call via timeout_seconds). If the timeout is reached first, the tool returns the current transcript along with the task's in-progress status rather than failing, since the underlying task keeps running server-side.

License

MIT © 2026 RivenAI. See LICENSE.

Full API reference: docs.rivenai.io

Available Tools

4 tools

riven_chat Riven ChatA Inspect

Send a single prompt to a Riven chat model and return the completion text. Use for quick, single-turn questions that don't need agentic research.

Inputs: prompt (required), model, system.

riven_council Riven CouncilA Inspect

Create a Riven Computer council task, which asks multiple models to answer the same prompt and produces a synthesized verdict plus each model's individual answer. Use when you want a cross-checked or debated answer rather than a single model's view.

Inputs: prompt (required), title, timeout_seconds.

riven_research Riven ResearchA Inspect

Create a Riven Computer research task for the given prompt, run it, poll until it completes (or times out), and return a summary of the resulting thread. Use for open-ended research questions that benefit from multi-step agentic work.

Inputs: prompt (required), title, timeout_seconds.

riven_usage Riven UsageA Inspect

Return current usage statistics for the authenticated Riven account.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

TDQS

A4/5.0

Scored across 4 tools

Disambiguation5/5

Naming Consistency5/5

Tool Count5/5

Completeness4/5

Maintenance

ActivityInactive

ResponsivenessNo recent community issues