# Transcriptor MCP

> One MCP server that gives Claude, ChatGPT, Cursor and any MCP client transcripts, chapters, metadata and still frames from YouTube and 10 more video platforms.

Endpoint: https://gateway.mcpal.io/mcp/transcriptor (Streamable HTTP; OAuth 2.1 browser sign-in on first connection, no static API keys).
Eight read-only tools; four of them render interactive widgets in clients that support MCP Apps or the ChatGPT Apps SDK.
Platforms: YouTube, Twitter/X, Instagram, TikTok, Twitch, Vimeo, Facebook, Bilibili, VK, Dailymotion, Reddit. Search is YouTube only.
The server returns text, metadata and single still frames. It never returns video or audio files.
Self-host (MIT): docker run --rm -p 4200:4200 artsamsonov/transcriptor-mcp:latest

## Tools

- get_transcript: clean plain-text transcript, language auto-detected, cursor-paged
- get_raw_subtitles: raw SRT or VTT content, in parts
- get_available_subtitles: lists official and auto caption languages
- get_video_info: title, channel, views, likes, upload date, tags, thumbnails
- get_video_chapters: chapter titles with start and end times
- get_video_frame: a single still frame at any timecode (jpeg or png)
- get_playlist_transcripts: transcripts for a selection of playlist videos
- search_videos: YouTube search with date filters

## Connect

- [Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp): Settings -> Customize -> Connectors -> Add -> Add custom connector -> paste the endpoint
- [ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta): Settings -> Security and login -> enable Developer mode -> Plugins -> + -> paste the endpoint (web, paid plans)
- [Claude Code](https://docs.claude.com/en/docs/claude-code/mcp): claude mcp add --transport http transcriptor https://gateway.mcpal.io/mcp/transcriptor
- [Cursor](https://cursor.com/docs/context/mcp): add {"mcpServers":{"transcriptor":{"url":"https://gateway.mcpal.io/mcp/transcriptor"}}} to ~/.cursor/mcp.json
- [VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers): add {"servers":{"transcriptor":{"type":"http","url":"https://gateway.mcpal.io/mcp/transcriptor"}}} to .vscode/mcp.json
- [LM Studio](https://lmstudio.ai/docs/app/plugins/mcp): add {"mcpServers":{"transcriptor":{"url":"https://gateway.mcpal.io/mcp/transcriptor"}}} to mcp.json (Program → Install → Edit mcp.json)
- [Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp): add {"mcpServers":{"transcriptor":{"serverUrl":"https://gateway.mcpal.io/mcp/transcriptor"}}} to ~/.codeium/windsurf/mcp_config.json
- [Cline](https://docs.cline.bot/mcp/configuring-mcp-servers): add {"mcpServers":{"transcriptor":{"type":"streamableHttp","url":"https://gateway.mcpal.io/mcp/transcriptor"}}} to cline_mcp_settings.json (MCP Servers → Configure)
- [Zed](https://zed.dev/docs/ai/mcp): add {"context_servers":{"transcriptor":{"url":"https://gateway.mcpal.io/mcp/transcriptor"}}} to settings.json
- [Codex](https://learn.chatgpt.com/docs/extend/mcp?surface=cli): add [mcp_servers.transcriptor] with url = "https://gateway.mcpal.io/mcp/transcriptor" and auth = "oauth" to ~/.codex/config.toml, then run codex mcp login transcriptor
- [Gemini CLI](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html): gemini mcp add --transport http transcriptor https://gateway.mcpal.io/mcp/transcriptor
- [JSON](https://modelcontextprotocol.io/docs/develop/connect-remote-servers): add {"mcpServers":{"transcriptor":{"url":"https://gateway.mcpal.io/mcp/transcriptor"}}} to your client's MCP config

## Docs

- [README](https://github.com/samson-art/transcriptor-mcp#readme): full tool reference, widgets and self-host guide
- [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=transcriptor): registry entry
- [Terms of Service](https://transcriptor-mcp.org/terms)
- [Privacy Policy](https://transcriptor-mcp.org/privacy)