MCP server de TranscriptDock
Commit 2 nov 2026Permite que los agentes de IA envíen trabajos de transcripción y recuperen transcripciones de videos de YouTube, TikTok e Instagram.
También conocido como TranscriptDock/transcriptdock-mcp
- Stars
- 0
- Herramientas
- 13
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 2 nov 2026
- Licencia
- MIT
¿Qué es TranscriptDock MCP?
Permite que los agentes de IA envíen trabajos de transcripción y recuperen transcripciones de videos de YouTube, TikTok e Instagram. Expone 13 herramientas, como get_video_transcript, transcribe, get_job.
Resumen generado a partir del README del proyecto
Acerca del MCP server de TranscriptDock
Extraer texto de videos de redes sociales directamente en tu chat de IA es lo que este servidor permite a los desarrolladores que usan Claude, Cursor o Claude Code. Actúa como un puente hacia la API de TranscriptDock, permitiendo que los agentes procesen contenido de YouTube, TikTok e Instagram. Los usuarios pueden elegir entre una configuración remota usando OAuth 2.1 para una conexión sencilla o una instalación local vía npx que requiere una API key específica que comience con td_live_.
El servidor proporciona un conjunto de herramientas para gestionar todo el ciclo de vida de la transcripción. Puedes usar get_video_transcript para gestionar el envío y la recuperación en un solo paso, o utilizar herramientas más granulares como transcribe, get_job y wait_for_job para monitorear el progreso. También permite el descubrimiento de contenido mediante search_youtube, list_channel_videos y list_tiktok_user_videos, lo que hace posible encontrar y procesar archivos multimedia sin salir de la interfaz. Dependiendo de tu plan, puedes acceder a subtítulos existentes usando el modo captions_only o solicitar transcripciones generadas por IA.
Qué puedes hacer con él
- 1Transcribir videos de redes socialesPide a tu agente de IA que convierta un enlace específico de YouTube o TikTok en una transcripción de texto o un archivo SRT.
- 2Descubrir y procesar contenido de canalesEncuentra los videos más recientes de un canal de YouTube específico y transcribe el primero que encuentre.
- 3Monitorear el progreso de la transcripciónConsulta el estado actual o los detalles de error de un trabajo de transcripción específico usando su ID único.
- 4Buscar temas de video específicosBusca un tema particular en YouTube y haz que el agente transcriba el resultado más relevante.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de TranscriptDock MCP 13
Detectado desde el 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 | — |
Mostrar las 13 herramientasMostrar menos herramientas
get_video_discovery
| get_video_discovery | — |
Configuración
TRANSCRIPTDOCK_API_KEYTRANSCRIPTDOCK_BASE_URL
| Nombre | Descripción | Tipo |
|---|---|---|
| TRANSCRIPTDOCK_API_KEY | — | |
| TRANSCRIPTDOCK_BASE_URL | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibletranscriptdock/transcriptdock-mcp is public and reachablegithub.com/transcriptdock/transcriptdock-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-02github.com/transcriptdock/transcriptdock-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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
Preguntas sobre TranscriptDock MCP
¿Qué herramientas proporciona TranscriptDock MCP?
Expone 13 herramientas, incluidas get_video_transcript, transcribe, get_job, get_transcript, list_jobs.
¿Cómo uso TranscriptDock con Claude Desktop?
Puedes usar el conector remoto pegando la URL en la configuración de conectores personalizados, o instalarlo localmente usando npx con tu API key en la configuración.
¿Puedo transcribir Instagram Reels?
Sí, pero debes usar los modos 'auto' o 'transcribe' porque los Instagram Reels no tienen una ruta de subtítulos disponible para el modo 'captions_only'.