Transcriptor MCP Server

API for downloading subtitles from YouTube videos

Remote serverstreamable-httpTypeScript

What is the Transcriptor MCP Server?

API for downloading subtitles from YouTube videos

What it actually does

An MCP server (stdio; remote HTTP/SSE via mcp-proxy) that fetches video transcripts/subtitles via yt-dlp, with pagination for large responses. Supports YouTube, Twitter/X, Instagram, TikTok, Twitch, Vimeo, Facebook, Bilibili, VK, Dailymotion, Reddit. Whisper fallback — transcribes audio when subtitles are unavailable (local or OpenAI API). Works with Cursor and other MCP hosts.

This repository primarily ships a stdio MCP server (node dist/mcp.js):

  • Multi-platform — — YouTube, Reddit, Twitter/X, Instagram, TikTok, Twitch, Vimeo, Facebook, Bilibili, VK, Dailymotion
  • Transcripts + raw subtitles — cleaned text or raw SRT/VTT
  • Language support — official subtitles with auto-generated fallback
  • Video metadata — extended info (title, channel, tags, thumbnails, etc.) and chapter markers
  • Pagination — safe for large transcripts
  • Whisper fallback — when subtitles are unavailable, transcribes video audio via Whisper (local self-hosted or OpenAI API); configurable via environment variables

Configuration

  • Docker (recommended for production) - Node.js >= 20.0.0 (for local development) - yt-dlp (included in Docker image)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_transcriptCleaned plain text (first chunk)
get_raw_subtitlesRaw SRT/VTT, paginated
get_available_subtitlesList official/auto languages
get_video_infoExtended metadata
get_video_chaptersChapter markers
get_video_frameSingle frame image at timestamp
get_playlist_transcriptsBatch transcripts from playlist
search_videosYouTube search

How to install the Transcriptor MCP Server

claude mcp add transcriptor --env WHISPER_BASE_URL=your-value --env WHISPER_API_KEY=your-value --env CACHE_REDIS_URL=your-value --env COOKIES_FILE_PATH=your-value --env SMOKE_API_URL=your-value --env SMOKE_VIDEO_URL=your-value --env SMOKE_MCP_URL=your-value --env SMOKE_MCP_AUTH_TOKEN=your-value -- docker run -i --rm artsamsonov/transcriptor-mcp

Configuration

  • Docker (recommended for production) - Node.js >= 20.0.0 (for local development) - yt-dlp (included in Docker image)
VariableDescriptionRequired
WHISPER_BASE_URLEndpoint or connection string the server talks to.Yes
WHISPER_API_KEYCredential the server authenticates with.Yes
CACHE_REDIS_URLEndpoint or connection string the server talks to.Yes
COOKIES_FILE_PATHFilesystem location the server is allowed to use.Optional
SMOKE_API_URLEndpoint or connection string the server talks to.Yes
SMOKE_VIDEO_URLEndpoint or connection string the server talks to.Yes
SMOKE_MCP_URLEndpoint or connection string the server talks to.Yes
SMOKE_MCP_AUTH_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Transcriptor MCP to get transcript.”
  • “Use Transcriptor MCP to get raw subtitles.”
  • “Use Transcriptor MCP to get available subtitles.”

Frequently asked questions

API for downloading subtitles from YouTube videos Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.