API REST

API REST do MCPTube em mcp.mcptube.com/v1 para baixar áudio e vídeo e transcrever vídeos do YouTube em JSON, com chave de API, cota da conta e jobs longos.

As rotas aceitam e devolvem JSON. O corpo de cada POST tem os mesmos parâmetros da ferramenta MCP correspondente, e a resposta tem os mesmos campos. Envie a chave de API no header Authorization.

Rota	Equivale a
`POST /v1/audio`	`download_audio`
`POST /v1/video`	`download_video`
`POST /v1/transcribe`	`transcribe_video`
`GET /v1/me`	Plano, cota do dia e transcrição por IA do mês, sem gastar chamadas
`GET /v1/jobs/{id}`	Resultado de uma chamada longa (veja abaixo)
`GET /v1/openapi.json`	Especificação OpenAPI 3.1

curl

curl https://mcp.mcptube.com/v1/transcribe \
  -H "Authorization: Bearer mct_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"url": "youtu.be/jNQXAC9IVRw", "format": "text"}'

Chamadas longas

Downloads grandes podem passar de 90 segundos. Nesse caso, a resposta é 202 Accepted com o identificador do trabalho, e o resultado fica em statusUrl:

202 Accepted

{
  "id": "job_7HqZ2mWv",
  "status": "running",
  "statusUrl": "https://mcp.mcptube.com/v1/jobs/job_7HqZ2mWv"
}

Consulte GET /v1/jobs/{id} com a mesma chave a cada poucos segundos até status virar done (com o resultado) ou error (com o erro). Só o dono da chave vê o trabalho, que fica disponível por 1 hora.

Consultar a cota

GET /v1/me mostra o plano e o uso sem gastar chamadas. No MCP não existe ferramenta de cota: as mensagens de limite já dizem o plano e quando a cota reseta, e o painel mostra o uso em tempo real.

curl

curl https://mcp.mcptube.com/v1/me \
  -H "Authorization: Bearer mct_SUA_CHAVE"

A lista completa de rotas, parâmetros e respostas está na referência da API. Os erros seguem o formato descrito em erros.