Local video media (MCP)
VidSeeds.ai follows client-first media: the hosted MCP server does not read files from the user's computer. Tools return recipes (ffmpeg/ffprobe commands) or accept base64 frames the agent extracted locally.
Probe a file
vidseeds_probe_local_video- duration, resolution, codecs; use before trim or thumbnail frame picks.
Frames and clips
| Goal | Tool |
|---|---|
| Still frames for thumbnails | vidseeds_extract_video_frames |
| Short clip for context | vidseeds_extract_video_clip |
| Generic transcode recipe | vidseeds_transcode_format_recipe |
| Media helper commands | vidseeds_get_local_media_recipe |
Run returned shell commands on the user's machine (requires ffmpeg/ffprobe installed). Pass results back into thumbnail tools as frames on vidseeds_generate_thumbnail when needed.
Precision trim
vidseeds_analyze_precision_trim- suggested cut points, segment catalog, seed cost preview.vidseeds_plan_precision_trim- AI edit plan (CritiquePlan) with genre-aware processing.vidseeds_execute_precision_trim- export recipe/commands for local ffmpeg.
V3 Genre-Aware Processing (2026-06-27)
Precision Trim V3 adds genre classification + soundscape analysis + motion profile + hook detection + semantic boundaries as parallel client-side signals. These are passed as optional metadata in vidseeds_analyze_precision_trim / vidseeds_plan_precision_trim inputs:
detectedGenre- overrides automatic genre detection (speech_driven, action_dynamic, ambient_relax, visual_primary, mixed_narrative, tutorial)soundscape- spectral classification from PCM (silence/speech/music/ambient/noise)motionProfile- frame-by-frame pixel diff analysis (static/slow/action/scene_change)
How it affects plans:
- ambient_relax: high silence tolerance (15s+), preserves zero-word scenes, < 20% cut ratio
- action_dynamic: aggressive pause trimming (500ms+), up to 40% cut ratio
- speech_driven: cut at semantic boundaries, moderate trimming
- visual_primary: preserves scenes without speech, cut only on true silence
- mixed_narrative: uses all signals - only cuts when multiple agree
- tutorial: precision trimming, no speed around instructions
Midroll placement
vidseeds_analyze_midroll_opportunities- suggested mid-roll times from transcript/context (analysis only; user edits in their editor).
Thumbnails from local file
Prefer the vidseeds-local stdio MCP tool vidseeds_generate_thumbnail_from_video when the whole pipeline should run on-disk (see vidseeds-thumbnails).
YouTube-hosted source (not local path)
vidseeds_get_youtube_video_transcript,vidseeds_get_youtube_video_captions- text from YouTube without downloading video to the server.
Do not
- Expect hosted tools to accept arbitrary filesystem paths for upload/processing.
- Re-run probe/extract in a loop - cache probe results for the session.