VidContext MCP Server
Give any MCP-compatible AI agent the ability to analyze video. Install with pip, add your API key, and your AI can extract transcripts, visual scenes, brands, and audio from any video file — as a native tool call.
Quick start
- 1
Install the package
Run pip install vidcontext-mcp in your terminal. Requires Python 3.9 or later.
- 2
Get your API key
Sign up at vidcontext.com/app and go to the Developer page. Copy your API key.
- 3
Configure your AI client
Add the VidContext MCP server to your client's configuration file. See the examples below for Claude Desktop and Cursor.
- 4
Start analyzing video
Ask your AI agent to analyze a video file. It will call the VidContext tool automatically, process the video, and return structured results.
Installation
pip install vidcontext-mcp # Run manually (useful for testing): vidcontext-mcp --api-key vc_your_key_here
Claude Desktop configuration
Add this to your Claude Desktop config file (claude_desktop_config.json):
{
"mcpServers": {
"vidcontext": {
"command": "vidcontext-mcp",
"args": ["--api-key", "vc_your_key_here"]
}
}
}Cursor configuration
The same JSON works for Cursor — save it as .cursor/mcp.json in your project root. See the full Cursor guide for detailed setup.
What your AI agent can do
Analyze any video file
Point your agent at a local video file or URL. It calls VidContext, processes the video in about 50 seconds, and gets back a complete text breakdown.
Choose analysis modes
All 8 modes are available as tool parameters: context, editor, analysis, ad, ecommerce, training, ugc, and competitor. Each returns domain-specific scoring and insights.
Chain with other tools
Combine video analysis with file reading, web search, code generation, or any other tools your agent has. Video understanding becomes one step in a larger workflow.
Frequently asked questions
What is MCP (Model Context Protocol)?
MCP is an open standard that lets AI applications connect to external tools and data sources. Think of it as a USB port for AI — any MCP-compatible client can use any MCP server. VidContext publishes an MCP server that exposes video analysis as a tool any compatible AI agent can call.
Which AI tools support MCP?
Claude Desktop, Cursor, Windsurf, Cline, and a growing list of AI development tools. Any MCP-compatible client can connect to the VidContext MCP server.
How do I get a VidContext API key?
Sign up at vidcontext.com/app and go to the Developer page. You get one free key immediately. Paid plans allow up to 5 keys.
Is the MCP server free to use?
The MCP server itself is free and open source on PyPI. You pay for VidContext API usage at $0.20 per minute of video processed. You get 20 free credits when you sign up — no credit card required.
What video formats does it support?
MP4, MOV, AVI, WebM, MKV, and all other common video formats. Maximum file size is 500 MB and maximum duration is 15 minutes for authenticated users.
Does the MCP server slow down my IDE?
No. It only activates when your AI agent calls the video analysis tool. It does not scan files, index your project, or use resources in the background.
Give your AI eyes
Install in one command. 20 free credits on signup. No credit card required.
Get API key