# Supadata: Web & Video data API for makers

Turn YouTube, TikTok, Instagram, X videos and websites into structured data.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add supadata-ai/mcp

# Browse available tools
npx -y @smithery/cli@latest tool list supadata-ai/mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get supadata-ai/mcp supadata_transcript

# Call a tool
npx -y @smithery/cli@latest tool call supadata-ai/mcp supadata_transcript '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp--supadata-ai.run.tools`

**Required config:**
- `x-api-key` (header) — Supadata API key from dash.supadata.ai

## Tools (9)

- `supadata_transcript` — Extract transcript from a video or file URL. For large files, returns a jobId instead of the transcript directly - use …
- `supadata_check_transcript_status` — Check transcript job status and retrieve results. Returns status: "queued", "active", "completed", or "failed". If stat…
- `supadata_scrape` — Scrape a single web page
- `supadata_map` — Discover URLs on a website
- `supadata_crawl` — Create a crawl job to extract content from all pages on a website. Returns a jobId - use supadata_check_crawl_status wi…
- `supadata_check_crawl_status` — Check crawl job status and retrieve results. Returns status: "scraping", "completed", "failed", or "cancelled". If stat…
- `supadata_metadata` — Fetch metadata from a media URL (YouTube, TikTok, Instagram, Twitter). Returns platform info, title, description, autho…
- `supadata_extract` — Extract structured data from a video URL using AI. Provide a prompt for what to extract, a JSON Schema for the output f…
- `supadata_check_extract_status` — Check extract job status and retrieve results. Returns status: "queued", "active", "completed", or "failed". If status …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get supadata-ai/mcp <tool-name>
```

---

Source: https://github.com/supadata-ai/mcp | License: MIT