# framefetch MCP server

Any social-video URL → transcript, metadata, frames, OCR, summary, search, Q&A. MCP server + x402.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-marvinrey7879-framefetch
- Repository: https://github.com/MarvinRey7879/framefetch-client
- Website: https://framefetch.net

## Install
- Endpoint: https://framefetch.net/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://framefetch.net/mcp

## Tools
- framefetch_extract - Extract data from ONE public social-video URL (YouTube incl. Shorts, TikTok, Instagram Reels, Pinterest, Reddit): metadata/insights/transcript/frames/digest/comments/etc — see `fields`. When NOT to use: non-video pages, private/login-walled content, or bulk crawling (one URL per call). Returns one JSON object with only the requested fields + a `cost` block (micro-USD); shapes: https://framefetch.net/docs. Cost scales with what you request (frames/transcript cost more than metadata). No key? POST /v1/keys {email} -> instant key (~100 free calls); or x402 (USDC), no account. Example: {"url":"https://www.youtube.com/watch?v=...","fields":["metadata","transcript"]}. Endpoint: https://framefetch.net/mcp
- framefetch_platform_capabilities - JSON matrix of data types (metadata, insights, transcript, frames, comments) per platform — YouTube (+Shorts), TikTok, Instagram Reels, Pinterest, Reddit. Call before framefetch_extract to confirm support. No input. Endpoint: https://framefetch.net/mcp
- framefetch_search - Search YouTube by keyword (yt-dlp, no login). Returns up to `limit` hits: url/title/uploader/durationSec/uploadDate(often null)/thumbnail/views. YouTube only — use framefetch_extract on a hit's url for transcript/frames/etc. Billed ~$0.002/call (metadata-tier), regardless of `limit`. Endpoint: https://framefetch.net/mcp
- framefetch_account - Check this account's credit balance/usage. Read-only — never charges; works at zero balance (unlike framefetch_extract). Purpose: check balance before expensive framefetch_extract calls — at session start, periodically, or after a 402. When NOT to use: before every single framefetch_extract call in a tight loop. Returns: balance_micros, spend_7d_micros, calls_7d — micro-USD (1,000,000 = $1). Low balance: top up via x402 (USDC) at POST /v1/topup, or card at POST /v1/checkout. Endpoint: https://framefetch.net/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.MarvinRey7879
- Version: 1.9.1
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 28, 2026
- Source: https://registry.modelcontextprotocol.io
