framefetch — MCP server for Claude Code: metadata, transcripts
framefetch — an MCP server that gives agents structured data from videos: metadata, captions or Whisper transcripts, parametric frames, and engagement metrics.
no license 4,719 installs updated 2026-06-19
claude mcp add --transport http framefetch https://framefetch--reyd8777.run.toolsWhat framefetch does
framefetch connects to Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Cline, Zed, and Windsurf via HTTP. One call retrieves the video's title and author, view and like counts, full captions (or a Whisper transcript if captions don't exist), and frames at a specified fps or from exact timestamps, pushed to S3.
Before making requests, query the platform capability matrix to see what each service provides. Payments go through x402 (USDC on Base) or Stripe. Errors are typed, results are cached, and failed calls refund credits.
What it helps with
- extract metadata, captions, and frames from a video in one API call
- transcribe video audio with Whisper when subtitles are unavailable
- check which data types each platform supports before querying
- retrieve frames at custom intervals or precise timestamps and store them in S3
- fetch video data from YouTube, TikTok, Instagram, Reddit, and Pinterest
Example prompts for the agent
- Get metadata and transcript from this YouTube video.
- What can framefetch extract from a TikTok video?
- Export frames from this Instagram Reel every second to S3.
How to install framefetch
Platform CLI: remote server
claude mcp add --transport http framefetch https://framefetch--reyd8777.run.toolsPlatform CLI: remote server
codex mcp add framefetch --url https://framefetch--reyd8777.run.toolsConfig file
{
"mcpServers": {
"framefetch": {
"url": "https://framefetch--reyd8777.run.tools"
}
}
}Config file
{
"servers": {
"framefetch": {
"type": "http",
"url": "https://framefetch--reyd8777.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http framefetch https://framefetch--reyd8777.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about framefetch
How do I install framefetch in Claude Code?
Run claude mcp add --transport http framefetch https://framefetch--reyd8777.run.tools in your terminal. Your agent will then have access to framefetch tools.
What does framefetch do?
It takes a link to a video on YouTube, TikTok, Instagram, Pinterest, or Reddit and returns metadata (title, creator, duration), engagement stats (views, likes), captions or an audio transcript, and video frames — all in one request.
Which platforms does framefetch support?
framefetch works with YouTube, YouTube Shorts, TikTok, Instagram Reels, Pinterest, and Reddit. Check the platform capability matrix first to see what data types are available for each.