video-url-analyzer-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ANALYSES_DIR | No | Directory to store analysis results | ./analyses |
| GEMINI_API_KEY | Yes | Google Gemini API key (required) | |
| VIDEO_ANALYZER_COOKIES | No | Enable browser cookies for yt-dlp | false |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| analyze_video | Analyze a video or photo/slideshow post from YouTube, TikTok, or Instagram. Provides comprehensive audio + visual analysis using Gemini AI. Works with videos AND photo/slideshow posts on TikTok, Instagram, and YouTube community posts. YouTube videos are analyzed directly and return the result immediately. TikTok and Instagram videos are processed in the background — the tool returns a job_id. Use check_analysis_job(job_id) to poll for the result. |
| get_transcript | Extract speech transcript from a video or slideshow audio track. YouTube returns the result immediately. TikTok/Instagram return a job_id — use check_analysis_job(job_id) to poll for the result. Slideshows without audio return a structured slideshow_no_audio response. |
| ask_about_video | Ask a specific question about a video or photo/slideshow post. Works with videos AND photo/slideshow posts on TikTok, Instagram, and YouTube community posts. YouTube returns the answer immediately. TikTok/Instagram return a job_id — use check_analysis_job(job_id) to poll for the result. |
| prepare_slideshow_assets | Return slideshow images as ordered MCP image blocks for client-side vision. This tool does not call Gemini. It downloads TikTok Photo Mode, Instagram photo/carousel posts, or YouTube community post images, then returns each image directly to the MCP client with an explicit image_index label. Use it when you want Claude/the client AI to inspect the images itself instead of receiving a Gemini-generated analysis. |
| find_video_moments | Find moments in a video matching a semantic query. Gemini performs the video/audio/visual reasoning. detail controls model + max_output_tokens + thinking/media config. compact is default and returns concise structured JSON. |
| analyze_video_segment | Analyze only a selected video segment. Uses Gemini video_metadata clipping when available. Gemini performs video/audio/visual reasoning. detail controls model + max_output_tokens + thinking/media config. |
| prepare_video_context | Analyze a whole video once and save a local structured context. |
| ask_video_context | Answer a question from saved video context without Gemini by default. |
| list_video_contexts | List saved local video context files. |
| delete_video_context | Delete one saved local video context file. |
| get_video_frame | Extract a local still frame and return compact asset metadata. |
| get_video_clip | Extract a local video clip under 30 seconds and return metadata. |
| get_video_evidence_asset | Find saved visual evidence and return a local frame/clip reference. |
| list_video_sources | List cached video sources, contexts, and assets. Never calls Gemini. |
| cleanup_video_cache | Inspect or clean managed video cache files. Safe dry-run by default. |
| watch_and_analyze | Watch a video tutorial and extract all technical steps, commands, and code. Downloads the video, analyzes it with Gemini AI, and returns structured JSON with every command, code snippet, file path, and tool mentioned. YouTube returns the result immediately. TikTok/Instagram return a job_id — use check_analysis_job(job_id) to poll for the result. This tool ONLY analyzes — it does NOT execute anything. Use execute_tutorial_steps to run the extracted steps after review. |
| check_analysis_job | Check the status of a background video analysis job. When analyze_video, get_transcript, ask_about_video, or watch_and_analyze returns a job_id (for TikTok/Instagram videos), use this tool to poll for the result. Keep calling until status is "completed" or "failed". |
| execute_tutorial_steps | Review or execute tutorial steps extracted by watch_and_analyze. SAFETY: By default (confirm=false), this only shows a summary of what WOULD be executed. Set confirm=true ONLY after reviewing the steps. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/u2n4/video-url-analyzer-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server