Miragea Voice & Captions
Voiceover, cloned-voice speech and SRT/VTT captions for agents, with exact durations
- 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-mcpAdd 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)RequiredMIRAGEA_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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media