riven-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@riven-mcp research the impact of quantum computing on cybersecurity"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Send a single prompt to a Riven chat model and return the completion text. |
| Create a Computer research task, run it, poll until done, and return a summary of the thread. |
| Create a Computer council task (multiple models answer the same prompt) and return the verdict and transcript. |
| Return current usage statistics for the authenticated account. |
Related MCP server: gemini-cli-bridge
Install
npm install -g @rivenai/riven-mcpOr 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 |
| Yes | — | Your Riven API key (starts with |
| No |
| Override the chat completions API base URL. |
| No |
| 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.jsNotes 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 toolsriven_chatRiven ChatAInspect
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_councilRiven CouncilAInspect
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_researchRiven ResearchAInspect
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_usageRiven UsageAInspect
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
Scored across 4 tools
Each tool has a clearly distinct purpose: chat for single-turn, council for multi-model debate, research for multi-step agentic work, and usage for account stats. No overlap or confusion.
All tools follow a consistent 'riven_' prefix with a noun that describes the action: chat, council, research, usage. Predictable and clear.
4 tools is well-scoped for an AI assistant server, covering the main interaction modes without being too few or too many.
The tool set covers the primary use cases (single chat, multi-model, research, usage). Missing tools like account management or model listing, but the core workflows are complete.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
MCP server for RiverScript, an AI transcription platform - fetches transcripts shared via a link.
Related MCP Servers
- FlicenseAqualityDmaintenanceLightweight MCP server that exposes tools for system information and weather lookup, designed for agent integration via stdio.1-
- AlicenseCqualityDmaintenanceExposes the local Gemini CLI as an MCP stdio server, providing tools for prompting, web search, file operations, and MCP management, enabling AI clients like Codex CLI and Claude Code to interact with Gemini.227MIT
- FlicenseNot gradedqualityDmaintenanceA production-ready MCP server providing file, system, math, and text utilities through a simple CLI client.-
- AlicenseNot gradedqualityDmaintenanceA local MCP server that gives AI agents access to developer tooling — GitHub (read-only), documentation search, and web research — via stdio transport.MIT