Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

vid2context

NPM · VID2CONTEXT-MCP · 2 COMPONENTS

Turn any video into context for AI agents: transcripts, metadata, chapters, timestamps.

+18 this week 75 Trust /100

Last scanned (20 hours ago)

Scores higher than 51% of npm servers

Category Search and Retrieval

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • No production dependencies, so there is no dependency health to assess. View diagnostics → Pass
Provenance & Transparency48
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
  • Clear OSI-approved license (Apache-2.0).Pass
  • Actively maintained (last published 1 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability76
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 7217 tokens (~189/item across 38 items; 37 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
  • Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (16% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 37 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 39 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
  • Supports UI / widget rendering.Pass
What we tested

Checks we ran (17)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol
  • Capabilities

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

  • 19 Nov 26 +2
    • Tool safety: pass → unverified ▼ security
    • Known CVEs: pass → unverified ▼ security
    • Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
    • Tool coverage: 21% → 16% ▼ functional
    • Schema quality: 151 → 189 ▼ functional
    • Capabilities: pass → unverified ▼ functional
    • Tool coverage: 100 → unverified ▼ functional
    • Schema quality: 100 → unverified ▼ functional
    • Stability: unverified → 0.17 ▲ functional
    • Package version: 0.1.1 → 0.2.1 functional
    • Package version: 0.1.1 → 0.2.0 functional
  • 15 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 14 Nov 26 57

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed npm/vid2context-mcp@0.2.1

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm

Background: How many MCP packages publish verified provenance →

Dependencies 0 packages
Packages resolved 0
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 37 exposed · ~7,037 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
add_to_collection ~107

Ingest videos into a collection now: each URL is a video or a list (playlist, channel, feed), and lists are expanded. Transcripts come from captions first, speech-to-text only when needed. Videos already in the collection are skipped and per-video failures are reported without stopping. Returns the updated collection and a summary (added, skipped, failed with hints).

NameTypeReqDescription
collectionstringyesCollection id
urlsarrayyesVideo, playlist, channel or feed URLs

No output schema declared.

No examples provided.

ask ~116

Answer a question from the transcripts of one or more videos, or a saved collection, with server-side retrieval and the free-first LLM chain. Every factual sentence cites a numbered source; each source is a timestamp link to the moment that supports it. Says so plainly when the videos do not cover the question. Use it when you want a cited answer without reading whole transcripts.

NameTypeReqDescription
collectionstring–A collection id
questionstringyesThe question
urlsarray–Video URLs or ids like youtube:abc

No output schema declared.

No examples provided.

build_brief ~205

Build a cited brief across videos on the server with a free LLM (map-reduce for large collections). Every claim cites a video, timestamp and quote that were checked against the transcript; points are marked consensus (two or more videos agree), disputed (both sides cited) or single-source, and claims that failed the check are listed separately, uncited. If you can read the transcripts yourself, the `brief` prompt is cheaper and usually better; use this for collections too large for your context.

NameTypeReqDescription
collectionstring–A saved collection id
formatstring–markdown (default): the brief as Markdown; json: the full Brief object
questionstring–What the brief should answer, e.g. "Which G-Wagon year should I buy?"
templatestring–brief (default) or buyer-guide, tutorial-steps, comparison, summary
urlsarray–Up to 25 video URLs or ids

No output schema declared.

No examples provided.

choose_caption_track ~78

List a video's caption tracks (languages, creator or auto-generated) and ask the user to pick one, then return that transcript with [m:ss] timestamps. Without a picker in this client, or when the user declines, returns the track list so you can call get_transcript with a language.

NameTypeReqDescription
urlstringyesVideo URL

No output schema declared.

No examples provided.

create_collection ~94

Create a research collection. sources are playlists, channels or podcast feeds the collection follows: add_to_collection or a refresh ingests their videos, and watch lists pick up new uploads. Returns the collection with its id.

NameTypeReqDescription
descriptionstring–What the collection is about
namestringyesCollection name, for example "G-Wagon"
sourcesarray–Playlist, channel or feed URLs to follow

No output schema declared.

No examples provided.

digest_videos ~194

Build one cited digest of several videos (a playlist, a collection, or a list of URLs) using MCP sampling: the server asks the client's model to take notes on each part of each transcript, then combine them. Every claim cites [Title @ m:ss](link), and every timestamp is checked against the real transcript. No server key is needed. If this client cannot sample, the result is a chunk plan with the exact instructions, so you can do the same work yourself.

NameTypeReqDescription
collectionstring–A collection id or name; its saved videos are digested
maxTokensPerVideointeger–Most transcript tokens sent in one sampling call; longer videos are split by chapter or time. Default 6000
questionstring–A question the digest should answer
urlsarray–Video URLs, playlists or channels (expanded into their videos), saved video ids or titles

No output schema declared.

No examples provided.

download_batch ~337

Save several videos at once: a list of URLs, playlists or channels (expanded up to limit), each as video, audio or captions only. Failed items are reported and do not stop the rest. zip: true returns one .zip with every file. Video formats: mp4, webm, mkv; audio: mp3, m4a, opus, flac, wav; captions: srt, vtt, ass, ttml, sbv, lrc, csv, txt, json, markdown, original. Download only media you have the rights to: your own uploads, public-domain or Creative Commons works, or videos the site lets you download.

NameTypeReqDescription
dirstring–Folder to save to: absolute, ~/..., or relative to the default folder
formatstring–Format for that kind, e.g. mp4, mp3 or srt
kindstring–What each video becomes. Default video
languagesarray–captions: language codes or ["all"]
limitinteger–Most videos in total. Default and cap: VID2CONTEXT_MAX_PLAYLIST_ITEMS
modestring–captions: auto, captions or stt
playlistboolean–Expand video links that also name a playlist (watch?v=...&list=...)
qualitystring–Video: 1080, 720, ...; mp3: kbps
urlsarrayyesVideo, playlist or channel URLs, YouTube ids or file paths
zipboolean–Return one .zip with every saved file

No output schema declared.

No examples provided.

download_captions ~490

Save the captions of a video as srt, vtt, ass, ttml, sbv, lrc, csv, txt, json, markdown or the original file the site serves, to a folder on this machine; returns the path. offsetSec retimes the cues, maxLineChars and maxLines reflow them, and secondary adds a second language under each caption. Works for every source vid2context reads, through its transcript pipeline (no yt-dlp needed), with yt-dlp as a second path; for a video without captions, mode auto (default) transcribes the audio with speech-to-text. languages: one or several codes, or ["all"] for every track; several files come as one .zip. Files go to dir, else VID2CONTEXT_DOWNLOAD_DIR, else ~/Downloads/vid2context.

NameTypeReqDescription
allowAutoboolean–Accept the platform's automatic captions. Default true
allowTranslatedboolean–Accept the platform's machine translation. Default true
dirstring–Folder to save to: absolute, ~/..., or relative to the default folder
formatstring–srt, vtt, ass, ttml, sbv, lrc, csv, txt, json, markdown, original (default srt; original keeps the site's file)
languagesarray–Language codes, e.g. ["en","de"], or ["all"]. Default: the spoken language
maxLineCharsinteger–Longest caption line in characters (cue formats, default 42)
maxLinesinteger–Most lines per cue (default 2)
modestring–auto (captions, else speech-to-text; default), captions (never transcribe), stt (always transcribe)
offsetSecnumber–Shift every cue by this many seconds (negative: earlier); timed formats only
secondarystring–A second language shown under each caption, e.g. "de" (bilingual formats)
timestampsboolean–txt only: one "[m:ss] line" per caption
urlstringyesVideo URL, YouTube id or local file path
viastring–auto (default), pipeline or ytdlp
zipboolean–Return a .zip even for one file

No output schema declared.

No examples provided.

download_media ~632

Save a video as mp4, webm or mkv, or its audio as mp3, m4a, opus, flac or wav, to a folder on this machine; returns the file paths. Works for YouTube and the other sites yt-dlp supports, and converts local files. Defaults: video mp4 up to 1080p (H.264 + stereo AAC, plays everywhere), audio mp3 at the best VBR quality, with title, cover art and chapters embedded. Keep a part with from/to (seconds or m:ss) or chapter (index or title); cut sponsor reads with removeSegments (YouTube). A playlist or channel URL downloads its first `limit` videos. Files go to dir, else VID2CONTEXT_DOWNLOAD_DIR, else ~/Downloads/vid2context. Download only media you have the rights to: your own uploads, public-domain or Creative Commons works, or videos the site lets you download.

NameTypeReqDescription
burnSubtitlesstring–Burn one language's subtitles into the picture, e.g. "en" (video only; re-encodes, so slower)
chapterstring–Keep one chapter: 0-based index or title (see get_media_options)
dirstring–Folder to save to: absolute, ~/..., or relative to the default folder
embedChaptersboolean–Chapter markers. Default true
embedMetadataboolean–Title, channel and date tags. Default true
embedThumbnailboolean–Cover art. Default true
exactCutsboolean–Re-encode at the cut points so a trimmed video starts exactly at from (slower)
formatstring–mp4 (default for video), webm, mkv, mp3 (default for audio), m4a, opus, flac, wav
fromstring–Start of the part to keep: seconds, m:ss or h:mm:ss
kindstring–video or audio. Default: from format, else video
limitinteger–Playlists and channels: how many videos to download. Default 10
qualitystring–Video: best, 2160, 1440, 1080, 720, 480, 360, 240, 144 (smaller side in pixels; default 1080). Audio: best, 320, 256, 192, 160, 128, 96, 64 (mp3 kbps; default best)
removeSegmentsarray–SponsorBlock categories to cut out (YouTube)
splitChaptersboolean–Also save one file per chapter, in a folder next to the full file. Not with from/to/chapter
subtitlesarray–Subtitle languages to embed in a video, e.g. ["en"]
tostring–End of the part to keep
urlstringyesVideo, playlist or channel URL, YouTube id, or local file path

No output schema declared.

No examples provided.

download_thumbnail ~144

Save a video's thumbnail (cover image) as jpg, png or webp to a folder on this machine; returns the path. For YouTube and other sites it takes the largest image the site lists; for a local file, its cover art, else a frame from the first tenth of the video. Files go to dir, else VID2CONTEXT_DOWNLOAD_DIR, else ~/Downloads/vid2context.

NameTypeReqDescription
dirstring–Folder to save to: absolute, ~/..., or relative to the default folder
formatstring–jpg (default), png or webp
urlstringyesVideo URL, YouTube id or local file path

No output schema declared.

No examples provided.

export_clip ~249

Save a short part of a video as an animated GIF (default) or WebP to a folder on this machine. from and to are seconds or m:ss (default 5 s from from); fps default 10 and width default 480, both capped by the server limits (VID2CONTEXT_MAX_CLIP_*). For a video clip with sound use download_media with from and to. Download only media you have the rights to: your own uploads, public-domain or Creative Commons works, or videos the site lets you download.

NameTypeReqDescription
dirstring–Folder to save to: absolute, ~/..., or relative to the default folder
formatstring–gif (default) or webp
fpsinteger–Frames per second, default 10
fromstring|number–Start: seconds, m:ss or h:mm:ss. Default 0
loopboolean–Repeat forever (default true)
tostring|number–End. Default from + 5 s
urlstringyesVideo URL, YouTube id or local file path
widthinteger–Width in pixels, default 480

No output schema declared.

No examples provided.

export_context_pack ~168

One Markdown document for many videos (the pack format): a header per video with title, channel, URL and chapters, then each transcript in timestamped paragraphs. Set maxTokens to fit a budget: the pack trims transcripts to fit and says what it left out. Cost: about 12k tokens per hour of video unless maxTokens caps it. Prefer get_outline, get_section and search_transcript when you only need parts.

NameTypeReqDescription
collectionstring–Export this saved collection (id or name)
limitinteger–Most videos taken from each playlist, channel or feed. Default: 50
maxTokensinteger–Token budget for the whole pack
urlsarray–Video, playlist, channel or feed URLs (lists are expanded into their videos)

No output schema declared.

No examples provided.

export_notion ~128

Create one Notion page per video under a parent page (chapters as headings, paragraphs with timestamp links, a bookmark to the video). Re-exporting updates the same pages instead of duplicating them. Needs NOTION_TOKEN; the parent page comes from parentPageId or NOTION_PARENT_PAGE_ID.

NameTypeReqDescription
collectionstring–A saved collection id to export
parentPageIdstring–Notion page id or URL to create the pages under. Default: NOTION_PARENT_PAGE_ID
urlsarray–Video, playlist, channel or feed URLs to export

No output schema declared.

No examples provided.

export_obsidian ~180

Write one Markdown note per video into a folder of an Obsidian vault on this machine: frontmatter properties, chapters as headings, paragraphs prefixed with [m:ss] timestamp links, plus an index note with [[wikilinks]] when a collection is exported. Notes vid2context wrote before are updated; other existing notes are never replaced unless overwrite is true.

NameTypeReqDescription
collectionstring–A saved collection id to export
folderstring–Folder inside the vault. Default: the collection name, or "vid2context"
overwriteboolean–Replace existing notes not written by vid2context for the same video. Default false
urlsarray–Video, playlist, channel or feed URLs to export
vaultPathstringyesAbsolute path of the vault (or any folder) to write into

No output schema declared.

No examples provided.

extract ~171

Extract structured JSON from videos with a template (buyer-guide, tutorial-steps, comparison, summary, brief) or your own JSON Schema. The answer is validated against the schema (one repair attempt), and every citation ({videoId, startSec, quote}) is checked against the transcript: verified ones gain a title and timestamp url, failed ones are removed and listed in "unverified".

NameTypeReqDescription
collectionstring–A saved collection id
questionstring–Focus for the extraction
schemaobject–A JSON Schema (type, properties, required, items, enum, min/max limits). The result is {data, citations}.
templatestring–Template id; default summary when no schema is given
urlsarray–Up to 25 video URLs or ids

No output schema declared.

No examples provided.

find_duplicates ~143

Compare the transcripts of several videos and group reuploads (the same video uploaded again) and clips (an excerpt of a longer video, with the [m:ss] where it starts in the original and the range it covers). Use it before writing a brief across many videos: count each group once (representativeOf maps every video to its original), or a clip agreeing with its own source looks like consensus. Related pairs share passages without being copies. Works on transcripts only; re-dubbed or translated reuploads are not detected.

NameTypeReqDescription
collectionstring–A saved collection id
urlsarray–Video URLs or ids; playlists and channels are expanded

No output schema declared.

No examples provided.

get_caption_options ~103

Every caption track of one video (YouTube, any site yt-dlp reads, or a local file with sidecar or embedded subtitles): language, name, creator or automatic, which provider lists it, the languages the platform can machine-translate into, and whether speech-to-text can make a transcript when there are none. Nothing is downloaded. Call it before download_captions.

NameTypeReqDescription
urlstringyesVideo URL, YouTube id or local file path

No output schema declared.

No examples provided.

get_collection ~69

A collection with a summary of each video (id, title, channel, duration, URL, transcript origin), the sources it follows, inputs waiting for the next refresh and its watch list. Read transcripts with get_transcript, get_outline or search_transcript.

NameTypeReqDescription
collectionstringyesCollection id

No output schema declared.

No examples provided.

get_comments ~106

Top comments of a video, with creator replies and pinned comments flagged. Useful for corrections, follow-up questions and audience consensus that the video itself lacks. Cost: about 50 tokens per comment; limit defaults to 50. Only sources whose provider can read comments support this.

NameTypeReqDescription
limitinteger–Most comments to return. Default: 50
urlstringyesVideo URL (YouTube and more), a YouTube video id, or a local media file path
NameTypeReqDescription
commentsarrayyes–
countnumberyes–
titlestringyes–
urlstring––

No examples provided.

get_key_moments ~88

The moments of a video worth jumping to, picked by the free-first LLM chain from the timestamped transcript. Every timestamp is checked against the real transcript (snapped within 5 seconds, dropped otherwise); the result says how many were dropped and which rung answered.

NameTypeReqDescription
countinteger–How many moments. Default 8
urlstringyesVideo URL

No output schema declared.

No examples provided.

get_media_options ~110

Qualities, formats and estimated file sizes for downloading one video (YouTube or any site yt-dlp supports, or a local file): video sizes per quality for mp4, webm and mkv, audio sizes for mp3 (by bitrate), m4a, opus, flac and wav, plus chapters and subtitle languages. Nothing is downloaded. Call it before download_media to pick a quality that fits.

NameTypeReqDescription
urlstringyesVideo URL, YouTube id or local file path

No output schema declared.

No examples provided.

get_metadata ~75

Title, channel, description, duration, publish date, chapters, tags and language for a video URL or local file, without fetching the transcript. Cheap: a few hundred tokens, mostly the description.

NameTypeReqDescription
urlstringyesVideo URL (YouTube and more), a YouTube video id, or a local media file path

No output schema declared.

No examples provided.

get_outline ~198

Start here for any video longer than about 20 minutes. Returns the metadata and the video's chapters (or sections of about five minutes when it has none), each with its start time, a timestamp link and its estimated token count, plus the total. Then read only what you need with get_section (by chapter index or title, or by time). Fetches the transcript once (saved for later calls); the outline itself costs about 300 to 1,500 tokens.

NameTypeReqDescription
languagestring–Preferred transcript language (BCP-47, e.g. en, de). Default: the spoken language
modestring–Transcript strategy: auto (captions, then speech-to-text), captions only, stt (always transcribe), video (multimodal model). Default: auto
urlstringyesVideo URL (YouTube and more), a YouTube video id, or a local media file path
NameTypeReqDescription
chaptersarrayyes–
durationSecnumberyes–
metadataobjectyes–
nextstringyes–
sectionsstringyeschapters: the video's own chapters; time: sections of about five minutes
titlestringyes–
totalTokensnumberyes–
transcriptobjectyes–
urlstring––

No examples provided.

get_section ~296

One chapter or time range of a video's transcript, with the same header as get_transcript. Pass chapter (an index or title from get_outline) or from/to (seconds, m:ss or h:mm:ss); from alone reads to the end, to alone reads from the start. Cost: the section's token count from get_outline (about 1k tokens per 5 minutes of speech).

NameTypeReqDescription
chapter––A chapter index from get_outline, or a chapter title (exact, prefix, then substring match, case-insensitive)
formatstring–Output format. Default: text
from––Start time: seconds (754), m:ss (12:34) or h:mm:ss (1:02:03). Default: the start
languagestring–Preferred transcript language (BCP-47, e.g. en, de). Default: the spoken language
modestring–Transcript strategy: auto (captions, then speech-to-text), captions only, stt (always transcribe), video (multimodal model). Default: auto
timestampsboolean–Prefix lines with [m:ss] timestamps. Default: true
to––End time (exclusive), same forms as from. Default: the end
urlstringyesVideo URL (YouTube and more), a YouTube video id, or a local media file path

No output schema declared.

No examples provided.

get_skip_segments ~229

Community-marked SponsorBlock segments of a YouTube video: sponsor reads, self-promotion, subscribe reminders, intros, outros, previews and filler, each with its [m:ss] range, a timestamp URL and how much of the transcript it covers (lines, word share and the first words). Use it to leave ad copy out of summaries and briefs: never cite text inside these segments as a claim about the topic. Default categories: sponsor, selfpromo, interaction, intro, outro, preview, filler. All: sponsor, selfpromo, interaction, intro, outro, preview, hook, filler, music_offtopic, poi_highlight, exclusive_access, chapter. poi_highlight comes back as `highlight` (a point, not a skip); a whole-video label comes back as `fullVideo`. Other platforms return no segments. Results carry the SponsorBlock attribution (CC BY-NC-SA 4.0).

NameTypeReqDescription
categoriesarray–Categories to look up. Default: the env default or the seven above
urlstringyesYouTube video URL or id

No output schema declared.

No examples provided.

get_transcript ~664

The full transcript of one video or local media file, with a header (title, channel, URL, duration, how the transcript was made, chapters). With timestamps (the default) every line starts with [m:ss] so you can cite moments. Uses creator captions, then platform auto-captions, then speech-to-text. Cost: speech is about 12k tokens per hour of video. For videos longer than about 20 minutes, call get_outline first and read only the sections you need with get_section, or set maxTokens to receive the transcript in pages (each page ends with a cursor for the next one). Formats: text (Plain transcript text. With timestamps, one "[m:ss] line" per caption.); json (The full VideoContext as JSON: metadata, chapters, timed segments, and how it was produced.); markdown (Markdown transcript: title and metadata, chapters as headings, paragraphs prefixed with timestamp links. Options: linkTimestamps, includeComments, includeVisual.); srt (SubRip (.srt) captions: at most 2 lines of 42 characters per cue, no overlaps, for players and editors.); vtt (WebVTT (.vtt) captions for the HTML <track> element, with speaker voice tags when known.); pack (Context pack: one Markdown file for one or many videos, written for an AI model to read, with citation instructions. Options: maxTokens, includeComments, includeVisual, linkTimestamps.); ass (Advanced SubStation Alpha (.ass) subtitles with a readable default style, for mpv, VLC, ffmpeg burn-in and Aegisub. Bilingual subtitles show the second language in a smaller style.); ttml (TTML / IMSC (.ttml) timed text XML for broadcast, streaming packagers and players that read TTML or DFXP.); sbv (YouTube SubViewer (.sbv) captions, the format YouTube Studio imports and exports.); lrc (LRC (.lrc) timed lyrics, one [mm:ss.xx] line per cue, for music players and karaoke apps.); csv (CSV (.csv) with one row per segment: start,end,speaker,text in seconds, plus secondary_text for bilingual output. For spreadsheets and data tools.)

NameTypeReqDescription
cursorstring–Continuation cursor from a previous partial result (like "seg:412"). Use the same other arguments
formatstring–Output format (see list_formats). Default: text
languagestring–Preferred transcript language (BCP-47, e.g. en, de). Default: the spoken language
maxTokensinteger–Largest result to return, in estimated tokens. Longer transcripts come back in pages with a continuation cursor
modestring–Transcript strategy: auto (captions, then speech-to-text), captions only, stt (always transcribe), video (multimodal model). Default: auto
timestampsboolean–Prefix lines with [m:ss] timestamps. Default: true
urlstringyesVideo URL (YouTube and more), a YouTube video id, or a local media file path

No output schema declared.

No examples provided.

grab_frames ~228

Save still images (png default, or jpg) of a video at given times to a folder on this machine. One time gives one image, several a .zip. Web videos are downloaded first (only the needed part when the times are close together). Files go to dir, else VID2CONTEXT_DOWNLOAD_DIR, else ~/Downloads/vid2context. Download only media you have the rights to: your own uploads, public-domain or Creative Commons works, or videos the site lets you download.

NameTypeReqDescription
dirstring–Folder to save to: absolute, ~/..., or relative to the default folder
formatstring–png (default) or jpg
qualitystring–Download size for web videos (smaller side), default 1080
timesarrayyesTimes: seconds, m:ss or h:mm:ss
urlstringyesVideo URL, YouTube id or local file path
widthinteger–Width in pixels; default the source size
zipboolean–Return a .zip even for one frame

No output schema declared.

No examples provided.

list_caption_languages ~63

List the caption tracks a video has (language, name, creator or auto-generated) and, for YouTube, the languages YouTube can machine-translate them into. Call it before get_transcript to pick a language.

NameTypeReqDescription
urlstringyesVideo URL

No output schema declared.

No examples provided.

list_collections ~38

List research collections with how many videos and sources each has. A collection groups videos on one topic and can follow playlists, channels and podcast feeds.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_formats ~65

The output formats get_transcript and get_section accept (text, json, markdown, srt, vtt, pack, ...), with what each is for. combinesVideos marks formats that can merge several videos into one document (export_context_pack). Cheap: under 500 tokens.

Input schema present but exposes no named parameters.

NameTypeReqDescription
formatsarrayyes–

No examples provided.

list_items ~163

Expand a playlist, channel, podcast feed or page into its videos (a single video URL returns itself). A video URL that also names a playlist (watch?v=...&list=...) returns the video plus `list`, the playlist; pass playlist: true to expand the playlist instead. Use it to see what a list contains before reading, or pass the list straight to add_to_collection. Cost: about 40 tokens per item; limit defaults to 50.

NameTypeReqDescription
limitinteger–Most items to return. Default: 50
playlistboolean–When url is a video link that also names a playlist (list=), list the playlist instead of the one video
urlstringyesPlaylist, channel, feed or page URL
NameTypeReqDescription
countnumberyes–
inputstringyes–
itemsarrayyes–
listobject––

No examples provided.

list_models ~123

The models (rungs) this server can use for speech-to-text, LLM, embedding, video and visual work, in free-first order: tier (local, free, keyless, paid), quality 1 to 5, capabilities (json, tools, vision, stream, ...), context window, whether it is enabled, and the names of the env vars that would enable it. Never shows key values. Cost: about 80 tokens per model; filter with kind.

NameTypeReqDescription
kindstring–Only this kind of model. Default: all kinds
NameTypeReqDescription
defaultPolicystringyes–
modelsarrayyes–

No examples provided.

open_transcript_viewer ~128

Show a video transcript in an interactive viewer (chapters, search, clickable [m:ss] timestamps, one-click citations, send selected lines to the chat) in clients that support MCP Apps, such as ChatGPT and Claude. The text result starts with a header (title, channel, URL, chapters); clients without MCP Apps get the full timestamped transcript as text.

NameTypeReqDescription
languagestring–Preferred transcript language (BCP-47, e.g. en, de)
urlstringyesVideo URL (YouTube and more) or a local file path
NameTypeReqDescription
chaptersarrayyes–
metadataobjectyes–
segmentsarrayyesTranscript lines as [startSec, endSec, text]
timestampBasestring|nullyesLink that opens the video at a moment: replace {t} with whole seconds. Null when there is no deep link.

No examples provided.

research_videos ~214

Search 1 to 10 videos (or a playlist, capped at 10) for a question and get only the relevant excerpts: ranked by BM25, each with the surrounding context, [m:ss] and a timestamp link, under a token cap. Use it instead of reading whole transcripts (about 12k tokens per hour of speech). Put exact phrases in double quotes to boost them. Lexical: if nothing matches, it lists words the videos do use so you can retry with a synonym.

NameTypeReqDescription
contextSecnumber–Seconds of context before and after each match. Default 20
formatstring–text (compact Markdown, default) or json
maxExcerptsinteger–Excerpts per video. Default 3
maxTokensinteger–Cap on the whole result. Default 2000
querystringyesWords to look for; "quoted phrases" are boosted
urlsarrayyesVideo URLs, or one playlist URL

No output schema declared.

No examples provided.

search_transcript ~200

Find where something is said across saved video transcripts, instead of reading whole transcripts (about 12k tokens per hour). Hybrid search: keyword matching for exact names and model numbers, plus meaning-based matching for paraphrases (when an embedding model is available). Returns the best time ranges with title, [m:ss], highlighted text and a timestamp link. Syntax: "exact phrase" must appear, -word excludes. Scope with collection (a collection id) or urls (videos are fetched and saved first if needed).

NameTypeReqDescription
collectionstring–Only search this collection (its id)
limitinteger–Hits to return. Default 10
querystringyesWhat to look for. "quoted phrases" are required, -word excludes a word
rerankboolean–Rerank the top results with a free LLM. Slower; default false
urlsarray–Only search these videos

No output schema declared.

No examples provided.

translate_transcript ~312

A video's transcript in another language, with every segment and timestamp kept. Free first: the transcript as is when it is already in that language, then the platform's own track or machine translation (YouTube translated captions), then LLM translation on the free-first rung chain. The source transcript is saved unchanged; the translation is an added layer. Text output starts with a header naming the video and how it was translated; other formats come with a second content block reporting the path used and the attempts. Costs about as many tokens as the transcript itself (about 12k per hour of speech).

NameTypeReqDescription
formatstring–Output format: text, json, markdown, srt, vtt, pack, ass, ttml, sbv, lrc, csv. Default text. json returns the full result, source transcript included
languagestringyesTarget language, BCP-47 (en, de, pt-BR)
llmboolean–Allow LLM translation when the platform has no track in the language. Default true; false uses only the platform's tracks
modestring–How to get the source transcript: auto (captions, then speech-to-text), captions, stt or video. Default auto
timestampsboolean–Prefix lines with [m:ss] where the format allows. Default false
urlstringyesVideo URL (YouTube and more), a YouTube video id, or a local media file path

No output schema declared.

No examples provided.

watch_live ~129

Transcribe a live stream (a live YouTube video or an HLS .m3u8 URL) while it runs. New lines arrive about every 30 seconds as progress notifications; the result is the full transcript with [stream time | UTC] stamps when the stream ends or maxMinutes pass. Default 10 minutes, at most 60. For recordings use get_transcript.

NameTypeReqDescription
maxMinutesnumber–Minutes to follow the stream. Default 10, capped at 60
urlstringyesLive YouTube URL or HLS (.m3u8) URL

No output schema declared.

No examples provided.

Install

How do I install the vid2context MCP server?

vid2context runs locally as an npm package, launched with npx -y vid2context-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · vid2context-mcp

# add to Claude Code
claude mcp add nirholas-vid2context -- npx -y vid2context-mcp
Common questions

What is the vid2context MCP server?

vid2context is an MCP server listed in the public MCP registry as io.github.nirholas/vid2context. Turn any video into context for AI agents: transcripts, metadata, chapters, timestamps. This page covers its npm package (vid2context-mcp).

Is the vid2context MCP server safe to use?

vid2context scores 75 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the vid2context MCP server expose?

vid2context exposes 37 tools: get_transcript, get_metadata, list_formats, get_outline, get_section, and 32 more. Their descriptions and schemas cost roughly 7,037 tokens of context every time the server is loaded.

Is the vid2context MCP server still maintained?

vid2context is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the vid2context MCP server under?

vid2context declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the vid2context MCP server?

VerifyMCP ran 17 checks on vid2context, covering Malware scan, Known CVEs, Install scripts, Dependency health and 13 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.