# samson-art/transcriptor-mcp [Health: Active] **Category:** ๐Ÿ“‚ Browser Automation **Repository:** https://github.com/samson-art/transcriptor-mcp **GitHub Stars:** 21 **Views:** 2 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/samson-art-transcriptor-mcp ## Description Transcriptor MCP is your choice when you need transcripts and metadata for AI, summarization, or content analysis ## Tools Capabilities this server exposes over MCP: - **get_transcript** โ€” Cleaned plain text (first chunk) - **get_raw_subtitles** โ€” Raw SRT/VTT, paginated - **get_available_subtitles** โ€” List official/auto languages - **get_video_info** โ€” Extended metadata - **get_video_chapters** โ€” Chapter markers - **get_video_frame** โ€” Single frame image at timestamp - **get_playlist_transcripts** โ€” Batch transcripts from playlist - **search_videos** โ€” YouTube search ## Claude Desktop Quick Installation Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client: ```json "mcpServers": { "transcriptor-mcp": { "url": "https://transcriptor.gateway.mcpal.io/mcp" } } ``` ## Documentation & README
Transcriptor MCP # ๐ŸŽฌ 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. [![Website](https://img.shields.io/badge/Website-transcriptor--mcp.org-C15F3C)](https://transcriptor-mcp.org) [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-transcriptor--mcp-6E56CF)](https://registry.modelcontextprotocol.io/v0/servers?search=transcriptor) [![Docker](https://img.shields.io/badge/Docker-artsamsonov/transcriptor--mcp-2496ED?logo=docker&logoColor=white)](https://hub.docker.com/r/artsamsonov/transcriptor-mcp) [![MCP Apps](https://img.shields.io/badge/MCP%20Apps-4%20interactive%20widgets-8A63D2)](#-widgets) [![License](https://img.shields.io/github/license/samson-art/transcriptor-mcp)](LICENSE) **[Connect](#-connect-in-30-seconds) ยท [What to ask](#-what-you-can-ask) ยท [Widgets](#-widgets) ยท [Platforms](#-platforms) ยท [Self-host](#-self-host)**
--- ## โšก Connect in 30 seconds The hosted endpoint is: ```text https://transcriptor.gateway.mcpal.io/mcp ``` ### ๐Ÿ–ฑ๏ธ One click [![Add to Cursor](https://img.shields.io/badge/Add%20to-Cursor-000000?style=for-the-badge&logo=cursor&logoColor=white)](https://cursor.com/install-mcp?name=transcriptor&config=eyJ1cmwiOiJodHRwczovL3RyYW5zY3JpcHRvci5nYXRld2F5Lm1jcGFsLmlvL21jcCJ9) [![Install in VS Code](https://img.shields.io/badge/Install%20in-VS%20Code-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=transcriptor&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Ftranscriptor.gateway.mcpal.io%2Fmcp%22%7D) [![Add to LM Studio](https://img.shields.io/badge/Add%20to-LM%20Studio-4B5563?style=for-the-badge)](https://lmstudio.ai/install-mcp?name=transcriptor&config=eyJ1cmwiOiJodHRwczovL3RyYW5zY3JpcHRvci5nYXRld2F5Lm1jcGFsLmlvL21jcCJ9) ### โŒจ๏ธ One command, for Claude Code ```bash claude mcp add --transport http transcriptor https://transcriptor.gateway.mcpal.io/mcp ``` Then 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](https://claude.ai/settings/connectors). Select **Add** โ†’ **Add custom connector**, paste `https://transcriptor.gateway.mcpal.io/mcp`, then select **Add**. | | **ChatGPT** | Open [Settings โ†’ **Security and login**](https://chatgpt.com/#settings) and turn on **Developer mode**. Then open Plugins, select **+**, and paste `https://transcriptor.gateway.mcpal.io/mcp`. | | **Codex** | Add the block below to `~/.codex/config.toml`, then run `codex mcp login transcriptor`. The CLI, the IDE extension and the ChatGPT desktop app share this file. | ```toml [mcp_servers.transcriptor] url = "https://transcriptor.gateway.mcpal.io/mcp" auth = "oauth" ``` > **Note:** ChatGPT developer mode is available on the web, for paid plans. Some releases show this control as Settings โ†’ Apps & Connectors โ†’ Advanced. > > **Note:** `codex mcp add` registers stdio servers only, so a hosted server goes into `config.toml`. See the [Codex MCP docs](https://learn.chatgpt.com/docs/extend/mcp?surface=cli). ### ๐Ÿงฉ Any other MCP client If your client is not in the list above, add the server with this configuration: ```json { "mcpServers": { "transcriptor": { "url": "https://transcriptor.gateway.mcpal.io/mcp" } } } ``` If you want to run the server yourself, read [Self-host](#-self-host). The tools are the same and you need no account. --- ## ๐Ÿงฐ What you can ask | Ask for this | Tool | | --- | --- | | *"Summarize this video for me"* | `get_transcript` | | *"Give me the subtitles as an SRT file"* | `get_raw_subtitles` | | *"Is there a German track for this video?"* | `get_available_subtitles` | | *"Who published this and how many views?"* | `get_video_info` | | *"Go to the part about pricing"* | `get_video_chapters` | | *"Show me the screen at 4:12"* | `get_video_frame` | | *"Get transcripts for the first 5 videos in this playlist"* | `get_playlist_transcripts` | | *"Find recent videos about X"* | `search_videos` (YouTube) | Long transcripts come in parts. Each response gives a cursor for the next part, so no text is lost.
Full tool reference (input and structured response) Each tool that takes a video accepts `url`. This is a link from a [supported platform](#-platforms) 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. The tool finds the type and the language for you. Response: `videoId`, `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` โ€” `official` or `auto` - `lang` โ€” a language code - `response_limit` โ€” default `50000`, minimum `1000`, maximum `200000` - `next_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`, `webpageUrl` - author โ€” `uploader`, `uploaderId`, `channel`, `channelId`, `channelUrl` - numbers โ€” `duration`, `uploadDate`, `viewCount`, `likeCount`, `commentCount` - classification โ€” `tags`, `categories`, `liveStatus`, `isLive`, `wasLive`, `availability` - images โ€” `thumbnail` and `thumbnails` #### `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 to `timecode`. Give one of the two, not both - `format` โ€” `jpeg` (default) or `png` - `width` โ€” default `1280`, maximum `1920`, never larger than the source - `quality` โ€” `2` to `31`, for jpeg only Response: an image block, plus `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 with `list=` - `type`, `lang`, `format` โ€” the same as `get_raw_subtitles` - `playlistItems` โ€” a yt-dlp `-I` value such as `1:5`, `1,3,7`, or `-1` - `maxItems` โ€” the maximum number of videos Response: `results`. Each item has `videoId` and `text`. #### `search_videos` Input: - `query` โ€” the search text - `limit` โ€” default 10, maximum 50 - `offset` โ€” the number of results to skip - `uploadDateFilter` โ€” `hour`, `today`, `week`, `month`, or `year` - `response_format` โ€” `json` (default) or `markdown` 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](https://github.com/modelcontextprotocol/ext-apps) and the ChatGPT Apps SDK show this interface in the chat. Other clients get the same data as text and JSON.
The search_videos widget: a carousel of result cards with thumbnails, durations, and view counts

search_videos ยท "model context protocol MCP server production"

 The get_video_frame widget: one captured frame with step controls and a timecode field

get_video_frame ยท an architecture slide at 3:30
The get_transcript widget: a video card above a searchable list of timed captions

get_transcript ยท a 3-minute MCP explainer, official captions

 The get_video_info widget: thumbnail, channel, views, likes, description, and a subtitle language picker

get_video_info ยท channel, views, likes, and 169 caption languages
--- ## ๐ŸŒ 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: ```bash docker run --rm -p 4200:4200 artsamsonov/transcriptor-mcp:latest ``` Then point your client at `http://localhost:4200/mcp`. For stdio, give the image an explicit command: ```bash docker run --rm -i artsamsonov/transcriptor-mcp:latest npm run start:mcp ``` ```json { "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 | | --- | --- | --- | | `MCP_PORT` and `MCP_HOST` | `4200` and `0.0.0.0` | The HTTP listener | | `COOKIES_FILE_PATH` | โ€” | A Netscape cookies file for videos that need an account. See [cookies.example.txt](https://github.com/samson-art/transcriptor-mcp/blob/HEAD/cookies.example.txt) | | `WHISPER_MODE` | `off` | Set `local` or `api` to transcribe the audio when a video has no subtitles. Then set `WHISPER_BASE_URL` or `WHISPER_API_KEY` | | `CACHE_MODE` | `off` | Set `redis` and `CACHE_REDIS_URL` to cache subtitles and metadata | | `YT_DLP_*` | โ€” | Timeouts, proxy, and JS runtimes. See [.env.example](https://github.com/samson-art/transcriptor-mcp/blob/HEAD/.env.example) | The same port serves `GET /health` and `GET /metrics`. The metrics are in Prometheus format and include the `mcp_*` counters.
Transport, REST API, and development **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: ```bash docker run --rm -p 3000:3000 artsamsonov/transcriptor-mcp-api:latest ``` The Swagger interface is at `http://localhost:3000/docs`. For a full stack with the API and the MCP server, read [docker-compose.example.yml](https://github.com/samson-art/transcriptor-mcp/blob/HEAD/docker-compose.example.yml). **Development.** ```bash npm ci npm run build npm run dev:mcp # stdio, hot reload npm run dev:mcp:http # Streamable HTTP, hot reload npm test ``` You need Node.js 20 or later, and `yt-dlp` in your PATH. Frame capture also needs `ffmpeg`. Other scripts: `lint`, `type-check`, `format`, `test:coverage`, `test:e2e:api`, and `test:e2e:mcp`. **Releases.** The version comes from `package.json` at runtime, through [src/version.ts](https://github.com/samson-art/transcriptor-mcp/blob/HEAD/src/version.ts). Change this version, move the `[Unreleased]` entries of the changelog into the new version, then push a `v*` tag. CI builds both images and publishes the [MCP Registry](https://registry.modelcontextprotocol.io) entry from [server.json](https://github.com/samson-art/transcriptor-mcp/blob/HEAD/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. Fork the repository, make a branch, and make sure that `npm test` and `npm run lint` pass. Then open a pull request. ## โš–๏ธ Legal The hosted endpoint at `transcriptor.gateway.mcpal.io` is governed by the [Terms of Service](https://github.com/samson-art/transcriptor-mcp/blob/HEAD/legal/TERMS_OF_SERVICE.md) and the [Privacy Policy](https://github.com/samson-art/transcriptor-mcp/blob/HEAD/legal/PRIVACY_POLICY.md). 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](https://github.com/samson-art/transcriptor-mcp/blob/HEAD/LICENSE). ## ๐Ÿ’ฌ Support [Issues](https://github.com/samson-art/transcriptor-mcp/issues) ยท [GitHub profile](https://github.com/samson-art) ยท [LinkedIn](https://www.linkedin.com/in/artem-samsonov-284a66105/)