TranscriptDock MCP server
Commit Nov 2, 2026Allows AI agents to submit transcription jobs and retrieve transcripts from YouTube, TikTok, and Instagram videos.
Also known as TranscriptDock/transcriptdock-mcp
- Stars
- 0
- Tools
- 13
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 2, 2026
- License
- MIT
What is TranscriptDock MCP?
TranscriptDock allows AI agents to submit transcription jobs and retrieve transcripts from YouTube, TikTok, and Instagram videos. It exposes 13 tools, such as get_video_transcript, transcribe, get_job.
Summary generated from the project's README
About TranscriptDock MCP server
Extracting text from social media videos directly within your AI chat is what this server enables for developers using Claude, Cursor, or Claude Code. It acts as a bridge to the TranscriptDock API, allowing agents to process content from YouTube, TikTok, and Instagram. Users can choose between a remote setup using OAuth 2.1 for easy connection or a local installation via npx that requires a specific API key starting with td_live_.
The server provides a suite of tools to manage the entire transcription lifecycle. You can use get_video_transcript to handle the submission and retrieval in a single step, or use more granular tools like transcribe, get_job, and wait_for_job to monitor progress. It also supports content discovery through search_youtube, list_channel_videos, and list_tiktok_user_videos, making it possible to find and process media without leaving the interface. Depending on your plan, you can access existing captions using the captions_only mode or request AI-generated transcriptions.
What you can do with it
- 1Transcribe social media videosAsk your AI agent to convert a specific YouTube or TikTok link into a text transcript or an SRT file.
- 2Discover and process channel contentFind the most recent videos from a specific YouTube channel and transcribe the first one found.
- 3Monitor transcription progressCheck the current status or error details of a specific transcription job using its unique ID.
- 4Search for specific video topicsSearch YouTube for a particular topic and have the agent transcribe the most relevant result.
Written from the project's README. Every use case is checked against a quote from it.
TranscriptDock MCP tools 13
Detected from the READMEget_video_transcripttranscribeget_jobget_transcriptlist_jobswait_for_jobsearch_youtubelist_channel_videosget_channel_latest_videossearch_channel_videoslist_playlist_videoslist_tiktok_user_videos
| get_video_transcript | — | |
| transcribe | — | |
| get_job | — | |
| get_transcript | — | |
| list_jobs | — | |
| wait_for_job | — | |
| search_youtube | — | |
| list_channel_videos | — | |
| get_channel_latest_videos | — | |
| search_channel_videos | — | |
| list_playlist_videos | — | |
| list_tiktok_user_videos | — |
Show all 13 toolsShow fewer tools
get_video_discovery
| get_video_discovery | — |
Configuration
TRANSCRIPTDOCK_API_KEYTRANSCRIPTDOCK_BASE_URL
| Name | Description | |
|---|---|---|
| TRANSCRIPTDOCK_API_KEY | — | |
| TRANSCRIPTDOCK_BASE_URL | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabletranscriptdock/transcriptdock-mcp is public and reachablegithub.com/transcriptdock/transcriptdock-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-02github.com/transcriptdock/transcriptdock-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubTranscriptDock MCP server
An MCP server that wraps the TranscriptDock public API, so Claude, Cursor and other agents can submit transcription jobs and read back transcripts without you leaving the chat.
It only calls the public /v1 API (API reference). The hosted server signs you in with OAuth; the local one needs a TranscriptDock API key (td_live_...).
Remote (no install)
The hosted server is https://www.transcriptdock.com/mcp (Streamable HTTP). Use that exact URL: the apex domain redirects, and clients drop the Authorization header on a cross origin redirect.
Claude (claude.ai, Desktop, mobile)
Open Customize, Connectors, choose Add custom connector, and paste https://www.transcriptdock.com/mcp. Choose Add, then Connect, sign in to TranscriptDock and allow access. No API key needed: the server publishes RFC 9728 metadata and signs people in through OAuth 2.1 (dynamic client registration, S256 PKCE). An OAuth connection can read and submit jobs and read transcripts, nothing else.
Claude Code and other clients
claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp
Then run /mcp and choose Authenticate. To use an API key instead, send it as a bearer header:
claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp \
--header "Authorization: Bearer td_live_..."
{ "mcpServers": { "transcriptdock": { "url": "https://www.transcriptdock.com/mcp", "headers": { "Authorization": "Bearer td_live_..." } } } }
Ask for a video and the agent calls get_video_transcript(url): submit, wait, text back in one tool call.
Install locally (npx)
Claude Desktop (stdio)
Claude Desktop users can add the remote connector above instead. For the local server, add this to your Claude Desktop config (Settings, Developer, Edit config):
{
"mcpServers": {
"transcriptdock": {
"command": "npx",
"args": ["-y", "@transcriptdock/mcp"],
"env": {
"TRANSCRIPTDOCK_API_KEY": "td_live_...",
"TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
}
}
}
}
Claude Code
claude mcp add --transport stdio transcriptdock --env TRANSCRIPTDOCK_API_KEY=td_live_... --env TRANSCRIPTDOCK_BASE_URL=https://www.transcriptdock.com -- npx -y @transcriptdock/mcp
Cursor
Add a server in Cursor Settings, MCP, using the same command and environment variables:
{
"mcpServers": {
"transcriptdock": {
"command": "npx",
"args": ["-y", "@transcriptdock/mcp"],
"env": {
"TRANSCRIPTDOCK_API_KEY": "td_live_...",
"TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
}
}
}
}
Sources and modes
mode defaults to captions_only: the existing captions of a YouTube or TikTok video, 1
credit each. AI transcription (auto/transcribe modes, 2 credits per started minute)
needs a paid plan, so the trial answers 402 PLAN_REQUIRED. Instagram Reels (beta) have no
caption path: send them with mode: "auto" or "transcribe"; captions_only answers 422
CAPABILITY_UNAVAILABLE. GET /v1/capabilities lists what your plan can do. For local
development use a loopback URL such as http://127.0.0.1:3000 for TRANSCRIPTDOCK_BASE_URL.
Configuration
| Variable | Required | Purpose |
|---|---|---|
TRANSCRIPTDOCK_API_KEY |
yes | Your workspace API key. The server exits with a clear message if it is missing. |
TRANSCRIPTDOCK_BASE_URL |
yes | Explicit HTTPS API origin, https://www.transcriptdock.com. HTTP is allowed only for loopback local development. |
Tools
get_video_transcript: submit, wait and return the transcript text (or srt, vtt, segments) in one call. Example prompt: "What does this video say?"transcribe: submit a video or audio URL and get back the created job. Example prompt: "Transcribe this YouTube link and give me the SRT."get_job: look up a job's status, stage, error, and billing by ID. Example prompt: "Check on job 11111111-1111-4111-8111-111111111111."get_transcript: fetch a completed transcript as normalized JSON segments or as a text, SRT, or VTT export. Example prompt: "Get the VTT for transcript 22222222-2222-4222-8222-222222222222."list_jobs: list jobs for the workspace, newest first, with cursor pagination. Example prompt: "Show my last 10 transcription jobs."wait_for_job: poll a job every few seconds until it succeeds, fails, or is cancelled, then return it. Example prompt: "Transcribe this TikTok and wait until it is done."search_youtube: search YouTube by query with cursor paging. Example prompt: "Search YouTube for lofi study music and transcribe the top result"list_channel_videos: list videos from one channel with cursor paging. Example prompt: "List the latest videos from @veritasium"get_channel_latest_videos: get the latest videos from one channel newest first with no cursor input. Example prompt: "Find the latest five videos on @veritasium and transcribe the first one"search_channel_videos: search within one channel by query with cursor paging. Example prompt: "Search @veritasium for black holes and transcribe the best match"list_playlist_videos: list videos from one playlist with cursor paging. Example prompt: "List the videos in this playlist and transcribe the first one"list_tiktok_user_videos: list up to 10 videos from one TikTok profile with the profile stats. TikTok search and further pages are not available. Setinclude_detailsto fetch each video page for full stats, dates, hashtags, and music. Example prompt: "List the latest TikTok videos from @tiktokuser"get_video_discovery: get one video discovery by ID. Example prompt: "Check on my latest video discovery and show the video list"
Each listing tool creates one video discovery with a generated idempotency key then polls to completion with a bounded timeout. A timeout returns the last body with a flag and a hint to call get_video_discovery. A failed discovery returns an error result with the error object.
Every response is the raw API payload, pretty printed as JSON, except get_transcript with format: text, srt, or vtt, which returns the export file body directly. API errors come back as a readable tool error with the error code, message, and request ID; the API key is never included in output.
Development
npm install
npm run typecheck
npm run build
npm test
npm run dev
License
MIT
TranscriptDock MCP questions
What tools does TranscriptDock MCP provide?
It exposes 13 tools, including get_video_transcript, transcribe, get_job, get_transcript, list_jobs.
How do I use TranscriptDock with Claude Desktop?
You can use the remote connector by pasting the URL into the custom connector settings, or install it locally using npx with your API key in the configuration.
Can I transcribe Instagram Reels?
Yes, but you must use the 'auto' or 'transcribe' modes because Instagram Reels do not have a caption path available for the 'captions_only' mode.