Which integrations are available for this server?

Provides the capability to perform face swaps directly on videos sourced from YouTube using the Magic Hour AI platform.

How do I use Magic Hour MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Magic Hour MCP Server Face swap my photo onto this YouTube video" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Magic Hour MCP Server

MCP server for Magic Hour AI — face swap videos, face swap photos, lip sync, face detection, and file management.

Tools

Tool	Description
`face_swap_video`	Swap a face onto a video (file/URL source)
`face_swap_video_youtube`	Swap a face onto a YouTube video
`face_swap_video_individual`	Swap specific faces using face detection IDs
`face_swap_photo`	Swap a face onto a photo
`detect_faces`	Detect faces in an image or video
`get_face_detection_result`	Get detected face IDs and URLs
`lip_sync`	Sync lip movements to an audio track
`upload_file`	Upload a file to Magic Hour storage
`get_video_project_status`	Check video project status and get download URLs
`get_image_project_status`	Check image project status and get download URLs
`delete_video_project`	Delete a video project
`delete_image_project`	Delete an image project

Setup

Get an API key from magichour.ai/settings/developer
Install dependencies:

npm install

Build:

npm run build

Claude Desktop Configuration

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "magic-hour": {
      "command": "node",
      "args": ["/path/to/magic-hour-mcp/dist/index.js"],
      "env": {
        "MAGIC_HOUR_API_KEY": "mhk_live_your_key_here"
      }
    }
  }
}

Claude Code Configuration

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "magic-hour": {
      "command": "node",
      "args": ["/path/to/magic-hour-mcp/dist/index.js"],
      "env": {
        "MAGIC_HOUR_API_KEY": "mhk_live_your_key_here"
      }
    }
  }
}

Usage Example

Face swap a dance video:
1. Upload your face image: upload_file → get file_path
2. Start face swap: face_swap_video with video URL + face file_path
3. Poll status: get_video_project_status until "complete"
4. Download from the returned URL

Individual face swap:
1. Detect faces: detect_faces on the source video
2. Get results: get_face_detection_result to see all faces
3. Swap specific faces: face_swap_video_individual with face mappings