MCP server

Magic Hour Official

io.github.magichourhq/magic-hour

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Source

At a glance

Type

MCP server

Publisher

magichour.ai (verified by the MCP Registry)

Status

Working at last check

Tools

48

Token cost

About 38,005 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http magic-hour https://mcp.magichour.ai/

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.magic-hour]
url = "https://mcp.magichour.ai/"

Gemini CLI

{"mcpServers":{"magic-hour":{"httpUrl":"https://mcp.magichour.ai/"}}}

Cursor

{"mcpServers":{"magic-hour":{"url":"https://mcp.magichour.ai/"}}}

VS Code

{"servers":{"magic-hour":{"type":"http","url":"https://mcp.magichour.ai/"}}}

Antigravity

agy mcp add magic-hour https://mcp.magichour.ai/

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"magic-hour","server_url":"https://mcp.magichour.ai/","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"magic-hour","server_url":"https://mcp.magichour.ai/"}

Tools

• account_retrieve ~58 tokens
  Get the current credit balance and subscription details of the account that owns the API key.
• ai_clothes_changer_create_image ~792 tokens
  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
• ai_face_editor_edit_image ~1244 tokens
  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 ~304 tokens
  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_headshot_generator_create_image ~615 tokens
  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 ~1916 tokens
  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_image_generator_create_image ~1824 tokens
  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 ~789 tokens
  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 ~306 tokens
  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_music_generator_create_audio ~467 tokens
  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
• ai_qr_code_generator_create_image ~342 tokens
  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_talking_photo_create_talking_photo ~1199 tokens
  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
• ai_ugc_ad_create_video ~808 tokens
  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 ~1193 tokens
  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 ~1206 tokens
  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 ~1006 tokens
  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 ~1920 tokens
  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_projects_delete Deletes data · ~112 tokens
  Permanently delete the rendered audio file(s). This action is not reversible, please be sure before deleting.
• audio_projects_retrieve_details ~279 tokens
  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_to_video_create_video ~1210 tokens
  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 ~1270 tokens
  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
• body_swap_create_image Moves money · ~747 tokens
  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
• character_replace_create_video ~1736 tokens
  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
• face_detection_detect_faces ~593 tokens
  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
• face_detection_retrieve_details ~194 tokens
  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-sw
• face_swap_create_video Moves money · ~1682 tokens
  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
• face_swap_photo_create_image Moves money · ~1288 tokens
  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
• fetch_audio_download ~170 tokens
  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_image_download ~170 tokens
  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_video_download ~172 tokens
  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
• head_swap_create_image Moves money · ~780 tokens
  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
• image_background_remover_create_image ~664 tokens
  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
• image_projects_delete Deletes data · ~110 tokens
  Permanently delete the rendered image(s). This action is not reversible, please be sure before deleting.
• image_projects_retrieve_details ~279 tokens
  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_to_video_create_video ~2337 tokens
  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 ~1401 tokens
  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
• photo_colorizer_create_image ~473 tokens
  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
• ping ~46 tokens
  Check that the Magic Hour MCP server is reachable.
• saved_items_list ~267 tokens
  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
• text_to_video_create_video ~2277 tokens
  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_assets_generate_presigned_url ~668 tokens
  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
• video_projects_delete Deletes data · ~109 tokens
  Permanently delete the rendered video. This action is not reversible, please be sure before deleting.
• video_projects_retrieve_details ~279 tokens
  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_to_video_create_video ~1729 tokens
  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
• wait_for_audio_project ~280 tokens
  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
• wait_for_image_project ~280 tokens
  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_video_project ~228 tokens
  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
• workflow_guide_retrieve ~186 tokens
  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

Browse

• GitHub tools
• GitHub and code hosting
• Music and audio
• Translation

Related MCP servers

• BlitzReels Video Editor
  Create, edit, reframe, caption, organize, generate, and export short-form videos with BlitzReels.
• Picorn
  Picorn turns AI briefs into editable social images and videos with layers, timelines, and renders.
• cuttingfloor
  Video editing for AI agents: cuts, captions, audio, motion graphics, previews, and exports.
• Switchapp Switch
  Generate, manage and explore your Switch AI image and video library, scoped to your account.
• GEN
  GEN is the creative AI video engineer. Free editor/social publishing; AI credits via card/x402.
• Cannon Studio
  Public Cannon Studio MCP for product, pricing, workflow, model, and API answers.
• Budgetpixel
  Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.
• CCAPI
  Image, video, music and text generation across 100+ models through one endpoint.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.magichourhq/magic-hour.svg)](https://aptlynx.net/servers/io.github.magichourhq/magic-hour)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents