# Transcriptor

An MCP server that fetches video transcripts/subtitles via yt-dlp, with pagination for large responses. Supports YouTube, Twitter/X, Instagram, TikTok, Twitch, Vimeo, Facebook, Bilibili, VK, Dailymot…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add samson-art/transcriptor-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list samson-art/transcriptor-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get samson-art/transcriptor-mcp get_transcript

# Call a tool
npx -y @smithery/cli@latest tool call samson-art/transcriptor-mcp get_transcript '{}'
```

## Direct MCP Connection

Endpoint: `https://transcriptor-mcp--samson-art.run.tools`

## Tools (7)

- `get_transcript` — Fetch cleaned subtitles as plain text for a video (YouTube, Twitter/X, Instagram, TikTok, Twitch, Vimeo, Facebook, Bili…
- `get_raw_subtitles` — Fetch raw SRT/VTT subtitles for a video (supported platforms). Optional lang: when omitted and Whisper fallback is used…
- `get_available_subtitles` — List available official and auto-generated subtitle languages.
- `get_video_info` — Fetch extended metadata for a video (title, channel, duration, tags, thumbnails, etc.).
- `get_video_chapters` — Fetch chapter markers (start/end time, title) for a video.
- `get_playlist_transcripts` — Fetch cleaned subtitles (plain text) for multiple videos from a playlist. Use playlistItems (e.g. "1:5") to select spec…
- `search_videos` — Search videos on YouTube via yt-dlp (ytsearch). Returns list of matching videos with metadata. Optional: limit, offset …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get samson-art/transcriptor-mcp <tool-name>
```

## Resources

- `transcriptor://info` — Information about available Transcriptor MCP resources and how to use them
- `transcriptor://docs/supported-platforms` — List of supported video platforms for subtitles and transcripts
- `transcriptor://docs/usage` — Brief usage guide for transcriptor-mcp tools

## Prompts (3)

- `get_transcript_for_video` (url) — Build a user message that asks the model to fetch the video transcript using the get_transcript tool.
- `summarize_video` (url) — Build a user message that asks the model to fetch the transcript and summarize the video content.
- `search_and_summarize` (query, url) — Build a user message that asks the model to search YouTube for videos matching the query, then fetch the transcript for…