How do I install TTSForFree?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does TTSForFree need an API key?

No required environment variable is listed on this record.

What transport does TTSForFree use?

TTSForFree is reached over HTTP.

When was TTSForFree last checked?

Last checked 2026-11-09. Generate AI voices, text-to-speech, subtitles, transcription, and video localization.

TTSForFree MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.ttsforfree.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.calmnguyen-ttsforfree https://api.ttsforfree.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.calmnguyen-ttsforfree": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.ttsforfree.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

TTSForFree MCP server

Text-to-speech, multi-voice podcasts, subtitle voiceovers, transcription and video dubbing for Claude and any other MCP client. Thousands of AI voices in 100+ languages, returned as hosted MP3 URLs.

Server URL: https://api.ttsforfree.com/mcp (Streamable HTTP, remote, nothing to install)
Sign-in: OAuth. Click Connect and sign in to TTSForFree. No API key needed. An API key (X-API-Key header) also works for scripts and agents.
Registry: io.github.CalmNguyen/ttsforfree
Website: ttsforfree.com · setup guide: ttsforfree.com/en/claude-tts-connector

A free plan is included. Paid generation uses your TTSForFree credits.

Connect

Claude (claude.ai, Desktop, mobile)

Settings → Connectors → Add custom connector
URL: https://api.ttsforfree.com/mcp
Click Connect, sign in to TTSForFree and allow access.

Claude Code

claude mcp add --transport http ttsforfree https://api.ttsforfree.com/mcp

Then run /mcp → ttsforfree → Authenticate. With an API key instead:

claude mcp add --transport http ttsforfree https://api.ttsforfree.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Cursor, VS Code and other clients

{
  "mcpServers": {
    "ttsforfree": {
      "url": "https://api.ttsforfree.com/mcp"
    }
  }
}

Add "headers": { "X-API-Key": "YOUR_API_KEY" } if the client does not support OAuth. Get an API key at ttsforfree.com/en/profile.

Claude API (MCP connector)

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 2048,
    "mcp_servers": [{
      "type": "url",
      "name": "ttsforfree",
      "url": "https://api.ttsforfree.com/mcp",
      "authorization_token": "YOUR_TTSFORFREE_API_KEY"
    }],
    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "ttsforfree" }],
    "messages": [{ "role": "user", "content": "Read this in a warm British voice: Welcome to our channel!" }]
  }'

What you can ask

Ask Claude	Tools it uses
"Read this lesson in a calm British voice from my favorites."	`list_favorite_voices` → `text_to_speech`
"Turn this article into a 2-host podcast, one MP3."	`multi_voice_to_speech` → `get_job_detail`
"Translate this SRT to Spanish, keep the timestamps, voice it, give me the ffmpeg command."	`srt_to_speech` → `get_job_status`
"Transcribe this video into an SRT file."	`create_upload_url` → `transcribe_media`
"Dub this video into Vietnamese, Spanish and Japanese for YouTube. Cost first."	`create_upload_url` → `estimate_video_localization` → `localize_video` → `get_localization_status`
"Make me a young male voice that reviews stories, southern Vietnamese accent."	`design_custom_voice`

Video walkthroughs: ttsforfree.com/en/claude-tts-connector.

Tools (21)

Tool	Type	What it does
`list_languages`	read	All supported languages and their codes.
`list_voices`	read	Search voices by language, gender, provider and keywords ("warm narrator").
`get_voice_details`	read	Persona, use case, accent, styles, preview audio and credit cost of one voice.
`list_favorite_voices`	read	The user's favorite voices, in saved order.
`list_my_custom_voices`	read	Personal voices from Voice Design / Voice Clone and the remaining quota.
`add_favorite_voice`	write	Save a voice to favorites.
`remove_favorite_voice`	write	Remove a voice from favorites.
`design_custom_voice`	write	Create a new personal voice from a text description.
`get_account_status`	read	Plan, remaining credits, per-request limits and API rate limits.
`text_to_speech`	job	One text + one voice → MP3 (narration, articles, lessons).
`multi_voice_to_speech`	job	Ordered segments with different voices → one MP3 (podcast, dialogue).
`srt_to_speech`	job	SRT/WebVTT or timed segments → timeline-aligned MP3 + ffmpeg merge commands.
`get_job_status`	read	Poll a job until SUCCESS and get the audio URL.
`list_recent_jobs`	read	Recent jobs with audio URLs, to reuse instead of paying twice.
`get_job_detail`	read	Per-segment audio of a multi-voice/SRT job (for Remotion and captions).
`create_upload_url`	write	One-time upload URL for a local video/audio file (PUT, up to 2 GB).
`transcribe_media`

job tools are asynchronous: they return a job_id, and the client polls the matching status tool until SUCCESS.

Prompts: youtube_multi_language_audio, video_voiceover, podcast_episode, narrate_text.

Privacy and data

OAuth access is scoped to your TTSForFree account and can be revoked any time from your TTSForFree profile (Connected apps).
Text, subtitles and uploaded media are processed only to produce the audio, subtitles or video you asked for.
Privacy policy: ttsforfree.com/en/privacy-policy

Support

Open an issue in this repository or contact us via ttsforfree.com/en/contact.

Registry metadata

server.json is the entry published to the MCP Registry. To publish an update, bump version in server.json and push a tag vX.Y.Z (or run the Publish to MCP Registry workflow manually). The workflow signs in with GitHub OIDC, so no secret is needed.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install TTSForFree?

Does TTSForFree need an API key?

What transport does TTSForFree use?

When was TTSForFree last checked?

Documentation

TTSForFree MCP server

Connect

Claude (claude.ai, Desktop, mobile)

Claude Code

Cursor, VS Code and other clients

Claude API (MCP connector)

What you can ask

Tools (21)

Privacy and data

Support

Registry metadata