Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MAGIC_HOUR_API_KEY | Yes | Your Magic Hour API key, which can be obtained from magichour.ai/settings/developer |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| face_swap_video | Swap a face onto a video. Provide a source video (file path or URL) and a face image. Returns the project ID to check status. |
| face_swap_video_youtube | Swap a face onto a YouTube video. Provide a YouTube URL and a face image. |
| face_swap_photo | Swap a face onto a photo. Provide a target photo and a source face image. |
| detect_faces | Detect faces in an image or video. Returns face IDs that can be used for individual face swapping. |
| get_face_detection_result | Get the result of a face detection job. Returns detected face IDs and URLs. |
| face_swap_video_individual | Swap specific faces in a video. Use detect_faces first to get face IDs, then map each original face to a new face image. |
| lip_sync | Sync lip movements in a video to an audio track. Provide a video and audio file. |
| get_video_project_status | Check the status of a video project (face swap, lip sync, etc). Returns status, download URLs when complete. |
| get_image_project_status | Check the status of an image project (face swap photo, etc). Returns status, download URLs when complete. |
| upload_file | Upload a local file to Magic Hour for use in other tools. Returns the file path to use in subsequent API calls. |
| delete_video_project | Delete a video project. |
| delete_image_project | Delete an image project. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |