MCP server TranscriptDock
Commit 2 de nov. de 2026Permite que agentes de IA enviem tarefas de transcrição e recuperem transcrições de vídeos do YouTube, TikTok e Instagram.
Também conhecido como TranscriptDock/transcriptdock-mcp
- Stars
- 0
- Ferramentas
- 13
- Downloads, 30 dias
- —
- Versão mais recente
- —
- Último commit
- 2 de nov. de 2026
- Licença
- MIT
O que é o MCP TranscriptDock?
Permite que agentes de IA enviem tarefas de transcrição e recuperem transcrições de vídeos do YouTube, TikTok e Instagram. Ele expõe 13 ferramentas, como get_video_transcript, transcribe, get_job.
Resumo gerado a partir do README do projeto
Sobre o MCP server de TranscriptDock
Extrair texto de vídeos de redes sociais diretamente no seu chat de IA é o que este servidor possibilita para desenvolvedores que utilizam Claude, Cursor ou Claude Code. Ele atua como uma ponte para a API do TranscriptDock, permitindo que agentes processem conteúdo do YouTube, TikTok e Instagram. Os usuários podem escolher entre uma configuração remota usando OAuth 2.1 para uma conexão fácil ou uma instalação local via npx que requer uma chave de API específica começando com td_live_.
O servidor fornece um conjunto de ferramentas para gerenciar todo o ciclo de vida da transcrição. Você pode usar o get_video_transcript para lidar com o envio e a recuperação em uma única etapa, ou usar ferramentas mais granulares como transcribe, get_job e wait_for_job para monitorar o progresso. Ele também suporta a descoberta de conteúdo por meio de search_youtube, list_channel_videos e list_tiktok_user_videos, tornando possível encontrar e processar mídias sem sair da interface. Dependendo do seu plano, você pode acessar legendas existentes usando o modo captions_only ou solicitar transcrições geradas por IA.
O que você pode fazer com ele
- 1Transcrever vídeos de redes sociaisPeça ao seu agente de IA para converter um link específico do YouTube ou TikTok em uma transcrição de texto ou um arquivo SRT.
- 2Descobrir e processar conteúdo de canaisEncontre os vídeos mais recentes de um canal específico do YouTube e transcreva o primeiro encontrado.
- 3Monitorar o progresso da transcriçãoVerifique o status atual ou detalhes de erro de uma tarefa de transcrição específica usando seu ID exclusivo.
- 4Pesquisar tópicos de vídeo específicosPesquise no YouTube por um tópico específico e peça ao agente para transcrever o resultado mais relevante.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Ferramentas do MCP TranscriptDock 13
Detectadas a partir do 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 todas as 13 ferramentasMostrar menos ferramentas
get_video_discovery
| get_video_discovery | — |
Configuração
TRANSCRIPTDOCK_API_KEYTRANSCRIPTDOCK_BASE_URL
| Nome | Descrição | Tipo |
|---|---|---|
| TRANSCRIPTDOCK_API_KEY | — | |
| TRANSCRIPTDOCK_BASE_URL | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessíveltranscriptdock/transcriptdock-mcp is public and reachablegithub.com/transcriptdock/transcriptdock-mcp ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-02github.com/transcriptdock/transcriptdock-mcp ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNo tool named like delete, drop or execPassou
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no 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
Perguntas sobre o MCP TranscriptDock
Quais ferramentas o MCP TranscriptDock oferece?
Ele expõe 13 ferramentas, incluindo get_video_transcript, transcribe, get_job, get_transcript, list_jobs.
Como eu uso o TranscriptDock com o Claude Desktop?
Você pode usar o conector remoto colando a URL nas configurações de conector personalizado ou instalá-lo localmente usando npx com sua chave de API na configuração.
Posso transcrever Instagram Reels?
Sim, mas você deve usar os modos 'auto' ou 'transcribe', pois os Instagram Reels não possuem um caminho de legenda disponível para o modo 'captions_only'.