summarize_video

Generate a structured video summary that covers key scenes, topics discussed, and a rough timeline. Useful for meetings, lectures, product demos, and any long-form content.

Parameters

Parameter	Type	Required	Description
videoPath	string	✓	Path to the video, file:// URI, or remote URL
provider	string	—	Override the AI provider: glm, gemini, qwen, kimi, mimo

Usage Examples

Summarize a local video:

“Summarize ./long-video.mp4”

Summarize a meeting recording:

“Give me a structured summary of this meeting: ./meeting-2024-01-15.mp4”

Summarize a YouTube video:

“Summarize this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ”

Use a specific provider:

“Summarize ./lecture.mp4 using Kimi”

Keyframe Extraction

For GLM, Kimi, Qwen, and MiMo, the server extracts keyframes from the video before sending them to the AI. The VIDEO_MCP_MAX_FRAMES environment variable controls how many frames are extracted:

Tier	Default	Maximum
Free	50 frames	50 (clamped)
Pro	100 frames	Uncapped (set 0 for unlimited)

Trailing frames are automatically dropped if the total payload would exceed the provider’s size limit. Gemini uploads the full video natively — keyframe limits do not apply.

S3 relay bypasses these limits

When S3 relay is configured (AWS_S3_BUCKET set) and the provider is GLM, Qwen, or MiMo, the video is uploaded to S3 and a presigned URL is passed directly to the provider — regardless of video length or file size. No keyframe extraction runs, so VIDEO_MCP_MAX_FRAMES does not apply.

The frame limits still apply when S3 relay is not configured, for Kimi videos larger than 100 MB (which fall back to frames), or if the S3 upload fails and the server falls through to the frame-extraction path.