Skip to content
MCP server

Miragea Voice & Captions

Voiceover, cloned-voice speech and SRT/VTT captions for agents, with exact durations

Runs locallyStatus and history
Install
Pricing
Paid
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.1.0
Listing updated
3 days ago

About Miragea Voice & Captions

Miragea Voice & Captions is a paid MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • MIRAGEA_API_KEYMiragea API key (https://miragea.ai)Required
  • MIRAGEA_VOICE_IDDefault saved voice id (optional)
  • MIRAGEA_OUTPUT_DIRFolder for generated files (default ~/Miragea)

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Paid

Pay-as-you-go Miragea points; prices not published

Prices change. Check huggingface.co before you buy.

Miragea Voice & Captions 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 to Miragea Voice & Captions

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media