How do I install Supadata?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Supadata need an API key?

No required environment variable is listed on this record.

When was Supadata last checked?

Last checked 2026-11-10. Video transcripts, metadata and structured data from YouTube, TikTok, Instagram, X; web scraping.

Supadata MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.supadata.ai/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

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

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.supadata-ai-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.supadata.ai/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.3.6
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Supadata MCP Server

A Model Context Protocol (MCP) server that integrates with Supadata for video transcript extraction, web scraping, crawling, and site discovery.

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 setup instructions for Claude, ChatGPT, Cursor, Windsurf, VS Code, and other clients, see the integration guide.

Running

Stdio (default)

Running the package starts an MCP server on stdio. This is what MCP clients (Claude Desktop, Cursor, VS Code, Windsurf, ...) use when they spawn the server:

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

Example client configuration:

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

Streamable HTTP (hosted)

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.

Usage:

supadata_transcript --url "https://youtube.com/watch?v=example" --lang "en"

Check Transcript Status (`supadata_check_transcript_status`)

Check the progress of a transcript extraction job using the job ID.

Usage:

supadata_check_transcript_status --id "550e8400-e29b-41d4-a716-446655440000"

Metadata (`supadata_metadata`)

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.

Usage:

supadata_metadata --url "https://youtube.com/watch?v=example"

Extract (`supadata_extract`)

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:

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.

Usage:

supadata_check_extract_status --id "550e8400-e29b-41d4-a716-446655440000"

Scrape (`supadata_scrape`)

Extract content from a single URL with advanced options.

Usage:

supadata_scrape --url "https://example.com" --lang "en"

Map (`supadata_map`)

Discover all indexed URLs on a website to find relevant pages before scraping.

Usage:

supadata_map --url "https://example.com"

Crawl (`supadata_crawl`)

Start an asynchronous crawl job to extract content from multiple pages on a site.

Usage:

supadata_crawl --url "https://example.com/blog" --limit 100

Check Crawl Status (`supadata_check_crawl_status`)

Check the progress of a crawl job using the job ID.

Usage:

supadata_check_crawl_status --id "550e8400-e29b-41d4-a716-446655440000"

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

Contributing

Fork the repository
Create your feature branch
Run tests: npm test
Submit a pull request

License

MIT License - see LICENSE file for details

Supadata

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Supadata?

Does Supadata need an API key?

What transport does Supadata use?

When was Supadata last checked?

Documentation

Supadata MCP Server

Features

Installation

Running

Stdio (default)

Streamable HTTP (hosted)

Configuration

Environment Variables

How to Choose a Tool

Available Tools

Transcript (`supadata_transcript`)

Check Transcript Status (`supadata_check_transcript_status`)

Metadata (`supadata_metadata`)

Extract (`supadata_extract`)

Check Extract Status (`supadata_check_extract_status`)

Scrape (`supadata_scrape`)

Map (`supadata_map`)

Crawl (`supadata_crawl`)

Check Crawl Status (`supadata_check_crawl_status`)

Development

Contributing

License

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Supadata?

Does Supadata need an API key?

What transport does Supadata use?

When was Supadata last checked?

Documentation

Supadata MCP Server

Features

Installation

Running

Stdio (default)

Streamable HTTP (hosted)

Configuration

Environment Variables

How to Choose a Tool

Available Tools

Transcript (supadata_transcript)

Check Transcript Status (supadata_check_transcript_status)

Metadata (supadata_metadata)

Extract (supadata_extract)

Check Extract Status (supadata_check_extract_status)

Scrape (supadata_scrape)

Map (supadata_map)

Crawl (supadata_crawl)

Check Crawl Status (supadata_check_crawl_status)

Development

Contributing

License

Transcript (`supadata_transcript`)

Check Transcript Status (`supadata_check_transcript_status`)

Metadata (`supadata_metadata`)

Extract (`supadata_extract`)

Check Extract Status (`supadata_check_extract_status`)

Scrape (`supadata_scrape`)

Map (`supadata_map`)

Crawl (`supadata_crawl`)

Check Crawl Status (`supadata_check_crawl_status`)