TubeTranscript

npx add-mcp 'https://tubetranscript.io/api/mcp'

TubeTranscript ejecuta un servidor MCP remoto que permite a los agentes de Claude Code, Cursor, Windsurf y n8n obtener la transcripción de un video de YouTube con una sola llamada a get_transcript. Primero lee los subtítulos y transcribe el audio cuando un video no los tiene. Requiere una clave API Pro ($9/mes).

Claude Code

claude mcp add --transport http tubetranscript https://tubetranscript.io/api/mcp \
  --header "Authorization: Bearer $TUBETRANSCRIPT_API_KEY"
claude mcp add --transport http tubetranscript-ai https://tubetranscript.io/api/mcp/tools \
  --header "Authorization: Bearer $TUBETRANSCRIPT_API_KEY"

Se requiere el plan Pro. Para ver una transcripción primero, pega un enlace en la página de inicio o usa Copiar para Claude, que no requiere cuenta.

Conecta tu cliente

Hay dos servidores: /api/mcp para transcripciones y /api/mcp/tools para las herramientas de IA. Ambos usan la misma clave Pro en un encabezado Authorization: Bearer y utilizan Streamable HTTP. Las herramientas de IA usan el job_id que devuelve get_transcript, así que registra ambos.

Cursor (.cursor/mcp.json, mantenlo fuera del control de versiones)

