Fetch Video Download
fetch_video_downloadFetch a completed project's video as an embedded MCP binary resource for compatible clients. Use the exact signed download URL, including query parameters. Requires HTTPS at the configured Magic Hour media host. Read-only; inline content is limited to 8 MiB, or a smaller requested max_bytes. Returns the original-file download link when the media exceeds this limit. For playback or downloads in ChatGPT, open Magic Hour’s result card with get_video_project or wait_for_video_project using the existing project ID. When this tool shows a result card in ChatGPT, use its Download control. Do not put the signed URL in a chat link.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"download_url": "<download_url>"
},
"name": "fetch_video_download"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_bytes | No | Positive maximum inline download bytes, capped at 8388608 bytes (8 MiB). Larger files return an original-file download link. | |
| download_url | Yes | Exact HTTPS URL from a completed project’s downloads or exact_download_urls. Preserve all query parameters; must use the configured Magic Hour media host. |