TTS MCP Server
Turn scripts into voiceover audio with matching SRT and VTT subtitles
- 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-serverAdd 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/apiRequiredMIRAGEA_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/apiRequiredMIRAGEA_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

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

Claude Code Ultimate Guide
MCP serverMCP 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

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