REST API

MCPTube REST API at mcp.mcptube.com/v1 to download audio and video and transcribe YouTube videos as JSON, with an API key, your account quota and long jobs.

Routes take and return JSON. The body of each POST has the same parameters as the matching MCP tool, and the response has the same fields. Send your API key in the Authorization header.

Route	Same as
`POST /v1/audio`	`download_audio`
`POST /v1/video`	`download_video`
`POST /v1/transcribe`	`transcribe_video`
`GET /v1/me`	Plan, today’s quota and this month’s AI transcription, without using calls
`GET /v1/jobs/{id}`	Result of a long call (see below)
`GET /v1/openapi.json`	OpenAPI 3.1 specification

curl

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

Long calls

Large downloads can take more than 90 seconds. In that case, the response is 202 Accepted with the job ID, and the result goes to statusUrl:

202 Accepted

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

Poll GET /v1/jobs/{id} with the same key every few seconds until status becomes done (with the result) or error (with the error). Only the key’s owner can see the job, which stays available for 1 hour.

Check your quota

GET /v1/me shows your plan and usage without using calls. MCP has no quota tool: limit messages already state your plan and when the quota resets, and the dashboard shows your usage in real time.

curl

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

The full list of routes, parameters and responses is in the API reference. Errors follow the format described in errors.