transcriptor-mcp
Extracts video transcripts, subtitles, metadata, chapters, frames, and YouTube search results from 11 platforms for AI assistants.
Get transcripts — clean plain-text transcripts from a video URL or YouTube ID, with optional track type (official/auto), language, and cursor-based pagination
Get raw subtitles — full SRT/VTT (plus ass/lrc) files, same platform and pagination options
List available subtitles — official and auto-generated language tracks so you can pick
typeandlangGet video info — extended yt-dlp metadata: title, channel, duration, views, likes, comments, tags, thumbnails, live status
Get chapters — chapter markers with start/end times and titles
Capture a frame — one image (JPEG/PNG) at a timecode or second offset, with width and quality controls
Get playlist transcripts — transcripts for multiple videos, with item ranges (
1:5,-1) and max-item limitsSearch videos — YouTube search via yt-dlp with limits, offsets, date filters, match filters, and json/markdown output
Interactive widgets — in-chat UIs for
get_transcript,get_video_info,get_video_frame, andsearch_videoson MCP Apps/ChatGPT clientsPlatforms — YouTube, Twitter/X, Instagram, TikTok, Twitch, Vimeo, Facebook, Bilibili, VK, Dailymotion, Reddit; the server returns text, metadata, and frames only—no video or audio downloads
Enables the extraction of video transcripts and metadata from the Bilibili platform.
Allows for retrieving video transcripts and metadata from Dailymotion videos.
Supports fetching transcripts and metadata for videos hosted on Facebook.
Provides capabilities to extract transcripts and metadata from Instagram video content.
Integrates with OpenAI's Whisper API to provide audio transcription fallback when native subtitles are unavailable.
Enables fetching of transcripts and metadata from TikTok videos.
Supports extracting transcripts and metadata from Twitch videos and streams.
Allows for retrieving video transcripts and metadata from Vimeo.
Provides tools to fetch video transcripts, raw subtitles, and detailed metadata including chapters, tags, and thumbnails.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
🎬 Now your AI assistant can watch videos!
Connect one server. Then ask Claude, ChatGPT or etc about a video: the transcript, the chapters, the metadata, or a single frame. It works with 11 platforms, not only YouTube.
Connect · What to ask · Widgets · Platforms · Self-host
⚡ Connect in 30 seconds
The hosted endpoint is:
https://transcriptor.gateway.mcpal.io/mcp🖱️ One click
⌨️ One command, for Claude Code
claude mcp add --transport http transcriptor https://transcriptor.gateway.mcpal.io/mcpThen run /mcp and approve the sign-in in the browser. After this, claude mcp list shows ✔ Connected.
🧭 No terminal
Client | What to do |
Claude (web and desktop) | Open Settings → Customize → Connectors. Select Add → Add custom connector, paste |
ChatGPT | Open Transcriptor in the ChatGPT plugin directory and select Install plugin; sign in when asked. Or in ChatGPT open Plugins, search Transcriptor, select Install plugin. Then mention |
Codex | Same directory, one install: ChatGPT and Codex share it. In a Codex task open Sources → Use plugins → Transcriptor; in the CLI, |
🧩 Any other MCP client
If your client is not in the list above, add the server with this configuration:
{
"mcpServers": {
"transcriptor": {
"url": "https://transcriptor.gateway.mcpal.io/mcp"
}
}
}If you want to run the server yourself, read Self-host. The tools are the same and you need no account.
Related MCP server: YouTube MCP
🧰 What you can ask
Ask for this | Tool |
"Summarize this video for me" |
|
"Give me the subtitles as an SRT file" |
|
"Is there a German track for this video?" |
|
"Who published this and how many views?" |
|
"Go to the part about pricing" |
|
"Show me the screen at 4:12" |
|
"Get English transcripts for the first 5 videos in this playlist" |
|
"Find recent videos about X" |
|
Long transcripts come in parts. Each response gives a cursor for the next part, so no text is lost.
Each tool that takes a video accepts url. This is a link from a supported platform or a plain YouTube ID. Each tool returns content (text for the chat) and structuredContent (typed JSON for your code).
get_transcript
Clean plain text, without timestamps, HTML, or speaker names. Without lang, the tool returns the track in the video's original language. Most platforms other than YouTube do not say which language a video is in; when the tool cannot tell which track that is, it answers with the list of tracks, and you call it again with type and lang. The inputs are the same as for get_raw_subtitles.
Response: videoId, url (the video page, as the server resolved it), type, lang, text, is_truncated, total_length, start_offset, end_offset. When more text is available, the response also has next_cursor.
get_raw_subtitles
Raw SRT or VTT content, in parts.
Input:
type—officialorauto. Withoutlang, the tool picks a track of this typelang— a language code or track name, asget_available_subtitleslists it. Without it, the video's original language, as forget_transcriptresponse_limit— default50000, minimum1000, maximum200000next_cursor— the cursor of the previous response
Response: the fields of get_transcript, plus format (srt or vtt) and content.
get_available_subtitles
Response: official and auto. Each field is a sorted list of language codes. Use this tool first, then give type and lang to the tools above.
get_video_info
Extended metadata from yt-dlp:
identity —
videoId,title,description,webpageUrlauthor —
uploader,uploaderId,channel,channelId,channelUrlnumbers —
duration,uploadDate,viewCount,likeCount,commentCountclassification —
tags,categories,liveStatus,isLive,wasLive,availabilityimages —
thumbnailandthumbnails
get_video_chapters
Response: chapters. Each item has startTime, endTime, and title. When the video has no chapters, the list is empty.
get_video_frame
Input:
timecode—"MM:SS"or"HH:MM:SS.mmm"seconds— an alternative totimecode. Give one of the two, not bothformat—jpeg(default) orpngwidth— default1280, maximum1920, never larger than the sourcequality—2to31, for jpeg only
Response: an image block, plus url, timestampSeconds, timestamp, mimeType, sizeBytes, and width. This tool needs ffmpeg. The Docker image includes it.
get_playlist_transcripts
Input:
url— a playlist URL, or a watch URL withlist=type,lang,format— the same asget_raw_subtitles, except thatlangis required: the original language is picked only for one video at a timeplaylistItems— a yt-dlp-Ivalue such as1:5,1,3,7, or-1maxItems— the maximum number of videos
Response: results. Each item has videoId and text.
search_videos
Input:
query— the search textlimit— default 10, maximum 50offset— the number of results to skipuploadDateFilter—hour,today,week,month, oryearresponse_format—json(default) ormarkdown
Response: results. Each item has videoId, title, url, duration, uploader, viewCount, and thumbnail.
📺 Widgets
Four tools have an interactive interface: get_transcript, get_video_info, get_video_frame, and search_videos. Clients that support MCP Apps and the ChatGPT Apps SDK show this interface in the chat. Other clients get the same data as text and JSON.
🌍 Platforms
YouTube · Twitter/X · Instagram · TikTok · Twitch · Vimeo · Facebook · Bilibili · VK · Dailymotion · Reddit
Each tool that takes a video accepts a link from these 11 platforms. The tool search_videos works with YouTube only, through yt-dlp ytsearch.
The server does not download video or audio files for you. It returns text, metadata, and single frames.
🐳 Self-host
The tools are the same as on the hosted endpoint. You need no account.
Run the server with Docker. The image serves Streamable HTTP on port 4200:
docker run --rm -p 4200:4200 artsamsonov/transcriptor-mcp:latestThen point your client at http://localhost:4200/mcp.
For stdio, give the image an explicit command:
docker run --rm -i artsamsonov/transcriptor-mcp:latest npm run start:mcp{
"mcpServers": {
"transcriptor": {
"command": "docker",
"args": ["run", "--rm", "-i", "artsamsonov/transcriptor-mcp:latest", "npm", "run", "start:mcp"]
}
}
}The server starts with no environment variables. Each variable below is optional.
Variable | Default | Function |
|
| The HTTP listener |
| — | A Netscape cookies file for videos that need an account. See cookies.example.txt |
|
| Set |
|
| Set |
|
| How many yt-dlp/ffmpeg processes may run at once. |
|
| After a platform answers 429 to a subtitle download, the server stops asking that platform for subtitles for this long and answers |
|
| How often the HTTP server fetches one transcript to prove the path still works. |
| — | Timeouts, proxy, and JS runtimes. See .env.example |
The same port serves GET /health and GET /metrics. The metrics are in Prometheus format and include the mcp_* counters.
Transport. The server accepts POST /mcp only. GET and DELETE return 405. The server is stateless and sends no Mcp-Session-Id.
The Node process does not check bearer tokens. Put a reverse proxy or a gateway in front of it for authentication and TLS. The hosted endpoint works this way.
REST API. A second image gives the same extraction over plain HTTP:
docker run --rm -p 3000:3000 artsamsonov/transcriptor-mcp-api:latestThe Swagger interface is at http://localhost:3000/docs. For a full stack with the API and the MCP server, read docker-compose.example.yml.
Development.
npm ci
npm run build
npm run --silent start:mcp # stdio (--silent keeps the npm banner off stdout)
npm run start:mcp:http # Streamable HTTP on port 4200
npm testYou need Node.js 22 or later (20 still works, but it reached end of life in April 2026), and yt-dlp in your PATH. Frame capture needs ffmpeg, and WHISPER_MAX_DURATION_SECONDS needs ffprobe (both ship in the same package, and in the Docker image). Other scripts: lint, type-check, format, test:coverage, test:e2e:api, and test:e2e:mcp.
Releases. The maintainer cuts them. The steps are in .claude/skills/release/SKILL.md. The version comes from package.json at runtime, through src/version.ts. Pushing a v* tag makes CI build both images and publish the MCP Registry entry from server.json.
Layout. src/mcp.ts (stdio entry), src/mcp-http.ts (Streamable HTTP), src/mcp-core.ts (tools, prompts, widgets), src/youtube.ts (yt-dlp), src/whisper.ts, src/cache.ts, src/index.ts (REST API), load/ (k6), and src/e2e/ (Docker smoke tests).
🤝 Contributing
Pull requests are welcome. Read CONTRIBUTING.md first: it describes the cycle from issue to review, for people and for coding agents.
⚖️ Legal
The hosted endpoint at transcriptor.gateway.mcpal.io is governed by the Terms of Service and the Privacy Policy.
A server you host yourself is not covered by those documents. It is governed by the MIT License only.
📄 License
MIT © 2026 samson-art. Read LICENSE.
💬 Support
Available Tools
8 toolsget_available_subtitlesGet available subtitle languagesARead-onlyIdempotentInspect
List available official and auto-generated subtitle languages.
Inputs: url (required), format. Returns: auto, videoId, official
get_playlist_transcriptsGet playlist transcriptsARead-onlyIdempotentInspect
Fetch cleaned subtitles (plain text) for multiple videos from a playlist. Use playlistItems (e.g. "1:5") to select specific items, maxItems to limit count.
Inputs: url (required), lang, type, format, +2 more. Returns: results
get_raw_subtitlesGet raw video subtitlesARead-onlyIdempotentInspect
Fetch raw SRT/VTT subtitles for a video (supported platforms). Optional: type, lang, response_limit (when omitted returns full content), next_cursor for pagination.
Inputs: url (required), lang, type, format, +2 more. Returns: lang, type, format, source, +7 more
get_transcriptGet video transcriptARead-onlyIdempotentInspect
Fetch cleaned subtitles as plain text for a video (YouTube, Twitter/X, Instagram, TikTok, Twitch, Vimeo, Facebook, Bilibili, VK, Dailymotion, Reddit). Uses auto-discovery for type/language when omitted. Optional: type, lang, response_limit (when omitted returns full transcript), next_cursor for pagination.
Inputs: url (required), lang, type, format, +2 more. Returns: lang, text, type, source, +6 more
get_video_chaptersGet video chaptersARead-onlyIdempotentInspect
Fetch chapter markers (start/end time, title) for a video.
Inputs: url (required), format. Returns: videoId, chapters
get_video_frameGet video frameARead-onlyIdempotentInspect
Capture a single frame from a video at the given timestamp. Provide timecode ("01:23", "00:01:23.500") or seconds; defaults to the first frame. Optional: format (png|jpeg), width (max 1920), quality (jpeg, 2-31). Returns the image plus metadata.
Inputs: url (required), width, format, quality, +2 more. Returns: width, videoId, mimeType, sizeBytes, +2 more
get_video_infoGet video infoARead-onlyIdempotentInspect
Fetch extended metadata for a video (title, channel, duration, tags, thumbnails, etc.).
Inputs: url (required), format. Returns: tags, title, isLive, channel, +18 more
search_videosSearch videosARead-onlyInspect
Search videos on YouTube via yt-dlp (ytsearch). Returns list of matching videos with metadata. Optional: limit, offset (pagination), uploadDateFilter (hour|today|week|month|year), dateBefore, date, matchFilter (e.g. "!is_live"), response_format (json|markdown).
Inputs: date, limit, query, offset, +4 more. Returns: results
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools are clearly distinct: transcript fetching, raw subtitle fetching, subtitle language listing, video metadata, chapters, frames, playlist transcripts, and search. The only potential confusion is between get_transcript and get_raw_subtitles, but their descriptions clearly separate cleaned plain text from raw SRT/VTT.
The naming follows a consistent get_<resource> pattern: get_transcript, get_raw_subtitles, get_available_subtitles, get_video_info, get_video_chapters, get_video_frame, get_playlist_transcripts, search_videos. The only deviation is search_videos, which uses a verb other than 'get', but it is still a clear and predictable pattern.
8 tools is well-scoped for a transcript/video metadata server. Each tool covers a distinct need: transcripts, raw subtitles, subtitle options, metadata, chapters, frames, playlist handling, and search. No tool feels redundant or unnecessary.
The server covers the core transcript retrieval lifecycle well: discover available subtitles, fetch raw or cleaned transcripts, paginate, and handle playlists. Minor gaps include no direct tool for downloading media or listing video comments, but these are outside the apparent transcript-focused purpose.
Maintenance
Related MCP Connectors
An MCP server that gives any LLM or agent clean YouTube transcripts on demand: a single video, a whole channel, or a playlist, plus AI cleanup of auto-generated captions. API-key auth, credit-based, same backend as the public v1 API. Get a free API key with 25 free credits at youtubetranscriptdownload.com/account.
Real-time YouTube transcripts, comments, channels & video search MCP. Local npx or hosted OAuth.
MCP server for RiverScript, an AI transcription platform - fetches transcripts shared via a link.
Real-time YouTube video transcripts, auto-translation, metadata, search & comments MCP ($1.00/1K).
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables retrieval of transcripts from YouTube videos. This server provides direct access to video transcripts and subtitles through a simple interface, making it ideal for content analysis and processing.1404 npm39MIT
- FlicenseAqualityDmaintenanceA Model Context Protocol server that enables Claude to interact with YouTube data and functionality through the Claude Desktop application.112-
- AlicenseAqualityBmaintenanceHigh-efficiency YouTube MCP server: Get token-optimized, structured data for your LLMs using the YouTube Data API v3.91,477 npm34MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching for songs on YouTube and automatically playing them in a web browser using the official YouTube Data API v3. It supports cross-platform execution on Windows, macOS, and Linux with built-in input validation.MIT