TubeTranscript

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

TubeTranscript executa um servidor MCP remoto que permite que agentes do Claude Code, Cursor, Windsurf e n8n busquem a transcrição de um vídeo do YouTube com uma única chamada get_transcript. Ele lê as legendas primeiro e transcreve o áudio quando um vídeo não possui legendas. É necessária uma chave de API Pro ($9/mês).

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"

Plano Pro obrigatório. Para ver uma transcrição primeiro, cole um link na página inicial ou use Copiar para Claude, que não exige conta.

Conecte seu cliente

Existem dois servidores: /api/mcp para transcrições e /api/mcp/tools para as ferramentas de IA. Ambos usam a mesma chave Pro em um cabeçalho Authorization: Bearer e utilizam Streamable HTTP. As ferramentas de IA usam o job_id que o get_transcript retorna, então registre ambos.

Cursor (.cursor/mcp.json, mantenha fora do controle de versão)

{
  "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: os mesmos dois servidores em ~/.codeium/windsurf/mcp_config.json, com serverUrl em vez de url.
• n8n: um nó MCP Client Tool em um AI Agent, transporte HTTP Streamable, autenticação Bearer Auth.
• Claude Code: execute claude mcp list para confirmar que ambos conectam, depois inicie uma nova sessão para que as ferramentas carreguem.

Cada etapa, com os campos exatos, está no guia de configuração do MCP.

O que o agente pode chamar

Ferramenta	Servidor	Retorna
get_transcript	/api/mcp	A transcrição como texto simples limpo, o ID do vídeo, um status e o job_id que a armazena para sua equipe.
extract_hooks	/api/mcp/tools	Até 10 ganchos com horário de início e fim, um título e um resumo.
create_mindmap	/api/mcp/tools	Um mapa mental Mermaid do vídeo.
generate_chapters	/api/mcp/tools	Capítulos do YouTube com horários e títulos.
generate_description	/api/mcp/tools	Uma descrição do vídeo com tags e hashtags.
find_moments	/api/mcp/tools	Momentos de clipes curtos com um gancho, um motivo e uma citação.
analyze_hook	/api/mcp/tools	Uma análise da abertura, com sugestões de reescrita.
translate_subtitles	/api/mcp/tools	Legendas traduzidas para os idiomas que você escolher.
generate_brand_voice_blog	/api/mcp/tools	Um rascunho de blog em Markdown em uma das suas vozes de marca salvas.

As ferramentas de IA leem a transcrição de um job que você já possui e nunca buscam vídeos por conta própria. Chamar uma novamente com o mesmo job_id retorna o resultado armazenado.

Um fluxo de trabalho típico de agente

tools/call

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

1. O agente chama get_transcript com uma URL ou ID de vídeo. Ele obtém a transcrição como texto simples e um job_id.
2. Se status for processing, o vídeo não tem legendas e seu áudio está sendo transcrito. O agente chama novamente após cerca de 60 segundos.
3. O agente passa o job_id para generate_chapters, extract_hooks, translate_subtitles ou qualquer outra ferramenta de IA.

Chamadas repetidas são seguras: o job existente da sua equipe para um vídeo é reutilizado, então nada é transcrito duas vezes.

Vídeos sem legendas

Quando um vídeo não tem legendas, get_transcript recorre à transcrição de áudio em vez de retornar um erro. No Pro, ele lida com vídeos de até 2 horas. Vídeos privados e removidos, e transmissões ao vivo em andamento, ainda falham. Não está usando um agente? Obtenha uma transcrição de um vídeo sem legendas no navegador.

Limites e autenticação

Plano	Pro, $9/mês. Uma chave ausente, desconhecida ou não-Pro recebe 402 Payment Required.
Limite de taxa	1.000 chamadas de ferramenta por 24 horas por chave, compartilhadas com a API REST. initialize, tools/list e ping são gratuitos.
Transporte	Streamable HTTP sem estado. GET e DELETE na URL do servidor recebem 405.
Saída	get_transcript retorna texto simples sem carimbos de tempo. Para blocos com tempo, use a API REST.

Detalhes sobre chaves e limites: segurança e limites de taxa.

MCP, API REST ou copiar e colar?

Você quer	Use
Deixar um agente decidir quando buscar uma transcrição	Este servidor MCP
Buscar transcrições do seu próprio código ou automação	A API REST
Dar um vídeo ao ChatGPT ou Claude, grátis	Copiar para ChatGPT ou Copiar para Claude

Comparação com servidores MCP de código aberto

Servidores gratuitos de código aberto, como jkawamoto/mcp-youtube-transcript e kimtaeyoon83/mcp-server-youtube-transcript, são uma boa opção quando você está disposto a executar um processo na sua própria máquina. Leia dos READMEs deles em 2026-10-16:

	Servidores de código aberto	TubeTranscript
Onde roda	Na sua máquina, iniciado com uvx ou npx	Hospedado: você adiciona uma URL e uma chave
Custo	Gratuito, licença MIT	Pro, $9/mês
Vídeos sem legendas	Apenas legendas e subtítulos, conforme os READMEs. Um adiciona uma ferramenta opcional de análise de vídeo que precisa de uma chave TwelveLabs.	Recorre à transcrição de áudio
Bloqueios de IP	O primeiro README diz que o YouTube bloqueia IPs de nuvem e data centers e mostra como configurar seu próprio proxy	Sem proxy para configurar do seu lado
Carimbos de tempo	Segmentos com tempo estão disponíveis via MCP	get_transcript retorna texto simples; blocos com tempo vêm da API REST

Escolha um servidor de código aberto se você só precisa de legendas, quer algo gratuito ou deseja segmentos com tempo dentro do MCP.

FAQ

O que é o servidor MCP TubeTranscript?

Dois servidores MCP remotos que permitem que um agente de IA busque a transcrição de um vídeo do YouTube e a transforme em ganchos, capítulos, um mapa mental, legendas ou um rascunho de blog. Você os registra uma vez no Claude Code, Cursor, Windsurf ou n8n, e o agente chama as ferramentas por conta própria.

Quanto custa?

Os servidores MCP fazem parte do plano Pro, $9/mês. Uma chave de API Pro faz até 1.000 chamadas de ferramenta por 24 horas, compartilhadas com a API REST. Veja preços.

O get_transcript funciona para vídeos sem legendas?

Sim. Ele lê as legendas primeiro. Sem nenhuma, ele transcreve o áudio e retorna o status processing; o agente chama novamente com o mesmo vídeo após cerca de um minuto até que o status seja completed. O Pro cobre vídeos de até 2 horas.

Preciso do Pro apenas para testar?

Para os servidores MCP, sim: cada chamada de ferramenta precisa de uma chave de API Pro. Para ver como é uma transcrição primeiro, cole um link na página inicial ou use Copiar para Claude, que não exige conta.

Devo usar MCP ou a API REST?

Use MCP quando um agente decide quando buscar uma transcrição. Use a API REST quando seu próprio código fizer isso, por exemplo, de um script ou automação. Ambos usam a mesma chave Pro e o mesmo limite diário.

Como isso é diferente dos servidores MCP gratuitos de código aberto de transcrição do YouTube?

Eles rodam na sua máquina e são gratuitos. Este é hospedado, então não há processo ou proxy para configurar, e ele recorre à transcrição de áudio quando um vídeo não tem legendas. Custa Pro, e get_transcript retorna texto simples; segmentos com tempo vêm da API REST. Veja a comparação acima.

Quais clientes são suportados?

Qualquer cliente que fale Streamable HTTP MCP com um cabeçalho Bearer. O guia de configuração documenta Claude Code, Cursor, Windsurf e n8n.

Pronto para conectar seu agente? Pro é $9/mês.

Por Kenji Saito · Atualizado em 2026-10-16