MCP Server

The Reka Vision MCP server lets agent clients such as Claude Code work with your video library. Agents can upload videos, index them for search and Q&A, find relevant moments, inspect transcripts and captions, and ask focused questions about video content.

Use MCP when you want an agent to research across videos from a local workspace or chat client, without wiring each Vision API endpoint into the agent yourself.

Prerequisites

Before you start, make sure you have:

• A Reka API key from platform.reka.ai
• Python 3.12 or later
• uv installed so you can run the server with uvx

Check your local versions:

$
python --version
$
uv --version

Configure your MCP client

MCP clients start the Reka MCP server from their configuration. Add the server to the client you want to use.

Claude Code

Register the server from the command line:

$
claude mcp add reka-mcp -e REKA_VISION_API_KEY=YOUR_API_KEY -- uvx reka-mcp

Claude Desktop

Add the server to ~/Library/Application Support/Claude/claude_desktop_config.json:

1
{
2
  "mcpServers": {
3
    "reka-mcp": {
4
      "command": "uvx",
5
      "args": ["reka-mcp"],
6
      "env": {
7
        "REKA_VISION_API_KEY": "YOUR_API_KEY"
8
      }
9
    }
10
  }
11
}

Restart Claude Desktop after updating the config.

Codex

Register the server from the command line:

$
codex mcp add --env REKA_VISION_API_KEY=YOUR_API_KEY reka-mcp -- uvx reka-mcp

Cursor

Add the server to .cursor/mcp.json:

1
{
2
  "mcpServers": {
3
    "reka-mcp": {
4
      "command": "uvx",
5
      "args": ["reka-mcp"],
6
      "env": {
7
        "REKA_VISION_API_KEY": "YOUR_API_KEY"
8
      }
9
    }
10
  }
11
}

Verify installation

After configuring your MCP client, restart it and confirm that the Reka MCP server is available.

Updating

Check which version you’re running:

$
uvx reka-mcp --version

To update to the latest version, clear the cached package and restart your MCP client:

$
uv cache clean reka-mcp

Available tools

With the MCP server connected, your agent can:

• Manage videos: Upload, list, inspect, update, and delete videos
• Organize video libraries: Create, list, and delete video groups
• Prepare videos for analysis: Index videos for search, Q&A, or full analysis
• Research and search: Find timestamped moments across indexed videos
• Understand video content: Ask visual questions about one or more videos
• Inspect source context: Read transcripts, captions, scenes, and feature status
• Detect objects: Locate prompted visual elements in short video segments

The MCP server is open source at github.com/reka-ai/reka-mcp.