# Magic Hour

Gives your agent image, video and audio generation and editing through the hosted Magic Hour server. Handy when you want a clip or a still straight from the agent chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: magichourhq
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/magichourhq/magic-hour-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/magic-hour

## What it does

This server hands an agent Magic Hour's media tools: generate and edit images and video, make music, upload files, wait for a render, and fetch existing audio projects. Tools are built from an OpenAPI spec at startup, with extra guidance telling the agent how to poll long jobs and download results.

Every generation spends credits from your Magic Hour account, and a creation tool replies right away with `id` and `credits_charged`. Technical failures usually refund credits; a result you simply dislike does not. A wait timeout doesn't mean the project failed, so resume with the same project ID.

Tool calls need authentication. With OAuth you sign in and approve access on Magic Hour; with manual setup you send `Authorization: Bearer <magic_hour_api_key>`. `ping` doesn't check the key, so call `account_retrieve` first. Files can't go in as raw bytes: the agent asks for an upload URL via `video_assets_generate_presigned_url`, uploads there, then hands the returned `file_path` to the creation tool.

## Requirements
- Remote server: `https://mcp.magichour.ai/`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http magic-hour https://mcp.magichour.ai/
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add magic-hour --url https://mcp.magichour.ai/
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "magic-hour": {
            "url": "https://mcp.magichour.ai/"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "magic-hour": {
            "type": "http",
            "url": "https://mcp.magichour.ai/"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http magic-hour https://mcp.magichour.ai/
```

## When to use it
- animate an approved product photo with a slow camera move
- swap a face in an existing video
- turn a portrait plus an audio file into a talking photo
- build a UGC ad clip from a script and a prepared image
- generate a music track from a text description

## Example prompts
- Use Magic Hour to animate my portrait with a slow camera push, wait for the render and show me the finished video
- Check my Magic Hour API access with `account_retrieve` before generating anything
- Pull up `workflow_guide_retrieve` for `talking-photo` and tell me which input files I need

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26559
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9289

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md