Skip to main content
Glama
riven-mcp
by rivenai

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_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

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools follow a consistent 'riven_' prefix with a noun that describes the action: chat, council, research, usage. Predictable and clear.

    Tool Count5/5

    4 tools is well-scoped for an AI assistant server, covering the main interaction modes without being too few or too many.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Lightweight MCP server that exposes tools for system information and weather lookup, designed for agent integration via stdio.
      1
      -
    • A
      license
      C
      quality
      D
      maintenance
      Exposes 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.
      22
      7
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A local MCP server that gives AI agents access to developer tooling — GitHub (read-only), documentation search, and web research — via stdio transport.
      MIT