Riven MCP

Riven MCP cung cấp nền tảng Riven cho các ứng dụng khách MCP: các công cụ về mức sử dụng, trò chuyện, hội đồng và nghiên cứu, giúp trợ lý có thể hoạt động bên trong không gian làm việc thay vì bên cạnh nó.

Tài liệu

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