Remote MCP · Live
Give Claude, ChatGPT, Cursor, VS Code, or Claude Code a tool that turns a YouTube, TikTok, Instagram, Facebook, X, Vimeo, or direct video link into still frames. Add the server URL, authorize once with your gvf_live_ API key, and ask for frames in plain language. Jobs use the same credits as the REST API, including 60 free credits every month.
Server URL (Streamable HTTP, OAuth)
https://mcp.getvideoframes.com/mcpRemote or local
Use the hosted server when the video is a public link. GetVideoFrames downloads the video on its servers, extracts the frames, and returns signed URLs or a ZIP. Nothing to install.
Use the open-source GVF MCP when the video is a file on your machine that should not leave it. It runs over stdio, calls FFmpeg locally, and adds scene, sharpness, and object-based frame selection.
Setup
Every client uses the same server URL. The first call opens an authorization page where you paste a gvf_live_ key from the developer dashboard.
Open Settings → Connectors → Add custom connector. Name it GetVideoFrames, paste the server URL, and select Connect. Custom connectors are available on Claude plans that support them.
Add the server from your terminal, then run /mcp inside Claude Code to authorize.
claude mcp add --transport http getvideoframes https://mcp.getvideoframes.com/mcpAdd the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Cursor opens the authorization page when you connect.
{
"mcpServers": {
"getvideoframes": {
"url": "https://mcp.getvideoframes.com/mcp"
}
}
}Add the server to .vscode/mcp.json, then start it from the MCP view.
{
"servers": {
"getvideoframes": {
"type": "http",
"url": "https://mcp.getvideoframes.com/mcp"
}
}
}In ChatGPT plans with developer mode, open Settings → Apps & Connectors → Advanced settings, turn on developer mode, then create a connector with the server URL and OAuth authentication.
Any client that supports Streamable HTTP and OAuth 2.1 with dynamic client registration can connect directly. For stdio-only clients, bridge with mcp-remote.
npx -y mcp-remote https://mcp.getvideoframes.com/mcpAuthorization
Sign in to the developer dashboard with your email and create a gvf_live_ key. New accounts get the free monthly credits automatically.
Paste the server URL into Claude, ChatGPT, Cursor, VS Code, or Claude Code using the setup above.
Your client opens the GetVideoFrames authorization page. Paste the key; the server verifies it and issues an OAuth token to your client.
Paste a video link and describe the frames you want. Revoke the key in the dashboard at any time to disconnect every client that uses it.
Tools
Seven tools mirror the REST API. Agents call create, then read the job until it completes; wait=true blocks up to 50 seconds.
Examples
Paste the link in the same message. The agent picks the mode and format from your wording.
Credits and limits
MCP jobs are API jobs. One credit covers one minute of processed video (up to 100 frames) or 10 timestamp frames, and failed jobs are not charged. The free plan includes 60 credits a month, videos up to 10 minutes, 300 frames per job, and 720p frames. A 500-credit pack costs $10 and never expires.
Open source
Clone and build the GVF repository, link the binaries, then register gvf-mcp as a stdio server. The local MCP never uploads video and does not use API credits.
Tools: gvf_run (recommended), gvf_probe, gvf_extract, gvf_analyze, gvf_detect, gvf_select, gvf_export, gvf_runtime_status.
GVF on GitHubgit clone https://github.com/GetVideoFrames/gvf.git
cd gvf
npm install
npm run build
npm link -w @gvf/cli -w @gvf/mcpMCP client config after npm link
{
"mcpServers": {
"gvf": {
"command": "gvf-mcp"
}
}
}FAQ