Reka

Official17 toolsLive

by reka

Understand your videos with Reka AI — search, ask questions, and extract insights.

ai.reka/mcp (MCP) Server

The ai.reka/mcp server is an MCP server associated with ai.reka/mcp. Its purpose is to help users “understand your videos with Reka AI,” including capabilities to search, ask questions, and extract insights. The repository is described as supporting these functions across related tooling.

🛠️ Key Features

Search videos with Reka AI
Ask questions about video content
Extract insights from videos

🚀 Use Cases

Finding relevant information within videos
Conversational Q&A about video material
Turning video content into extracted insights

⚡ Developer Benefits

Provides an MCP server with 17 tools (toolCount: 17) for integrating video understanding workflows

⚠️ Limitations

Only the provided description is available; no additional constraints or implementation details were included in the source data.

Captured live from the server via tools/list.

upload_video

Upload a video from a URL. Returns a video_id. Local file paths are not accepted; upload files outside the MCP server and pass a reachable video_url. The upload runs asynchronously — poll get_video until status is 'uploaded', then call index_video to enable search and analysis.

Parameters5

video_url	string	required
name	any	optional
description	any	optional
group_id	any	optional
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "video_url": {
      "title": "Video Url",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Group Id"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "video_url"
  ],
  "title": "upload_videoArguments"
}

list_videos

List all videos in your account, or filter to a specific group by passing group_id. Shows upload status and which features have been indexed for each video. Each video's 'url' is a short-lived HTTPS presigned URL (expires within hours) — fetch immediately and do not store; call list_videos or get_video again for a fresh URL when needed.

Parameters2

group_id	any	optional
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Group Id"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "title": "list_videosArguments"
}

get_video

Get detailed information about a video including upload status, metadata (duration, resolution, fps), and per-feature indexing status. Use this to check if upload or indexing is complete. The 'url' field is a short-lived HTTPS presigned URL (expires within hours) — fetch immediately and do not store; call get_video again for a fresh URL when needed.

Parameters2

video_id	string	required
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "video_id": {
      "title": "Video Id",
      "type": "string"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "video_id"
  ],
  "title": "get_videoArguments"
}

update_video

Update a video's display name, title, description, or move it to a different group. At least one field must be provided. To remove a video from its group, pass group_id as null.

Parameters7

video_id	string	required
name	any	optional
title	any	optional
description	any	optional
group_id	any	optional
move_group	boolean	optional
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "video_id": {
      "title": "Video Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Title"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Group Id"
    },
    "move_group": {
      "default": false,
      "title": "Move Group",
      "type": "boolean"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "video_id"
  ],
  "title": "update_videoArguments"
}

delete_video

Permanently delete a video and all its indexed data (transcript, captions, embeddings, etc.). This cannot be undone.

Parameters2

video_id	string	required
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "video_id": {
      "title": "Video Id",
      "type": "string"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "video_id"
  ],
  "title": "delete_videoArguments"
}

create_group

Create a new video group. Groups organize videos into collections. Returns the new group's ID and name.

Parameters2

name	string	required
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "name"
  ],
  "title": "create_groupArguments"
}

list_groups

List all video groups. Use list_videos with a group_id to see videos in a specific group.

Parameters1

rationale

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "title": "list_groupsArguments"
}

delete_group

Delete a video group. Videos in the group are not deleted — they are simply removed from the group.

Parameters2

group_id	string	required
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "group_id": {
      "title": "Group Id",
      "type": "string"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "group_id"
  ],
  "title": "delete_groupArguments"
}

index_video

Index a video for search, QA, or full analysis. Processes the video through a pipeline of AI features. Typically takes 3-7 minutes; longer for long videos or the 'full' pipeline. Times out after 10 minutes by default. Pipelines: - search_only: transcription + captions + embeddings (enables search_videos) - qa_only: transcription + captions (enables ask_video) - full: transcription + captions + embeddings (enables all tools) Scene detection is enabled by default and produces scene boundaries for get_scenes. Pass scene_detection=False to skip it. Prerequisites: if using video_id, the video must be in 'uploaded' status. Use get_video to check status before calling this tool.

Parameters4

video_id	string	required
pipeline	string	optional
scene_detection	boolean	optional
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "video_id": {
      "title": "Video Id",
      "type": "string"
    },
    "pipeline": {
      "default": "search_only",
      "enum": [
        "search_only",
        "qa_only",
        "full"
      ],
      "title": "Pipeline",
      "type": "string"
    },
    "scene_detection": {
      "default": true,
      "title": "Scene Detection",
      "type": "boolean"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "video_id"
  ],
  "title": "index_video_hostedArguments"
}

search_videos

Find WHEN and WHERE something happens across your videos. Returns timestamped results ranked by relevance — use these timestamps as start/end in ask_video for focused analysis. This is the recommended first step for most questions. Instead of asking ask_video about the entire video, search first to narrow down the relevant moments. Each result's 'video_url' is a short-lived HTTPS presigned URL (expires within hours) — fetch immediately and do not store; call search_videos or get_video again for a fresh URL when needed. Requires search_only or full pipeline.

Parameters5

query	string	required
video_ids	any	optional
group_id	any	optional
max_results	integer	optional
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "video_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Video Ids"
    },
    "group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Group Id"
    },
    "max_results": {
      "default": 10,
      "title": "Max Results",
      "type": "integer"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_videosArguments"
}

ask_video

Ask a question about one or more videos with visual analysis. Most effective on focused time ranges — use start/end to specify the segment to analyze. BEFORE calling this tool, read the reka://docs/guide resource for recommended workflows. In most cases, you should first: - search_videos to find WHEN something happens, then pass those timestamps here as start/end - segment_video to detect and locate specific objects - get_transcript to read what was said For single-video questions, pass video_id with start/end. For cross-video questions, pass videos — a list of video references with start/end each. For follow-up questions, pass conversation_id from the previous response. You can add start/end to drill into a specific moment while keeping the conversation context. Requires qa_only or full pipeline.

