# framefetch

framefetch — an MCP server that gives agents structured data from videos: metadata, captions or Whisper transcripts, parametric frames, and engagement metrics.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 4719 installs
- Author: reyd8777
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/reyd8777/framefetch
- Updated: 2026-06-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/framefetch

## What it 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.

## Requirements
- Remote server: `https://framefetch--reyd8777.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http framefetch https://framefetch--reyd8777.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add framefetch --url https://framefetch--reyd8777.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "framefetch": {
            "url": "https://framefetch--reyd8777.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "framefetch": {
            "type": "http",
            "url": "https://framefetch--reyd8777.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http framefetch https://framefetch--reyd8777.run.tools
```

## When to use it
- 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
- 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.

## Similar
- [Social → Context](https://affpapa.org/en/nevibecode/mcp/social-context.md) — MCP server · 292 installs
- [Video Extract](https://affpapa.org/en/nevibecode/mcp/video-extract.md) — MCP server · ★ 12 repo stars
- [Video URL Analyzer](https://affpapa.org/en/nevibecode/mcp/video-url-analyzer.md) — MCP server · ★ 5 repo stars
- [transcript-magic](https://affpapa.org/en/nevibecode/mcp/transcript-magic.md) — MCP server
- [Nooticr](https://affpapa.org/en/nevibecode/mcp/nooticr.md) — MCP server
- [vidlens-mcp](https://affpapa.org/en/nevibecode/mcp/vidlens-mcp.md) — MCP server · ★ 36 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
