Vidlens Mcp
Turns YouTube into a queryable research database with 41 tools covering search, transcript analysis, visual search via frame extraction, and playlist indexing. Works immediately without API keys through a three-tier fallback system (YouTube API, yt-dlp, page scraping). The explore pipeline handles full research workflows in one prompt: searches videos, ranks by relevance, reads transcripts, extracts benchmark data, and generates comparison charts. Semantic search uses Gemini embeddings to query across entire playlists by meaning. Visual search pulls keyframes, runs OCR on slides, and lets you search by what appears on screen rather than just spoken content. Includes sentiment analysis, content gap detection, and hook pattern analysis. Zero-config setup wizard auto-detects Claude Desktop and Claude Code.
- GitHub stars
- 35
- tools
- 47
- auth
- Secret needed
- transport
- STDIO
- env vars
- 5
- last updated
- Jul 9, 2026
Tools
47 toolsPublic tool metadata for what this MCP can expose to an agent.
exploreYouTubeIntent-aware search with multi-query ranking, transcript summaries, structured benchmark data, and background indexing.
Intent-aware search with multi-query ranking, transcript summaries, structured benchmark data, and background indexing.
No parameter schema in public metadata yet.
findVideosSearch YouTube by query with metadata
Search YouTube by query with metadata
No parameter schema in public metadata yet.
inspectVideoDeep metadata — tags, engagement, language, category
Deep metadata — tags, engagement, language, category
No parameter schema in public metadata yet.
inspectChannelChannel stats, description, recent uploads
Channel stats, description, recent uploads
No parameter schema in public metadata yet.
listChannelCatalogBrowse a channel's full video library
Browse a channel's full video library
No parameter schema in public metadata yet.
readTranscriptFull transcript with timestamps and chapters
Full transcript with timestamps and chapters
No parameter schema in public metadata yet.
readCommentsTop comments with likes and engagement
Top comments with likes and engagement
No parameter schema in public metadata yet.
expandPlaylistList all videos in any playlist
List all videos in any playlist
No parameter schema in public metadata yet.
importPlaylistIndex an entire playlist's transcripts
Index an entire playlist's transcripts
No parameter schema in public metadata yet.
importVideosIndex specific videos by URL or ID
Index specific videos by URL or ID
No parameter schema in public metadata yet.
searchTranscriptsNatural-language search across indexed content
Natural-language search across indexed content
No parameter schema in public metadata yet.
listCollectionsBrowse your indexed collections
Browse your indexed collections
No parameter schema in public metadata yet.
setActiveCollectionScope searches to one collection
Scope searches to one collection
No parameter schema in public metadata yet.
clearActiveCollectionSearch across all collections
Search across all collections
No parameter schema in public metadata yet.
removeCollectionDelete a collection and its index
Delete a collection and its index
No parameter schema in public metadata yet.
measureAudienceSentimentComment sentiment with themes and risk signals
Comment sentiment with themes and risk signals
No parameter schema in public metadata yet.
analyzeVideoSetCompare performance across multiple videos
Compare performance across multiple videos
No parameter schema in public metadata yet.
analyzePlaylistPlaylist-level engagement analytics
Playlist-level engagement analytics
No parameter schema in public metadata yet.
buildVideoDossierComplete single-video deep analysis
Complete single-video deep analysis
No parameter schema in public metadata yet.
scoreHookPatternsAnalyze what makes video openings work
Analyze what makes video openings work
No parameter schema in public metadata yet.
researchTagsAndTitlesTag and title optimization insights
Tag and title optimization insights
No parameter schema in public metadata yet.
compareShortsVsLongShort-form vs long-form performance
Short-form vs long-form performance
No parameter schema in public metadata yet.
recommendUploadWindowsBest times to publish for engagement
Best times to publish for engagement
No parameter schema in public metadata yet.
discoverNicheTrendsMomentum, saturation, and content gaps in any topic
Momentum, saturation, and content gaps in any topic
No parameter schema in public metadata yet.
exploreNicheCompetitorsChannel landscape and top performers
Channel landscape and top performers
No parameter schema in public metadata yet.
inspectVideoSourceResolve YouTube, X, Instagram, TikTok, generic URLs, and local files into source metadata and capability flags
Resolve YouTube, X, Instagram, TikTok, generic URLs, and local files into source metadata and capability flags
No parameter schema in public metadata yet.
searchVideoSourcesSearch native YouTube and local assets, with ScrapeCreators support for TikTok/Instagram plus configurable Brave/SerpAPI/DuckDuckGo fallback
Search native YouTube and local assets, with ScrapeCreators support for TikTok/Instagram plus configurable Brave/SerpAPI/DuckDuckGo fallback
No parameter schema in public metadata yet.
searchSocialTrendsSearch social platforms through ScrapeCreators; returns a ranked list with engagement metrics and importable URLs where available
Search social platforms through ScrapeCreators; returns a ranked list with engagement metrics and importable URLs where available
No parameter schema in public metadata yet.
importVideoSourcesImport URLs or local files into the local media store, optionally building a visual index or transcript
Import URLs or local files into the local media store, optionally building a visual index or transcript
No parameter schema in public metadata yet.
transcribeVideoSourceTranscribe YouTube, social/generic URLs, and local files via native captions or configured STT
Transcribe YouTube, social/generic URLs, and local files via native captions or configured STT
No parameter schema in public metadata yet.
downloadAssetDownload or ingest video, audio, or thumbnails from any supported source
Download or ingest video, audio, or thumbnails from any supported source
No parameter schema in public metadata yet.
listMediaAssetsBrowse stored media files
Browse stored media files
No parameter schema in public metadata yet.
removeMediaAssetClean up downloaded assets
Clean up downloaded assets
No parameter schema in public metadata yet.
extractKeyframesExtract key frames from videos
Extract key frames from videos
No parameter schema in public metadata yet.
mediaStoreHealthStorage usage and diagnostics
Storage usage and diagnostics
No parameter schema in public metadata yet.
indexVisualContentExtract frames; run Apple Vision OCR and feature prints, Gemini frame descriptions, and Gemini semantic embeddings
Extract frames; run Apple Vision OCR and feature prints, Gemini frame descriptions, and Gemini semantic embeddings
No parameter schema in public metadata yet.
searchVisualContentSearch frames by meaning and text; returns timestamped evidence and can open the external browser gallery
Search frames by meaning and text; returns timestamped evidence and can open the external browser gallery
No parameter schema in public metadata yet.
findSimilarFramesImage-to-image frame similarity using Apple Vision feature prints
Image-to-image frame similarity using Apple Vision feature prints
No parameter schema in public metadata yet.
importCommentsIndex a video's comments for search
Index a video's comments for search
No parameter schema in public metadata yet.
searchCommentsNatural-language search over the comment corpus
Natural-language search over the comment corpus
No parameter schema in public metadata yet.
listCommentCollectionsBrowse comment collections
Browse comment collections
No parameter schema in public metadata yet.
setActiveCommentCollectionScope comment searches
Scope comment searches
No parameter schema in public metadata yet.
clearActiveCommentCollectionSearch all comment collections
Search all comment collections
No parameter schema in public metadata yet.
removeCommentCollectionDelete a comment collection
Delete a comment collection
No parameter schema in public metadata yet.
recallWorkspaceSession-start digest of everything already imported — call first to avoid re-importing
Session-start digest of everything already imported — call first to avoid re-importing
No parameter schema in public metadata yet.
checkSystemHealthFull system diagnostic report
Full system diagnostic report
No parameter schema in public metadata yet.
checkImportReadinessValidate before importing content
Validate before importing content
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
YOUTUBE_API_KEYsecretYouTube Data API v3 key (optional — works without it via fallback scraping)
GEMINI_API_KEYsecretGoogle Gemini API key for AI-powered visual descriptions (optional)
OPENAI_API_KEYsecretOpenAI API key for optional speech-to-text transcription of imported non-YouTube sources
SCRAPECREATORS_API_KEYsecretScrapeCreators API key for optional social trend search across TikTok, Instagram, Threads, Pinterest, Reddit, and supported endpoints
BRAVE_API_KEYsecretBrave Search API key for optional social/generic video URL discovery
Readme
Your AI can read the web.
Now it can also watch it.
npx vidlens-mcp setup
- Research video: search, transcribe, compare, and cite YouTube and public social video.
- Build a local library: import once, then search transcripts, comments, frames, and OCR without fetching the same video again.
- Inspect visual evidence: find the exact frame, timestamp, match reason, and source in a visual gallery plus structured client output.
Details
- Repository
- github.com/thatsrajan/vidlens-mcp
- Category
- Media & Entertainment
- Package
vidlens-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Media & Entertainment MCP servers
View all
smartest-tvhybirdss/smartest-tvControl any smart TV with natural language. Resolve Netflix/YouTube/Spotify and deep-link.34stars
ATXP — Agent Payment & Wallet Infrastructureatxp-dev/atxpAgent wallet, email, phone, and 41 paid tools: search, image/video/music gen, SMS, calls.32stars
Ludo AI Game Assetsludo-ai/ludo-mcpGenerate game assets with AI: sprites, animations, 3D models with rigging, video, music, SFX, voices8stars
Scavioscavio-ai/scavio-mcpStructured web data from 73 platforms: Google, ChatGPT, Gemini, YouTube, Amazon, Reddit, TikTok8stars
Altmetric Mcpaltmetric/altmetric-mcpMCP server for Altmetric APIs - track research attention across news, policy, social media, and more7stars
Ssemble AI Clippingssembleinc/ssemble-mcp-serverCreate AI-powered short-form video clips from YouTube videos. Supports webhook callbacks.7stars