Video transcripts, metadata and structured data from YouTube, TikTok, Instagram, X; web scraping.
This MCP server provides access to video transcripts, along with metadata and structured data sourced from YouTube, TikTok, Instagram, and X. It also supports web scraping to obtain that information, exposing it through the server interface for downstream use.
🛠️ Key Features
Video transcripts from YouTube, TikTok, Instagram, and X
Metadata and structured data collection
Web scraping
🚀 Use Cases
Extracting and using transcript text from supported video platforms
Collecting platform metadata and structured information for analysis or indexing
Scraping publicly available web content to supplement video-derived data
Use Supadata in your AI agent: video transcripts, media metadata, web scraping, crawling, and site discovery. This repository is the Supadata MCP server (Model Context Protocol), which AI agents like Claude, ChatGPT and Cursor use to call Supadata.
Click a button, then sign in with your Supadata account. No API key to copy.
Claude: click Add to Claude, click Connect and sign in. Works in claude.ai, Claude Desktop and the mobile apps. On Team/Enterprise plans an Owner enables Supadata first in Admin settings → Connectors.
ChatGPT: click Add to ChatGPT, click Connect and sign in.
Cursor: click Add to Cursor, confirm Install, and Cursor opens the Supadata sign-in page.
Claude Code / Codex
bash
# Claude Code: then run /mcp and choose Authenticate
claude mcp add --transport http supadata https://api.supadata.ai/mcp
# Codex
codex mcp add supadata --url https://api.supadata.ai/mcp
codex mcp login supadata
Other MCP clients can connect to the hosted server at https://api.supadata.ai/mcp (OAuth, or an x-api-key header), or run the local server below.
Features
Video transcript extraction from YouTube, TikTok, Instagram, Twitter, and file URLs
Web scraping, crawling, and URL discovery
Media metadata retrieval from YouTube, TikTok, Instagram, and Twitter
AI-powered structured data extraction from video content
Installation
For step-by-step setup in Claude, ChatGPT, Cursor, Claude Code, Codex, Windsurf, VS Code and other AI agents, see the AI agents guide.
Running
Stdio (default)
Running the package starts an MCP server on stdio. Use this when your AI agent
should spawn the server locally with your API key instead of using the hosted
server (for example a custom agent, or VS Code / Windsurf config files):
The same tools are served over Streamable HTTP by the Cloudflare Worker in
src/worker.ts, deployed at https://api.supadata.ai/mcp with OAuth 2.1.
Run it locally with npm run dev (wrangler). Direct x-api-key header
authentication is also accepted on /mcp.
An OAuth connection stays alive while it is used and expires after 30 days
without use. Then clients have to log in again; Codex keeps retrying the
expired login instead of asking, so run codex mcp login supadata if Supadata
tools stop working in Codex.
Configuration
Environment Variables
SUPADATA_API_KEY: Your Supadata API key (required for the stdio server). Get one at dash.supadata.ai
DEBUG: set to true for verbose logging
RUN_STDIO: set to true to force the stdio server to start when the module is imported rather than executed directly
How to Choose a Tool
Select the right tool based on your needs:
Transcript: Extract video transcripts from platforms and file URLs
Scrape: Extract content from a single page when you know the exact URL
Map: Discover all available URLs on a website
Crawl: Extract content from multiple related pages comprehensively
Metadata: Fetch metadata from media URLs (YouTube, TikTok, Instagram, Twitter)
Extract: Extract structured data from video content using AI
Tool
Best for
Returns
transcript
Video transcript extraction
text/markdown
metadata
Media metadata retrieval
JSON object
extract
AI-powered structured extraction
JSON object
scrape
Single page content
markdown/html
map
URL discovery on a site
URL[]
crawl
Multi-page extraction
markdown/html[]
Available Tools
Transcript (supadata_transcript)
Extract transcripts from supported video platforms (YouTube, TikTok, Instagram, Twitter) and file URLs.
Fetch metadata from a media URL on supported platforms (YouTube, TikTok, Instagram, Twitter). Returns platform info, title, description, author details, engagement stats, media details, tags, and creation date.
Extract structured data from a video URL using AI. Provide a prompt for what to extract, a JSON Schema for the output format, or both. Returns a job ID for async processing.
Usage:
bash
supadata_extract --url "https://youtube.com/watch?v=example" --prompt "Extract the main topics discussed"
Check Extract Status (supadata_check_extract_status)
Check the progress of an extract job using the job ID.