# YouTube Transcript — MCP server on mcp.ai
> Connect your YouTube Transcript account and use 9 tools for transcription straight from your AI agent. Connect with your own API key. Retrieve and store captions for one video or a bounded batch, read job and batch status, access stored transcripts and languages, and resolve playlist or channel video metadata through the YouTube Transcript REST API.

By: mcp.ai · official
Page: https://mcp.ai/youtube_transcript

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_youtube_transcript?ms=1787296080000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/youtube_transcript/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/youtube_transcript/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/youtube_transcript/skill.md
Postman collection (v2.1): https://mcp.ai/youtube_transcript/postman.json

## Tools
- youtube_transcript_get_stored_transcript(source?: string, language?: string, video_id: string, transcript_id?: string, include_timestamps?: boolean) — Read a transcript already stored in the connected account without submitting new transcription work or consuming retrieval credits.
- youtube_transcript_get_video_transcript(video: string, source?: string, language?: string, include_words?: boolean, include_paragraphs?: boolean, include_timestamps?: boolean) — Fetch captions for one YouTube video and store the resulting transcript in the connected account. This consumes provider credits, but never starts ASR. The tool waits up to 20 seconds for asynchronous
- youtube_transcript_get_video_transcript_job_status(job_id: string, include_words?: boolean, include_segments?: boolean, include_paragraphs?: boolean) — Read one transcript job's current processing, completed, failed, or requires-ASR-confirmation state without creating work or waiting. Use this one-shot read when GET_VIDEO_TRANSCRIPT times out, passin
- youtube_transcript_get_video_transcripts_batch(source?: string, language?: string, video_ids: string[], include_words?: boolean, include_paragraphs?: boolean, include_timestamps?: boolean) — Fetch and store captions for 1-10 YouTube videos. Each uncached video can consume provider credits, so cost scales with the request size. ASR never starts. This creates one batch and waits up to 20 se
- youtube_transcript_get_video_transcripts_batch_status(batch_id: string) — Read the current state and available per-video results for a transcript batch without creating work or waiting. Use this one-shot read to recover when GET_VIDEO_TRANSCRIPTS_BATCH times out while the p
- youtube_transcript_list_stored_transcripts(limit?: integer, search?: string, status?: string, date_to?: string, language?: string, date_from?: string, next_cursor?: string, include_segments?: boolean) — List and search transcripts already stored in the connected account, one bounded page at a time.
- youtube_transcript_list_transcript_languages(video_id: string, include_youtube_default?: boolean) — List stored languages and YouTube translation target languages for one owned video transcript.
- youtube_transcript_resolve_channel_videos(limit?: integer, handle?: string, channel_id?: string, channel_url?: string) — Requires Basic or higher. Resolve a YouTube channel into bounded upload metadata without transcribing the videos. This may count against the account's monthly channel allowance.
- youtube_transcript_resolve_playlist_videos(limit?: integer, playlist_id?: string, playlist_url?: string) — Requires Basic or higher. Resolve a YouTube playlist into bounded video metadata without transcribing the videos. This may count against the account's monthly playlist allowance.

## Example prompts
- "What can I do in YouTube Transcript?"
- "Show me a summary of my YouTube Transcript account"

## Links
Docs: https://mcp.ai/docs/mcps/youtube_transcript
Website: https://mcp.ai/mcps/youtube_transcript