Reka Vision MCP Server

mcp-name: ai.reka/mcp

MCP server that lets AI agents upload, index, search, and analyze videos through the Reka Vision API. Agents can search across videos using natural language, ask questions about video content with visual analysis, detect objects in specific time ranges with text prompts, and read processed data like transcripts, captions, and scenes.

Quick Start

# Run the published local stdio server with your Reka API key
REKA_VISION_API_KEY="your-api-key" uvx reka-mcp

For MCP clients that need explicit command configuration:

{
  "command": "uvx",
  "args": ["reka-mcp"],
  "env": {
    "REKA_VISION_API_KEY": "your-api-key-here"
  }
}

For local development:

uv sync
uv run pre-commit install
REKA_VISION_API_KEY="test-key" uv run reka-mcp

The default mode is local stdio. In local mode, REKA_VISION_API_KEY is read once from the process environment and used for all requests.

Hosted Mode

Hosted mode runs the same MCP tools over Streamable HTTP. It does not use a process-wide Reka API key. Instead, each MCP HTTP request must include the user's key in X-Reka-API-Key; the server forwards that value to the Reka Vision API as x-api-key for that request only.

Production-style hosted startup:

REKA_MCP_MODE=hosted \
REKA_MCP_HTTP_HOST=0.0.0.0 \
PORT=8080 \
uv run reka-mcp

Endpoints:

• MCP Streamable HTTP: http://<host>:<port>/mcp
• Health check: http://<host>:<port>/health

Hosted clients must send:

X-Reka-API-Key: your-api-key

REKA_MCP_AUTH_TOKEN is optional MCP transport auth. When set, HTTP clients must also send Authorization: Bearer <token>.

index_video works the same in both modes: it polls the feature DAG until all requested features are ready (or times out). After upload_video, poll get_video until the video status is uploaded, then call index_video.

Run Hosted Mode Locally

Hosted mode enables DNS rebinding protection. Its default allowed hosts and origins are production/staging domains, so override them for localhost testing:

REKA_MCP_MODE=hosted \
REKA_MCP_TRANSPORT=http \
REKA_MCP_HTTP_HOST=0.0.0.0 \
REKA_MCP_HTTP_PORT=8080 \
PORT=8080 \
REKA_MCP_HTTP_PATH=/mcp \
REKA_MCP_ALLOWED_HOSTS="localhost:*,127.0.0.1:*" \
REKA_MCP_ALLOWED_ORIGINS="http://localhost:*,http://127.0.0.1:*" \
uv run reka-mcp

Then connect to http://localhost:8080/mcp and configure your MCP client or inspector to send X-Reka-API-Key. Check the server with:

curl -H "Host: localhost:8080" http://localhost:8080/health

Connect to Hosted MCP (mcp.reka.ai)

No installation required — connect directly to the hosted server with your Reka API key.

Claude Desktop

Claude Desktop does not speak Streamable HTTP directly, so use the mcp-remote bridge. Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "reka-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.reka.ai/mcp",
        "--header",
        "X-Reka-API-Key:${REKA_VISION_API_KEY}"
      ],
      "env": {
        "REKA_VISION_API_KEY": "your-api-key-here"
      }
    }
  }
}

Requires Node.js installed locally. Restart Claude Desktop after editing the config.

Claude Code

claude mcp add --transport http reka-mcp https://mcp.reka.ai/mcp \
  --header "X-Reka-API-Key: your-api-key-here"

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "reka-mcp": {
      "type": "streamable-http",
      "url": "https://mcp.reka.ai/mcp",
      "headers": {
        "X-Reka-API-Key": "your-api-key-here"
      }
    }
  }
}

Claude Desktop Setup (Local)

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

{
  "mcpServers": {
    "reka-mcp": {
      "command": "uvx",
      "args": ["reka-mcp"],
      "env": {
        "REKA_VISION_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor Setup (Local)

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "reka-mcp": {
      "command": "uvx",
      "args": ["reka-mcp"],
      "env": {
        "REKA_VISION_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code Setup (Local)

claude mcp add reka-mcp -e REKA_VISION_API_KEY=your-api-key-here -- uvx reka-mcp

Updating

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

uv cache clean reka-mcp

To check which version you're running:

uvx reka-mcp --version

Available Tools

Environment Variables

Release Checks

cd /path/to/reka-mcp
uv build
uv run twine check dist/*
# Publish only after explicit approval:
uv run twine upload dist/*

Example Workflows

Search and Visual Q&A

Agent: search_videos(query="revenue chart")
→ [{video_id: "v1", start: 30.0, end: 35.0, score: 0.95}]

Agent: ask_video(question="What numbers are on the chart?",
                 video_id="v1", start=30.0, end=35.0)
→ {answer: "Q3 revenue of $4.2M, up 32%...", conversation_id: "c1"}

Agent: ask_video(question="What's the percentage change?",
                 conversation_id="c1")
→ {answer: "Revenue increased by 32% quarter-over-quarter..."}

Cross-Video Comparison

Agent: search_videos(query="quarterly revenue")
→ [{video_id: "v1", start: 30.0, ...}, {video_id: "v2", start: 120.0, ...}]

Agent: ask_video(question="How do the revenue figures compare?",
                 videos=[
                   {video_id: "v1", start: 30.0, end: 35.0},
                   {video_id: "v2", start: 120.0, end: 125.0}
                 ])
→ {answer: "Video 1 shows Q3 at $4.2M while Video 2 shows Q4 at $5.1M..."}

Video Summary and Transcript Extraction

Agent: summarize_video(video_id="v1")
→ {name: "Lecture 3", duration_seconds: 3600, features: {...},
   scene_count: 42, transcript_preview: "Welcome to today's lecture..."}

Agent: get_transcript(video_id="v1", format="segments", start=0, end=60)
→ {data: [{start: 0.0, end: 5.2, text: "Welcome..."}, ...],
   total_count: 12, truncated: false}