Skip to content
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 TranscriptDock to Claude Code.
Claude DesktopAdd TranscriptDock as an MCP server in Claude Desktop's configuration file.
CursorAdd TranscriptDock as an MCP server in Cursor.
WindsurfAdd TranscriptDock to Windsurf so Cascade can find and transcribe videos.
OpenClawConnect TranscriptDock to OpenClaw autonomous agents.
19 results
MCP client

Claude Desktop

Add TranscriptDock as an MCP server in Claude Desktop's configuration file.


1. Open the config file#

Open Claude Desktop, go to Settings, then Developer, then Edit Config. Or open the file directly:

OSPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\\Claude\\claude_desktop_config.json

2. Add the server#

Add a transcriptdock entry under mcpServers, with your API key:

claude_desktop_config.json
{
"mcpServers": {
"transcriptdock": {
"command": "npx",
"args": ["-y", "@transcriptdock/mcp"],
"env": {
"TRANSCRIPTDOCK_API_KEY": "td_live_YOUR_KEY",
"TRANSCRIPTDOCK_BASE_URL": "https://transcriptdock.com"
}
}
}
}

3. Restart Claude Desktop#

Quit and reopen the app so it picks up the new server.

4. Verify#

Start a new chat and ask: “Transcribe this YouTube link” with a URL attached. Claude calls the transcribe tool and returns the job. If it asks for permission to use the tool, allow it.

Example prompts#

  • “Transcribe this YouTube link and give me the SRT.”
  • “Check on job 11111111-1111-4111-8111-111111111111.”
  • “Transcribe this TikTok and wait until it is done.”

Troubleshooting#

  • Tool not showing up: confirm the JSON is valid (no trailing commas) and restart the app.
  • “Key not found”: check TRANSCRIPTDOCK_API_KEY is inside the env block, not the shell.
  • Command not found: install Node.js so npx is on your PATH.