Skip to content
Transcript Dock
Sign inStart free

Site menu

Transcript Dock
IntroductionHow it works, guides, and what you can transcribe.
QuickstartSubmit a link, wait for the job, export the transcript. Three requests.
AuthenticationAPI keys, scopes, Idempotency-Key and X-Request-Id.
JobsCreate, wait for, list, cancel and retry jobs.
TranscriptsThe transcript object and txt, srt, vtt, json exports.
BatchesUp to 50 videos in one request.
UploadsTranscribe your own audio and video files.
WebhooksGet called when a job or batch finishes; verify the signature.
ErrorsEvery error code, what it means and what to do.
Rate limitsSubmits, jobs in progress and reads per plan; the 429 response.
Pricing and credits1 credit per caption transcript, 2 per minute of AI transcription. Plans and extra credits.
SourcesYouTube, TikTok, your files and direct links: accepted URLs and modes.
MCPFind and transcribe videos from Claude, Cursor, Windsurf or your own agent.
OpenAPI SpecificationThe OpenAPI 3.1 spec for codegen and typed clients.
Claude CodeOne command adds Transcript Dock to Claude Code.
Claude appAdd Transcript Dock as a custom connector on claude.ai, Claude Desktop or mobile.
CursorAdd Transcript Dock as an MCP server in Cursor.
WindsurfAdd Transcript Dock to Windsurf so Cascade can find and transcribe videos.
OpenClawConnect Transcript Dock to OpenClaw autonomous agents.
19 results
Reference

Transcript MCP server

Give Claude, Cursor, Windsurf or your own agent tools to search YouTube, list TikTok profiles and read video transcripts. Remote server with OAuth sign in, or run it with npx.

Updated


The MCP server gives an AI agent the same API as your key: it can find videos, transcribe them and read the results in the middle of a conversation. It charges your credits. Nothing to install: point the client at the remote server, https://www.transcriptdock.com/mcp.

Connect#

Claude (claude.ai, Desktop, mobile)#

  • Open Customize, Connectors and choose Add custom connector.
  • Name it Transcript Dock and paste https://www.transcriptdock.com/mcp as the server URL. Leave the advanced settings empty.
  • Choose Add, then Connect. Sign in to Transcript Dock and choose Allow access.

No API key is involved: the connector signs in with your account and can read and submit jobs and read transcripts, never keys, billing or account settings. On Team and Enterprise plans an Owner adds it once under Organization settings, Connectors, and each member connects.

ChatGPT#

  • In ChatGPT on the web, open Plugins, select + and choose Add custom MCP server.
  • Name it Transcript Dock, paste https://www.transcriptdock.com/mcp as the server URL and choose OAuth as the authentication.
  • Save it, sign in to Transcript Dock and choose Allow access.

Custom MCP servers are available on ChatGPT plans that allow them, such as Business, Enterprise and Edu, and a workspace admin can switch them off. Like the Claude connector, it signs in with your account and never sees keys or billing.

Claude Code#

Add the server, then run /mcp in Claude Code and choose Authenticate to sign in.

Terminal
claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp

For CI and scripts, send an API key instead of signing in:

Terminal
claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp \
--header "Authorization: Bearer td_live_YOUR_KEY"

Cursor and other clients#

Cursor (.cursor/mcp.json)
{
"mcpServers": {
"transcriptdock": {
"url": "https://www.transcriptdock.com/mcp",
"headers": { "Authorization": "Bearer td_live_YOUR_KEY" }
}
}
}

Windsurf uses serverUrl instead of url, and VS Code lists servers under servers with "type": "http". The client pages below have the exact files.

Local server#

For stdio only clients such as OpenClaw, run the same server locally with Node.js 22.15 or newer. Both variables are required.

mcp config
{
"mcpServers": {
"transcriptdock": {
"command": "npx",
"args": ["-y", "@transcriptdock/mcp"],
"env": {
"TRANSCRIPTDOCK_API_KEY": "td_live_YOUR_KEY",
"TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
}
}
}
}
The remote server caps each tool call at about 40 seconds. A job still running after that comes back with its id; the agent can call wait_for_job again.

Tools#

ToolDoesCredits
get_video_transcriptURL in, transcript out. Submits, waits, returns text (or srt, vtt, segments).1, or 2 per minute with AI transcription
transcribeSubmit a job and return it without waiting.Same
wait_for_jobWait for a job to finish.Free
get_jobJob status, error and billing.Free
get_transcriptRead a transcript by id as segments, text, srt or vtt.Free
list_jobsRecent jobs.Free
search_youtubeSearch YouTube.1 per page
list_channel_videosA channel's videos, newest first, with paging.1 per page
get_channel_latest_videosA channel's latest 10 videos.1
search_channel_videosSearch inside one channel.1 per page
list_playlist_videosA playlist's videos.1 per page
list_tiktok_user_videosA TikTok profile's latest videos (up to 10) and profile stats.1
get_video_discoveryRead a discovery by id, e.g. after a timeout.Free

get_video_transcript#

The tool an agent should reach for when asked what a video says.

urlstringRequired
YouTube or TikTok video URL.
mode"captions_only" | "auto" | "transcribe"Optional
Default captions_only (1 credit). auto falls back to AI transcription when the video has no captions; transcribe always uses it (2 credits per started minute, paid plans).
format"text" | "srt" | "vtt" | "segments"Optional
text (default) is the most compact for an agent; segments returns timed JSON.
timeout_secondsintegerOptional
Default 120. On timeout the job state and id are returned instead.
call
{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }
returns
Never gonna give you up
Never gonna let you down
…

The same video with the same mode is answered from your workspace's stored result, free.

transcribe, wait_for_job, get_transcript#

The three-step version for agents that want control: transcribe takes url, mode, optional language and max_credits, plus an idempotency_key (any stable 8 to 128 character string, so a retried call never submits twice) and returns the job. wait_for_job takes job_id and an optional timeout_seconds. get_transcript takes the job's result_id as transcript_id and a format.

Finding videos#

The search and list tools return videos with url, title, duration and view count, ready to pass to get_video_transcript. channel accepts an @handle, channel id or channel URL; playlist an id or URL; user a TikTok @user or profile URL. YouTube tools page with limit (default 20) and cursor. TikTok returns at most 10 videos and no further pages; include_details adds likes, comments, hashtags and caption languages per video.

Errors#

A failed call returns isError: true with the API error code, message and request id, so the agent can explain it or change course. The codes are the ones in the API reference.

Troubleshooting#

  • Unauthorized: in Claude, remove the connector and add it again to sign in fresh. With a key, it goes in the server config (header or env), not in your shell; check it has not been revoked.
  • Couldn't reach the MCP server: use the exact URL https://www.transcriptdock.com/mcp, including www.
  • Tool not found: restart the client after editing its config.
  • Local server will not start: install Node.js 22.15 or newer and set both TRANSCRIPTDOCK_API_KEY and TRANSCRIPTDOCK_BASE_URL.
  • NO_CAPTIONS: the video has no captions. On a paid plan, ask for mode: "auto".