# Transcriptor

Get your key here: https://forms.gle/gFUb5X6mTmzNaHUu6

## Quick Start

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

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

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

# Call a tool
npx -y smithery 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: type, lang, response_limit (when omitted retur…
- `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 tool get samson-art/transcriptor-mcp <tool-name>
```

## 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…