01
"Create a cinematic image of a crowded Thai night market with a neon Pad Thai sign."
Magic Hour × MCPTell your agent
Tell your agent
what to make.
It calls Magic Hour, waits for the render, and sends back the image, video, or audio.
https://mcp.magichour.ai/Verified clientsClaudeClaude CodeCodex CLI
Agent session · live
Create a cinematic image of a crowded Thai night market with a neon Pad Thai sign.
aiImageGenerator_createImagedone
project_7e3a · credits charged
Waiting for image project...
Generation complete
exact_download_url
Your image is ready.
PROMPT SENT → FILE RETURNED
01What it can do
Make or edit media from the chat.
The MCP server exposes Magic Hour's current API tools. It also tells the agent how to upload files, wait for renders, and return download links.
01
Image
Generate, edit, colorize, remove backgrounds, and swap faces or heads.
02
Video
Create from text or stills, lip sync, animate portraits, and swap faces.
03
Audio
Generate speech. Use audio files with talking-photo and other tools that accept audio.
02Setup
Connect your client once.
Every supported client uses the same hosted endpoint. Authentication differs by client. Follow the steps for yours.
Web + desktop
Connect Claude
OAuth handoff using your Magic Hour API key
- 1Open Settings → Connectors and add a custom connector.
- 2Enter https://mcp.magichour.ai/ as the connector URL.
- 3In Advanced settings, set OAuth Client ID to magic-hour-mcp.
- 4Select Connect, then paste your Magic Hour API key on the authorization page.
Connector URL · URL
https://mcp.magichour.ai/OAuth Client ID · TEXT
magic-hour-mcpFirst-run check
Call the magic-hour ping tool.Expected result: pong
Your Magic Hour API key can spend credits. Treat it like a password. Never paste it into source code, commit it, or share it publicly.
03Example requests
Start with a request like one of these.Start with a request like one of these.
Animate a still
02
"Animate this illustrated hooded character with slow camera movement."
03
"Add stylish sunglasses to this photo and keep the result realistic."
04Render jobs
Renders take time.
Your agent can wait.
The first call returns a project ID. A Magic Hour wait tool checks the job and returns the exact signed download URL when the file is ready.
01
Create
Agent calls the matching Magic Hour tool.
02
Wait
Project polls until a terminal state.
03
Upload
Agent uploads source files before the render.
04
Return
Exact download URLs come back.
05Operational details
Details worth knowing.
These answers match the current MCP repo. We leave out anything the code does not confirm.
Model Context Protocol lets an AI assistant call external tools. Magic Hour MCP lets your agent use Magic Hour image, video, and audio tools when you ask for them.
The current MCP repo verifies Claude, Claude Code, and Codex CLI. Cursor is not verified there, so it is not in this setup list.
Yes. Claude opens an OAuth authorization page where you paste your Magic Hour API key. Claude Code and Codex use the key as a bearer token. Never commit or share your key.
Yes. MCP calls the same Magic Hour API. Real generation requests spend Magic Hour credits, and the creation tool reports the charge. Check current pricing before starting a large job.
A render does not finish in the first tool call. The creation tool returns a project ID. A Magic Hour wait tool then checks the job until it completes. If your agent stops after creation, ask it to wait for the Magic Hour result.
For local files, the agent requests an upload URL, uploads the file, then gives the returned file path to a creation tool. The upload tool is called videoAssets_generatePresignedUrl. The name is confusing, but it accepts image, audio, and video files. Finished jobs return signed download URLs. Use each URL exactly as returned.
Restart Claude Code or Codex after adding the server. For Codex, confirm MAGIC_HOUR_API_KEY is available before it starts. If authentication fails, confirm the header uses Authorization: Bearer followed by an active key.
Use the hosted server
Connect Magic Hour MCP.
https://mcp.magichour.ai/Magic Hour MCP. Hosted Streamable HTTP.