Início
Documentação
download_video

download_video

Ferramenta download_video do MCPTube: baixe vídeos do YouTube em MP4 com capa e capítulos, em H.264 até 1080p e em VP9 ou AV1 acima disso, sem recodificar.

Baixar vídeo do YouTube · REST: POST /v1/video

MP4 com capa, artista e capítulos, na maior qualidade até maxHeight. Até 1080p o vídeo vem em H.264; acima disso o YouTube só tem VP9 ou AV1, e o MCPTube entrega no codec original, sem recodificar (a resposta traz compatibilityNote). O áudio vem em AAC.

Se o pedido passar do limite do plano, o vídeo vem na resolução máxima permitida e a resposta traz planNote. A chamada conta normalmente.

Parâmetro	Tipo	Descrição
`url`obrigatório	string	URL ou ID de um vídeo do YouTube.
`maxHeight`padrão: 1080	inteiro, 144 a 4320	Altura máxima em pixels: 144, 360, 480, 720, 1080, 1440 ou 2160.
`audioLanguage`opcional	string	Faixa de áudio preferida, como `"pt"` ou `"original"`.

Exemplo

Peça ao seu assistente

Baixe este vídeo em 1080p: https://www.youtube.com/watch?v=dQw4w9WgXcQ

O assistente chama download_video e responde com o link do MP4.

curl

curl https://mcp.mcptube.com/v1/video \
  -H "Authorization: Bearer mct_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "maxHeight": 1080}'

Resposta no plano Gratuito

Resposta

{
  "videoId": "dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "author": "Rick Astley",
  "durationSeconds": 213,
  "fileName": "dQw4w9WgXcQ-Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster).mp4",
  "fileSizeBytes": 30007919,
  "downloadUrl": "https://mcp.mcptube.com/files/Kp3sW0aZ…/dQw4w9WgXcQ-Rick%20Astley….mp4",
  "expiresAt": "2026-10-21T19:31:52.000Z",
  "videoCodec": "h264",
  "planNote": "Resolução limitada a 720p (pedido: 1080p). Seu plano: Gratuito. O plano Pro tem limites maiores e transcrição por IA: https://mcptube.com"
}

No MCP, o assistente recebe estes mesmos campos. A resposta também traz videoFormat e audioFormat, com o contêiner, os codecs e a resolução de cada faixa.