Skip to content
MCP server

TTS MCP Server

Turn scripts into voiceover audio with matching SRT and VTT subtitles

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, API, macOS
Runs
Locally
Version
0.1.1
Listing updated
3 days ago

About TTS MCP Server

TTS MCP Server is a freemium MCP server for design and media. It runs locally on your machine and is started by your AI client.

One call can take a script file and write an audio narration plus .srt and .vtt captions side by side, ready for video editors such as CapCut, Premiere Pro or DaVinci Resolve. Caption timing comes from speech recognition on the generated audio, but the server puts back your exact script wording so brand names are not mis-spelled by the recogniser.

Beyond narration it can clone a voice from a reference audio URL, use voices saved in your Miragea account and transcribe local audio or video into captions. Output formats include MP3, WAV, FLAC, Opus, AAC and PCM, and caption length is adjustable for vertical short-form video.

The server runs locally over stdio (install with uvx, pip or Docker) and needs a MIRAGEA_API_KEY. It is MIT licensed, while speech generation runs on the Miragea service, whose plans meter audio credits and characters per request.

Install

Run in a terminal

claude mcp add tts-mcp-server --env MIRAGEA_API_KEY='<MIRAGEA_API_KEY>' -- uvx tts-mcp-server

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • MIRAGEA_API_KEYMiragea API key from https://miragea.ai/workspace/apiRequired
  • MIRAGEA_OUTPUT_DIRFolder for generated audio and subtitles (default ~/Miragea)
  • MIRAGEA_BASE_URLAPI root including /v1 (default https://miragea.ai/v1)
  • MIRAGEA_WAIT_TIMEOUTMax seconds to wait for a job before returning its task_id (default 600)
  • MIRAGEA_API_KEYMiragea API key from https://miragea.ai/workspace/apiRequired
  • MIRAGEA_BASE_URLAPI root including /v1 (default https://miragea.ai/v1)
  • MIRAGEA_WAIT_TIMEOUTMax seconds to wait for a job before returning its task_id (default 600)

Tools this server provides (1)

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

miragea_script_to_voiceover
Generates narration from a script and writes audio plus SRT and VTT captions.

What it does

Script to voiceover
One tool call writes narration audio and caption files together.
Script-faithful captions
Keeps recognised timing but restores your exact wording.
Voice cloning
Clones a voice from a reference audio URL; Miragea cites 5 to 10 seconds of sample on its site.
Subtitle formats
Writes both SRT and WebVTT files.
Local transcription
Transcribes local audio or video files into captions.
Several audio formats
Exports MP3, WAV, FLAC, Opus, AAC or PCM.

Good for

  • Add a voiceover and captions to a YouTube Short
  • Narrate a course or product explainer from a text script
  • Dub a character with a cloned voice
  • Generate captions for existing audio or video files

Pricing

Freemium

Server is MIT licensed and needs a Miragea API key; Miragea offers a free trial and paid plans with monthly audio credits. Prices not published here.

Prices change. Check miragea.ai before you buy.

TTS MCP Server FAQ

What do I need to run it?

A MIRAGEA_API_KEY from the Miragea workspace; install with uvx tts-mcp-server, pip or Docker.

Which clients does it support?

The README lists Claude Desktop, Claude Code, Cursor, OpenAI Codex, VS Code and Windsurf.

Is the server open source?

Yes, it is MIT licensed, but generation uses the paid Miragea service.

What was it called before?

miragea-voice-mcp; that command still works as an alias.

Is TTS MCP Server free?

TTS MCP Server has a free plan, with paid plans for more usage or features.

How do I add TTS MCP Server to Claude Code?

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

What are the best alternatives to TTS MCP Server?

The closest alternatives to TTS MCP Server are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to TTS MCP Server

  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. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ChartAnt

    MCP server

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

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. 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