reka-ai/reka-mcp

reka-ai/reka-mcp

Description: Reka AI's MCP server

Language: Python

License: NOASSERTION

Stars: 0

Forks: 0

Open issues: 0

Created: 2026-04-28T07:52:10Z

Pushed: 2026-05-14T04:51:13Z

Default branch: main

Fork: no

Archived: no

README:

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://:/mcp
• Health check: http://:/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 .

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

| Tool | Description | |------|-------------| | upload_video | Upload a video from a URL | | list_videos | List videos in your account or a group | | get_video | Get video details, metadata, and feature status | | update_video | Update a video's name, title, description, or group | | delete_video | Permanently delete a video and all indexed data | | create_group | Create a new video group | | list_groups | List all video groups | | delete_group | Delete a video group | | index_video | Index a video for search/QA/analysis. Waits until all requested features are ready (2-10 min). | | search_videos | Semantic search across indexed videos | | ask_video | Ask questions about video content with visual analysis | | get_transcript | Get transcript as text, segments, or words | | get_captions | Get AI-generated visual descriptions | | get_scenes | Get detected scene boundaries | | get_feature_catalog | List available features and dependencies | | summarize_video | Compact overview of video content and status |

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | REKA_MCP_MODE | local | Runtime mode: local or hosted | | REKA_VISION_API_KEY | *(required in local mode)* | API key from https://platform.reka.ai. Not used as the primary auth source in hosted mode. | | REKA_VISION_API_URL | https://vision-agent.api.reka.ai | API base URL | | REKA_MCP_INDEX_TIMEOUT | 600 | Max seconds to wait for indexing | | REKA_MCP_POLL_INTERVAL | 5 | Seconds between index status polls | | REKA_MCP_TRANSPORT | stdio in local, http in hosted | Transport: stdio or http | | REKA_MCP_HTTP_HOST | 127.0.0.1 in local, 0.0.0.0 in hosted | Host for HTTP transport | | REKA_MCP_HTTP_PORT | 8080 | Port for HTTP transport. In…