# YouTube Transcript MCP

Extract YouTube transcripts and manage history via MCP

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add friv/youtube-transcript-dev

# Browse available tools
npx -y @smithery/cli@latest tool list friv/youtube-transcript-dev

# Get full schema for a tool
npx -y @smithery/cli@latest tool get friv/youtube-transcript-dev transcribe_v2

# Call a tool
npx -y @smithery/cli@latest tool call friv/youtube-transcript-dev transcribe_v2 '{}'
```

## Direct MCP Connection

Endpoint: `https://youtube-transcript-dev.run.tools`

**Optional config:**
- `x-api-token` (header) — API key for YouTubeTranscript.dev. Get yours at youtubetranscript.dev/dashboard/account

## Tools (5)

- `transcribe_v2` — POST /api/v2/transcribe. Fast caption-based transcript (no ASR). Use manual or auto captions only.
- `list_transcripts` — GET /api/v1/history. List or search user transcripts. Use search to find by video id, title, or transcript content.
- `get_transcript` — GET /api/v1/transcripts/{video_id}. Get full transcript for a video.
- `get_stats` — Get stats: credits left, transcripts created, plan, rate limit.
- `delete_transcript` — POST /api/v1/transcripts/bulk-delete. Delete transcripts by ids or by video_id.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get friv/youtube-transcript-dev <tool-name>
```