Supadata MCP Server — YouTube Transcripts & Web Scraping for AI Agents

Overview

The Supadata MCP (Model Context Protocol) server enables powerful web and video scraping capabilities directly within AI development environments like Cursor, Claude Desktop, and VS Code. This open-source integration allows AI models to extract transcripts, scrape web pages, and crawl entire websites to gather context.

Features

Multi-Platform Support: Works with YouTube, TikTok, Instagram, Twitter, Facebook, and more
AI-First Design: Optimized for use with LLMs and AI assistants
Multiple Tools: Transcript extraction, web scraping, site mapping, and crawling
Easy Integration: Simple setup with popular AI tools

Available tools

Tool	Description
`supadata_transcript`	Get a transcript from a video URL (YouTube, TikTok, Instagram, X, Facebook) or file URL
`supadata_check_transcript_status`	Poll an asynchronous transcript job by its job ID
`supadata_metadata`	Get metadata (title, author, engagement stats) for a social media post or video
`supadata_extract`	Start an AI structured-data extraction job for a video
`supadata_check_extract_status`	Poll an extraction job by its job ID and get the extracted data
`supadata_scrape`	Scrape a web page and return its content as Markdown
`supadata_map`	Map a website and return the list of URLs found
`supadata_crawl`	Start a crawl job for a website
`supadata_check_crawl_status`	Poll a crawl job by its job ID and get the crawled pages

The hosted server exposes all nine tools. The npm package currently published (@supadata/mcp 1.0.1) has the six transcript, scrape, map and crawl tools; supadata_metadata, supadata_extract and supadata_check_extract_status arrive in the next npm release.

Hosted server vs. local server

There are two ways to connect:

Hosted server at https://api.supadata.ai/mcp — uses OAuth. You sign in with your Supadata account when the client prompts you; no API key is needed. Use this with Claude, Claude Code and ChatGPT.
Local server via npx -y @supadata/mcp — runs on your machine and authenticates with your API key passed as the SUPADATA_API_KEY environment variable. Use this with Cursor, Windsurf, VS Code and other stdio-based clients.

Installation

Manual Installation

env SUPADATA_API_KEY=your-api-key npx -y @supadata/mcp

Integration Setup

Claude / Claude Desktop / Cowork

Connect directly from Claude without manually configuring an API key.

Go to Settings → Connectors
Click Add custom connector and enter Supadata as the name and https://api.supadata.ai/mcp as the URL. Click Add.

Click Authorize when prompted to grant MCP access.

Claude Code

Add the Supadata MCP server:

claude mcp add --transport http supadata https://api.supadata.ai/mcp

Run /mcp in Claude Code and select Authenticate for Supadata to complete the OAuth flow in your browser.

ChatGPT

Go to Settings → Apps & Connectors
Click Create to add a new connector
Enter Supadata as the name and https://api.supadata.ai/mcp as the connector URL
Click Save

To use it in a conversation, click the + icon in the composer, select More → Developer mode, and choose the Supadata connector.

Cursor

Open Cursor Settings
Navigate to MCPs & Integrations → New MCP Server
Add new MCP server:

{
  "supadata": {
    "command": "npx",
    "args": ["-y", "@supadata/mcp"],
    "env": {
      "SUPADATA_API_KEY": "your-api-key"
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "supadata": {
      "command": "npx",
      "args": ["-y", "@supadata/mcp"],
      "env": {
        "SUPADATA_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code

Add a .vscode/mcp.json file to your workspace. VS Code will prompt for your API key the first time the server starts:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "Supadata API Key",
      "password": true
    }
  ],
  "servers": {
    "supadata": {
      "command": "npx",
      "args": ["-y", "@supadata/mcp"],
      "env": {
        "SUPADATA_API_KEY": "${input:apiKey}"
      }
    }
  }
}

Configuration

Environment Variables

SUPADATA_API_KEY: Your Supadata API key (required for the local npx server; not needed for the hosted OAuth server)

General

SDKs

Integrations

Supadata MCP Server — YouTube Transcripts & Web Scraping for AI Agents

Overview

Features

Available tools

Hosted server vs. local server

Installation

Manual Installation

Integration Setup

Claude / Claude Desktop / Cowork

Claude Code

ChatGPT

Cursor

Windsurf

VS Code

Configuration

Environment Variables

Support

​Overview

​Features

​Available tools

​Hosted server vs. local server

​Installation

​Manual Installation

​Integration Setup

​Claude / Claude Desktop / Cowork

​Claude Code

​ChatGPT

​Cursor

​Windsurf

​VS Code

​Configuration

​Environment Variables

​Support

Overview

Features

Available tools

Hosted server vs. local server

Installation

Manual Installation

Integration Setup

Claude / Claude Desktop / Cowork

Claude Code

ChatGPT

Cursor

Windsurf

VS Code

Configuration

Environment Variables

Support