# Miragea Voice & Captions

> Miragea Voice & Captions is a paid MCP server for design and media. Voiceover, cloned-voice speech and SRT/VTT captions for agents, with exact durations. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://huggingface.co/spaces/headvox/miragea-mcp
- **Repository:** https://github.com/yyert123/miragea-mcp
- **MCP Registry name:** io.github.yyert123/miragea-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

A pay-as-you-go voice toolkit for agents that produce video and audio. Long text is chunked at sentence ends to fit the API's 2,000-character limit and joined with a 120 ms pause, and every call returns the measured audio length so timelines line up to the frame. Voices can be saved ones or cloned from a public clip, and speech recognition and voice both come from Miragea.

The README documents five tools: check_setup, list_voices, speak, transcribe and narrate_scenes. Transcription turns local audio or video into SRT and VTT with whole words and two lines of 42 characters, plus a shorts style of one to three uppercase words. narrate_scenes writes one audio file per scene with durationInFrames and an optional word-level captions.json in Remotion's shape.

It guards against waste: identical requests are cached, existing files are never overwritten, retries reuse an idempotency key, and errors come back with a how_to_fix field. It installs via uvx or pip and needs a Miragea API key.

## Features

- **Exact durations:** Each call returns audio length measured from the file.
- **Long-text speech:** Text is split and rejoined automatically around the API limit.
- **Whole-word captions:** SRT and VTT are rebuilt from whole words with broadcast-style line rules.
- **Remotion scenes:** narrate_scenes returns durationInFrames and word-level captions per scene.
- **Safe file handling:** Existing files get a numbered name instead of being overwritten.

## Good for

- Read release notes aloud in a cloned voice
- Add TikTok-style captions to a short clip
- Narrate scenes for a Remotion video
- Generate SRT and VTT from a talk recording

## Install

### Claude Code (Terminal)

```sh
claude mcp add miragea-mcp --env MIRAGEA_API_KEY='<MIRAGEA_API_KEY>' -- uvx miragea-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "miragea-mcp": {
      "command": "uvx",
      "args": [
        "miragea-mcp"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "miragea-mcp": {
      "command": "uvx",
      "args": [
        "miragea-mcp"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "miragea-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "miragea-mcp"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "miragea-mcp": {
      "command": "uvx",
      "args": [
        "miragea-mcp"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "miragea-mcp": {
      "command": "uvx",
      "args": [
        "miragea-mcp"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

## Tools

- `check_setup`: Checks key, ffmpeg, saved voices and output folder and suggests fixes.
- `list_voices`: Lists voices saved in your Miragea account.
- `speak`: Converts text of any length to speech and returns the exact duration.
- `transcribe`: Turns local audio or video into SRT and VTT captions.
- `narrate_scenes`: Produces one audio file per scene with frame counts and an optional captions file.

## FAQ

### What do I need to run it?

A Miragea API key in MIRAGEA_API_KEY, plus uvx or pip, and ffmpeg.

### Does it need a GPU?

No, the README says no GPU is needed.

### How is it billed?

The README describes pay-as-you-go Miragea points.

### Where do files go?

To ~/Miragea unless MIRAGEA_OUTPUT_DIR is set.

### Is Miragea Voice & Captions free?

No. Miragea Voice & Captions is a paid product.

### How do I add Miragea Voice & Captions to Claude Code?

Run this command in your terminal: claude mcp add miragea-mcp --env MIRAGEA_API_KEY='<MIRAGEA_API_KEY>' -- uvx miragea-mcp

### What are the best alternatives to Miragea Voice & Captions?

The closest alternatives to Miragea Voice & Captions are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/miragea-voice-and-captions