{
  "mcpServers": {
    "tubetranscript": {
      "url": "https://tubetranscript.io/api/mcp",
      "headers": { "Authorization": "Bearer tt_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }
    },
    "tubetranscript-ai": {
      "url": "https://tubetranscript.io/api/mcp/tools",
      "headers": { "Authorization": "Bearer tt_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }
    }
  }
}

• Windsurf: los mismos dos servidores en ~/.codeium/windsurf/mcp_config.json, con serverUrl en lugar de url.
• n8n: un nodo de Cliente de Herramienta MCP en un Agente de IA, transporte HTTP Streamable, autenticación Bearer Auth.
• Claude Code: ejecuta claude mcp list para confirmar que ambos se conectan, luego inicia una nueva sesión para que las herramientas se carguen.

Cada paso, con los campos exactos, está en la guía de configuración de MCP.

Lo que el agente puede llamar

Herramienta	Servidor	Devuelve
get_transcript	/api/mcp	La transcripción como texto plano limpio, el ID del video, un estado y el job_id que lo almacena para tu equipo.
extract_hooks	/api/mcp/tools	Hasta 10 ganchos con hora de inicio y fin, un título y un resumen.
create_mindmap	/api/mcp/tools	Un mapa mental Mermaid del video.
generate_chapters	/api/mcp/tools	Capítulos de YouTube con horas de reloj y títulos.
generate_description	/api/mcp/tools	Una descripción de video con etiquetas y hashtags.
find_moments	/api/mcp/tools	Momentos de clips cortos con un gancho, una razón y una cita.
analyze_hook	/api/mcp/tools	Un análisis de la apertura, con sugerencias de reescritura.
translate_subtitles	/api/mcp/tools	Subtítulos traducidos a los idiomas que elijas.
generate_brand_voice_blog	/api/mcp/tools	Un borrador de blog en Markdown en una de tus voces de marca guardadas.

Las herramientas de IA leen la transcripción de un trabajo que ya tienes y nunca obtienen videos por sí mismas. Llamar a una de nuevo con el mismo job_id devuelve el resultado almacenado.

Un flujo de trabajo típico de agente

tools/call

{ "name": "get_transcript", "arguments": { "video_url": "https://www.youtube.com/watch?v=jNQXAC9IVRw" } }

1. El agente llama a get_transcript con una URL o ID de video. Obtiene la transcripción como texto plano y un job_id.
2. Si status es processing, el video no tiene subtítulos y su audio se está transcribiendo. El agente vuelve a llamar después de unos 60 segundos.
3. El agente pasa el job_id a generate_chapters, extract_hooks, translate_subtitles o cualquier otra herramienta de IA.

Las llamadas repetidas son seguras: el trabajo existente de tu equipo para un video se reutiliza, por lo que nada se transcribe dos veces.

Videos sin subtítulos

Cuando un video no tiene subtítulos, get_transcript recurre a la transcripción de audio en lugar de devolver un error. En Pro maneja videos de hasta 2 horas. Los videos privados y eliminados, y las transmisiones en vivo en curso, aún fallan. ¿No usas un agente? Obtén una transcripción de un video sin subtítulos en el navegador.

Límites y autenticación

Plan	Pro, $9/mes. Una clave faltante, desconocida o no Pro obtiene 402 Payment Required.
Límite de tasa	1,000 llamadas de herramientas por 24 horas por clave, compartido con la API REST. initialize, tools/list y ping son gratuitos.
Transporte	Streamable HTTP sin estado. GET y DELETE en la URL del servidor obtienen 405.
Salida	get_transcript devuelve texto plano sin marcas de tiempo. Para fragmentos con tiempo, usa la API REST.

Detalles sobre claves y límites: seguridad y límites de tasa.

¿MCP, API REST o copiar y pegar?

Quieres	Usa
Dejar que un agente decida cuándo obtener una transcripción	Este servidor MCP
Obtener transcripciones desde tu propio código o una automatización	La API REST
Dar un video a ChatGPT o Claude, gratis	Copiar para ChatGPT o Copiar para Claude

Comparación con servidores MCP de código abierto

Los servidores gratuitos de código abierto como jkawamoto/mcp-youtube-transcript y kimtaeyoon83/mcp-server-youtube-transcript son una buena opción cuando estás dispuesto a ejecutar un proceso en tu propia máquina. Leído de sus READMEs el 2026-10-16:

	Servidores de código abierto	TubeTranscript
Dónde se ejecuta	En tu máquina, iniciado con uvx o npx	Alojado: agregas una URL y una clave
Costo	Gratis, licencia MIT	Pro, $9/mes
Videos sin subtítulos	Solo subtítulos y subtítulos, según sus READMEs. Uno agrega una herramienta opcional de análisis de video que necesita una clave de TwelveLabs.	Recurre a la transcripción de audio
Bloques de IP	El primer README dice que YouTube bloquea IPs de nube y centros de datos y muestra cómo configurar tu propio proxy	Sin proxy que configurar de tu lado
Marcas de tiempo	Segmentos con tiempo disponibles a través de MCP	get_transcript devuelve texto plano; los fragmentos con tiempo provienen de la API REST

Elige un servidor de código abierto si solo necesitas subtítulos, lo quieres gratis o quieres segmentos con tiempo dentro de MCP.

Preguntas frecuentes

¿Qué es el servidor MCP de TubeTranscript?

Dos servidores MCP remotos que permiten a un agente de IA obtener la transcripción de un video de YouTube y convertirla en ganchos, capítulos, un mapa mental, subtítulos o un borrador de blog. Los registras una vez en Claude Code, Cursor, Windsurf o n8n, y el agente llama a las herramientas por sí mismo.

¿Cuánto cuesta?

Los servidores MCP son parte del plan Pro, $9/mes. Una clave API Pro permite hasta 1,000 llamadas de herramientas por 24 horas, compartido con la API REST. Consulta precios.

¿Funciona get_transcript para videos sin subtítulos?

Sí. Primero lee los subtítulos. Si no hay, transcribe el audio y devuelve el estado processing; el agente vuelve a llamar con el mismo video después de aproximadamente un minuto hasta que el estado sea completed. Pro cubre videos de hasta 2 horas.

¿Necesito Pro solo para probarlo?

Para los servidores MCP, sí: cada llamada de herramienta necesita una clave API Pro. Para ver cómo se ve una transcripción primero, pega un enlace en la página de inicio o usa Copiar para Claude, que no requiere cuenta.

¿Debo usar MCP o la API REST?

Usa MCP cuando un agente decide cuándo obtener una transcripción. Usa la API REST cuando tu propio código lo hace, por ejemplo desde un script o una automatización. Ambos usan la misma clave Pro y el mismo límite diario.

¿En qué se diferencia de los servidores MCP gratuitos de código abierto de transcripción de YouTube?

Esos se ejecutan en tu máquina y son gratuitos. Este está alojado, por lo que no hay proceso ni proxy que configurar, y recurre a la transcripción de audio cuando un video no tiene subtítulos. Cuesta Pro, y get_transcript devuelve texto plano; los segmentos con tiempo provienen de la API REST. Consulta la comparación anterior.

¿Qué clientes son compatibles?

Cualquier cliente que hable Streamable HTTP MCP con un encabezado Bearer. La guía de configuración documenta Claude Code, Cursor, Windsurf y n8n.

¿Listo para conectar tu agente? Pro es $9/mes.

Por Kenji Saito · Actualizado 2026-10-16