Claude MarketplacesSubmit
granitebps avatar

Video Understanding MCP

granitebps/video-understanding-mcp

Let AI agents watch videos and answer questions about them through any OpenAI-compatible endpoint.

tools
2
auth
Secret needed
transport
STDIO
env vars
8
last updated
Nov 9, 2026
View on GitHub

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

understand_videoWatch a video from a page URL, direct media URL, or local path and answer a question about it, returning a structured answer.

Watch a video from a page URL, direct media URL, or local path and answer a question about it, returning a structured answer.

No parameter schema in public metadata yet.

get_server_infoShows the version, endpoint host and model, request format, limits, local-file policy, and whether ffmpeg, ffprobe, and yt-dlp are available.

Shows the version, endpoint host and model, request format, limits, local-file policy, and whether ffmpeg, ffprobe, and yt-dlp are available.

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

VIDEO_BASE_URL*

Base URL of an OpenAI-compatible chat completions endpoint whose model accepts video, e.g. https://host/v1

VIDEO_MODEL*

Model (or router alias) to send videos to

VIDEO_API_KEYsecret

Endpoint API key, sent as a bearer token

VIDEO_PART_FORMATdefault: image_url

How the video is attached: video_url, image_url, file, or input_file

VIDEO_MAX_DURATION_SECONDSdefault: 300

Longest analyzed range in seconds

VIDEO_MAX_UPLOAD_MBdefault: 15

Largest prepared video sent to the endpoint, in MB

VIDEO_ALLOWED_DIRS

Directories local files may be read from; local files are refused when unset

VIDEO_VERIFY_MEDIAdefault: true

Fail calls when the endpoint evidently ignored the video

Readme

Video Understanding MCP

An MCP server that lets AI agents watch a video and answer questions about it: what is shown, what is said, what text appears on screen, and when. It works with any OpenAI-compatible chat completions endpoint whose model accepts video, such as Gemini models served through a gateway.

Give it a TikTok, YouTube, or X post URL, a direct media URL from a scraper, or a local file, plus a question. It downloads and shrinks the video, sends it to your endpoint, and returns a structured answer:

View the full README on GitHub

Details

Repository
github.com/granitebps/video-understanding-mcp
Categories
AI & LLM Tools, Media & Entertainment
Package
@granitebps/video-understanding-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1smartergpt avatarAXFsmartergpt/axfAgent eXoskeleton Framework control plane for workspace-native agent capabilities over MCP.0stars
2halfkey avatarObolhalfkey/obolSolana agent gateway via x402. Wallet, token, DeFi, and swap tools. Pay per request.0stars
3hypnolabs-io avatarAgentchurch Mcphypnolabs-io/agentchurch-mcpClosed. Agent Church shut down on 2026-11-07; every tool now returns 410 Gone.0stars
4ingrobertfodor avatarCHEAP_FLIGHTS_MCPingrobertfodor/cheap_flights_mcpMCP server for searching cheap flights in real-time. Searches RyanAir, WizzAir and Google Flights simultaneously. Includes Web UI, AI Agent (Claude via SAP Hype0stars
5inkwell-finance avatarDagon Inferenceinkwell-finance/dagon-mcpUncensored LLM inference: list models, chat, create keys, buy credits with Solana USDC.0stars
6bighub-io avatarBIGHUBbighub-io/bighubDecision learning for AI agent actions. Evaluate, score, decide, and learn from outcomes.0stars