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
| Tool | Description |
|---|---|
riven_chat | Send a single prompt to a Riven chat model and return the completion text. |
riven_research | Create a Computer research task, run it, poll until done, and return a summary of the thread. |
riven_council | Create a Computer council task (multiple models answer the same prompt) and return the verdict and transcript. |
riven_usage | Return 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:
| Variable | Required | Default | Description |
|---|---|---|---|
RIVEN_API_KEY | Yes | — | Your Riven API key (starts with rvn_). |
RIVEN_API_BASE | No | https://api.rivenai.io/v1 | Override the chat completions API base URL. |
RIVEN_COMPUTER_BASE | No | https://computer.rivenai.io | Override 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