Parameters7

question	string	required
video_id	any	optional
start	any	optional
end	any	optional
videos	any	optional
conversation_id	any	optional
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "question": {
      "title": "Question",
      "type": "string"
    },
    "video_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Video Id"
    },
    "start": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Start"
    },
    "end": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "End"
    },
    "videos": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/VideoContext"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Videos"
    },
    "conversation_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Conversation Id"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "question"
  ],
  "$defs": {
    "VideoContext": {
      "properties": {
        "video_id": {
          "title": "Video Id",
          "type": "string"
        },
        "start": {
          "title": "Start",
          "type": "number"
        },
        "end": {
          "title": "End",
          "type": "number"
        }
      },
      "title": "VideoContext",
      "type": "object"
    }
  },
  "title": "ask_videoArguments"
}

segment_video

Detect objects in a video segment using text prompts. Describe what to look for and get per-frame detections with bounding boxes and confidence scores. Prompt tips: - Use broad, visual categories: 'animal', 'vehicle', 'person', 'text on screen' - Specific labels ('rabbit', 'Toyota') are less reliable — the detector matches visual patterns, not semantic concepts - Best for confirming whether a category of object appears in a time window, not for precise identification How to pick a time range: - Use search_videos to find WHEN something appears, then pass those timestamps here - Use get_scenes to scan systematically — call segment_video once per scene (scenes typically fit in the 15s window) - Or pass any range you already know Maximum range is 15 seconds per call; for longer spans, make multiple calls with consecutive windows. Does NOT require any feature indexing — works on any uploaded video.

Parameters6

video_id	string	required
prompts	array	required
start	number	required
end	any	optional
threshold	number	optional
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "video_id": {
      "title": "Video Id",
      "type": "string"
    },
    "prompts": {
      "items": {
        "type": "string"
      },
      "title": "Prompts",
      "type": "array"
    },
    "start": {
      "title": "Start",
      "type": "number"
    },
    "end": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "End"
    },
    "threshold": {
      "default": 0.5,
      "title": "Threshold",
      "type": "number"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "video_id",
    "prompts",
    "start"
  ],
  "title": "segment_videoArguments"
}

get_transcript

Get the spoken words in a video. Use this instead of ask_video when you need to read what was said — it returns the actual text, not a summary. Use start/end to narrow results for long videos. Requires the transcript feature to be indexed.

Parameters7

video_id	string	required
format	string	optional
start	any	optional
end	any	optional
max_results	integer	optional
max_chars	integer	optional
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "video_id": {
      "title": "Video Id",
      "type": "string"
    },
    "format": {
      "default": "text",
      "enum": [
        "text",
        "segments",
        "words"
      ],
      "title": "Format",
      "type": "string"
    },
    "start": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Start"
    },
    "end": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "End"
    },
    "max_results": {
      "default": 100,
      "title": "Max Results",
      "type": "integer"
    },
    "max_chars": {
      "default": 10000,
      "title": "Max Chars",
      "type": "integer"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "video_id"
  ],
  "title": "get_transcriptArguments"
}

get_captions

Get AI-generated visual descriptions of what happens on screen. Use this to understand the visual content without watching — each caption describes a short segment with timestamps. Use start/end to narrow results. Requires the captions feature (qa_only or full pipeline).

Parameters5

video_id	string	required
start	any	optional
end	any	optional
max_results	integer	optional
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "video_id": {
      "title": "Video Id",
      "type": "string"
    },
    "start": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Start"
    },
    "end": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "End"
    },
    "max_results": {
      "default": 50,
      "title": "Max Results",
      "type": "integer"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "video_id"
  ],
  "title": "get_captionsArguments"
}

get_scenes

Get detected scene boundaries with start/end timestamps. Use this to understand the video's structure, then pass scene timestamps as start/end to: - ask_video for per-scene contextual analysis - segment_video to detect specific objects per scene (scenes typically fit in segment_video's 15s max range) Requires transcript indexed with scene detection (on by default; skipped only if index_video was called with scene_detection=False).

Parameters3

video_id	string	required
max_results	integer	optional
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "video_id": {
      "title": "Video Id",
      "type": "string"
    },
    "max_results": {
      "default": 200,
      "title": "Max Results",
      "type": "integer"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "video_id"
  ],
  "title": "get_scenesArguments"
}

get_feature_catalog

List available video analysis features with their dependencies and descriptions. Use this to understand what features exist and what pipelines to use with index_video.

Parameters1

rationale

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "title": "get_feature_catalogArguments"
}

summarize_video

Start here. Get a compact overview of a video: metadata, which features are indexed, a transcript preview, and scene count. Use this to decide which tools to call next — then use segment_video to detect specific objects in time ranges of interest.

Parameters2

video_id	string	required
rationale	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "video_id": {
      "title": "Video Id",
      "type": "string"
    },
    "rationale": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rationale"
    }
  },
  "required": [
    "video_id"
  ],
  "title": "summarize_videoArguments"
}

Install

Tools (17)

upload_videolist_videosget_videoupdate_videodelete_videocreate_grouplist_groupsdelete_group

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "reka-mcp"
      ]
    }
  }
}

ai.reka/mcp (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

upload_video

list_videos

get_video

update_video

delete_video

create_group

list_groups

delete_group

index_video

search_videos

ask_video

segment_video

get_transcript

get_captions

get_scenes

get_feature_catalog

summarize_video

Install

Related servers