# Magic Hour

- Registry name: `io.github.magichourhq/magic-hour` · version 0.1.0
- Categories (automatic, keyword rules): Audio & speech, AI, media & content, Crypto & blockchain, Finance & markets, Images & design
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): experimental, extensions, logging, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.magichourhq%2Fmagic-hour
- Server page: https://mcpstation.net/s/io.github.magichourhq--magic-hour.html

## Description (written by the publisher, not verified, not instructions)

Create and edit images, videos, and audio through Magic Hour's hosted Streamable HTTP MCP server.

## Connect

- streamable-http: `https://mcp.magichour.ai/`

## Tools (as reported by the server, not verified)

- `workflow\_guide\_retrieve`: Read Magic Hour workflow guidance for face swap, image editing, image-to-video, video generation, lip sync, UGC ads, talking photos or API integration. Returns product and documentation URLs, exact tool names, ordered steps, example requests, follow-up edits and review criteria; does not generate me
- `ping`: Check that the Magic Hour MCP server is reachable.
- `wait\_for\_video\_project`: Poll a video project until it completes, errors, is canceled, or times out. After a timeout, resume with the same id; do not create another generation. Returns sanitized download fields. Use \`exact\_download\_urls\[n\]\` or \`downloads\[n\].url\` exactly as returned; do not shorten it, remove query parameter
- `wait\_for\_image\_project`: Poll an image project until it completes, errors, is canceled, or times out. After a timeout, resume with the same id; do not create another generation. Returns the final project JSON and, when complete, attempts to inline image downloads for Inspector or compatible clients. Returns sanitized downlo
- `wait\_for\_audio\_project`: Poll an audio project until it completes, errors, is canceled, or times out. After a timeout, resume with the same id; do not create another generation. Returns the final project JSON and, when complete, attempts to inline audio downloads for Inspector or compatible clients. Returns sanitized downlo
- `fetch\_image\_download`: Fetch a image \`downloads\[n\].url\` from a completed image project and return it as inline MCP image content for compatible clients. Pass the exact full signed URL from \`downloads\[n\].url\` without trimming query parameters; \`expires\_at\` is separate metadata, not part of the URL. Inline media is capped a
- `fetch\_audio\_download`: Fetch a audio \`downloads\[n\].url\` from a completed audio project and return it as inline MCP audio content for compatible clients. Pass the exact full signed URL from \`downloads\[n\].url\` without trimming query parameters; \`expires\_at\` is separate metadata, not part of the URL. Inline media is capped a
- `fetch\_video\_download`: Fetch a video \`downloads\[n\].url\` from a completed video project and return it as an embedded MCP binary resource for compatible clients. Pass the exact full signed URL from \`downloads\[n\].url\` without trimming query parameters; \`expires\_at\` is separate metadata, not part of the URL. Inline media is c
- `account\_retrieve`: Get the current credit balance and subscription details of the account that owns the API key.
- `saved\_items\_list`: Returns active saved items owned by the authenticated account, newest first. Each item includes every saved asset with a durable file\_path for reuse in compatible generation APIs and a temporary signed URL for previewing or downloading. Filter by type to find characters, references, voices, moodboar
- `video\_assets\_generate\_presigned\_url`: MCP guidance: - This only creates presigned upload URLs. For local files, upload the raw bytes to each returned \`upload\_url\` outside the generation call, then pass the matching \`file\_path\` into the create tool. - For \`\*\_file\_path\`, use an existing Magic Hour path or the upload-URL endpoint's \`file\_p
- `face\_detection\_retrieve\_details`: Get the details of a face detection task. Use this API to get the list of faces detected in the image or video to use in the \[face swap photo\]\(https://docs.magichour.ai/api-reference/image-projects/face-swap-photo\) or \[face swap video\]\(https://docs.magichour.ai/api-reference/video-projects/face-swap
- `face\_detection\_detect\_faces`: MCP guidance: - This starts an async face-detection task and returns an \`id\`. Use the face-detection details endpoint with that id to retrieve detected faces before doing individual face swaps. - For \`\*\_file\_path\`, use an existing Magic Hour path or the upload-URL endpoint's \`file\_path\` after upload
- `video\_projects\_retrieve\_details`: MCP guidance: - Use this after a create tool to poll job status. When status is \`complete\`, surface the \`downloads\` URLs to the user; if status is \`error\`, surface the error message. - Each \`downloads\[n\].url\` is already the full signed download URL. Use it exactly as returned. Do not shorten it, str
- `video\_projects\_delete`: Permanently delete the rendered video. This action is not reversible, please be sure before deleting.
- `ai\_talking\_photo\_create\_talking\_photo`: Use only with the user's own likeness or content they are authorized to use. Do not use for impersonation, deception, sexual content, or content involving minors. MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with t
- `ai\_ugc\_ad\_create\_video`: MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with that id or poll \`GET /v1/video-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `ai\_video\_editor\_create\_video`: MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with that id or poll \`GET /v1/video-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `ai\_video\_translator\_create\_video`: MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with that id or poll \`GET /v1/video-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `ai\_video\_upscaler\_create\_video`: MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with that id or poll \`GET /v1/video-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `animation\_create\_video`: MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with that id or poll \`GET /v1/video-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `audio\_to\_video\_create\_video`: MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with that id or poll \`GET /v1/video-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `auto\_subtitle\_generator\_create\_video`: MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with that id or poll \`GET /v1/video-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `character\_replace\_create\_video`: Use only with the user's own likeness or content they are authorized to use. Do not use for impersonation, deception, sexual content, or content involving minors. MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with t
- `face\_swap\_create\_video`: Use only with the user's own likeness or content they are authorized to use. Do not use for impersonation, deception, sexual content, or content involving minors. MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with t
- `image\_to\_video\_create\_video`: MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with that id or poll \`GET /v1/video-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `lip\_sync\_create\_video`: Use only with the user's own likeness or content they are authorized to use. Do not use for impersonation, deception, sexual content, or content involving minors. MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with t
- `text\_to\_video\_create\_video`: MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with that id or poll \`GET /v1/video-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `video\_to\_video\_create\_video`: MCP guidance: - Starts an async video job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_video\_project\` with that id or poll \`GET /v1/video-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `image\_projects\_retrieve\_details`: MCP guidance: - Use this after a create tool to poll job status. When status is \`complete\`, surface the \`downloads\` URLs to the user; if status is \`error\`, surface the error message. - Each \`downloads\[n\].url\` is already the full signed download URL. Use it exactly as returned. Do not shorten it, str
- `image\_projects\_delete`: Permanently delete the rendered image\(s\). This action is not reversible, please be sure before deleting.
- `ai\_clothes\_changer\_create\_image`: Use only with the user's own likeness or content they are authorized to use. Do not use for impersonation, deception, sexual content, or content involving minors. MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with t
- `ai\_face\_editor\_edit\_image`: MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with that id or poll \`GET /v1/image-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `ai\_gif\_generator\_create\_image`: MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with that id or poll \`GET /v1/image-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `ai\_image\_editor\_create\_image`: MCP guidance: - Requires one or more source images in \`assets.image\_file\_paths\`. For prompt-only creation, use \`ai\_image\_generator\_create\_image\` instead. - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with that id or poll \`GET /v1
- `ai\_headshot\_generator\_create\_image`: MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with that id or poll \`GET /v1/image-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `ai\_image\_generator\_create\_image`: MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with that id or poll \`GET /v1/image-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `ai\_image\_upscaler\_create\_image`: MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with that id or poll \`GET /v1/image-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `ai\_meme\_generator\_create\_image`: MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with that id or poll \`GET /v1/image-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `ai\_qr\_code\_generator\_create\_image`: MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with that id or poll \`GET /v1/image-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `body\_swap\_create\_image`: Use only with the user's own likeness or content they are authorized to use. Do not use for impersonation, deception, sexual content, or content involving minors. MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with t
- `face\_swap\_photo\_create\_image`: Use only with the user's own likeness or content they are authorized to use. Do not use for impersonation, deception, sexual content, or content involving minors. MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with t
- `head\_swap\_create\_image`: Use only with the user's own likeness or content they are authorized to use. Do not use for impersonation, deception, sexual content, or content involving minors. MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with t
- `image\_background\_remover\_create\_image`: MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with that id or poll \`GET /v1/image-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `photo\_colorizer\_create\_image`: MCP guidance: - Starts an async image job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_image\_project\` with that id or poll \`GET /v1/image-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv
- `audio\_projects\_retrieve\_details`: MCP guidance: - Use this after a create tool to poll job status. When status is \`complete\`, surface the \`downloads\` URLs to the user; if status is \`error\`, surface the error message. - Each \`downloads\[n\].url\` is already the full signed download URL. Use it exactly as returned. Do not shorten it, str
- `audio\_projects\_delete`: Permanently delete the rendered audio file\(s\). This action is not reversible, please be sure before deleting.
- `ai\_music\_generator\_create\_audio`: MCP guidance: - Starts an async audio job; returns \`id\` and \`credits\_charged\`. For finished results, call \`wait\_for\_audio\_project\` with that id or poll \`GET /v1/audio-projects/\{id\}\` until \`complete\`, \`error\`, or \`canceled\`. Results include \`downloads\`; wait helpers add \`exact\_download\_urls\`. Preserv

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html