TTSForFree
Server Details
Generate AI voices, text-to-speech, subtitles, transcription, and video localization.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- CalmNguyen/ttsforfree-mcp
- GitHub Stars
- 0
TDQS
Score is being calculated.
Available Tools
21 toolsadd_favorite_voiceAdd favorite voiceIdempotentInspect
Save a voice to the user's favorites (only when the user asks).
| Name | Required | Description | Default |
|---|---|---|---|
| voice | Yes | Voice token (v1:...) from list_voices. |
create_upload_urlUpload a video/audio fileInspect
Get a one-time URL to upload a local video or audio file (mp4, mov, webm, mkv, mp3, wav, m4a...) up to 2 GB. Upload with HTTP PUT of the raw bytes, e.g. curl -T video.mp4 "<upload_url>" (valid 15 minutes), then pass public_url to transcribe_media or localize_video. Only files uploaded here (or on ttsforfree.com) are accepted; YouTube and other external links are never downloaded. If you cannot run commands, ask the user to upload the file on https://ttsforfree.com/en/video-localization/ and paste the file link.
| Name | Required | Description | Default |
|---|---|---|---|
| file_name | Yes | Original file name with extension, e.g. lesson-01.mp4 | |
| file_size_bytes | No |
design_custom_voiceDesign a custom voiceInspect
Create a new personal AI voice from a natural-language description (Gemini Voice Design). Uses one slot of the user's custom-voice quota - confirm with the user first. Good for a unique narrator or a character voice in a video/podcast. Returns the new voice token.
| Name | Required | Description | Default |
|---|---|---|---|
| gender | Yes | ||
| prompt | Yes | Describe age, accent, timbre, personality, energy and pace. Example: 'Calm male documentary narrator in his 40s, deep warm timbre, slow confident pace, neutral American accent.' | |
| display_name | Yes | ||
| language_code | Yes | BCP-47 locale, e.g. en-US, vi-VN. |
estimate_video_localizationEstimate video dubbing costRead-onlyIdempotentInspect
Estimate the credits to dub one video into one or more languages (speech-to-text + translation + voice + video merge) before running localize_video. Pass video_url (duration is measured) or duration_seconds.
| Name | Required | Description | Default |
|---|---|---|---|
| targets | Yes | One entry per target language (the server allows 10 per job by default). | |
| video_url | No | ||
| source_language | Yes | ||
| duration_seconds | No |
get_account_statusAccount statusRead-onlyInspect
Show the user's plan tier, remaining characters/credits, max characters per request, max blocks per multi-voice/SRT job and API rate limits. Call before large jobs.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
get_job_detailJob segments (for Remotion / editors)Read-onlyIdempotentInspect
Get a multi_voice_to_speech or srt_to_speech job with every segment: text, voice and its own audio_url, plus the merged audio. Use it to build captions or a Remotion/NLE timeline (one per segment; measure each file's duration in the renderer).
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes |
get_job_statusJob statusRead-onlyIdempotentInspect
Check a speech job created earlier. Returns status (PENDING | SUCCESS | ERROR) and audio_url once SUCCESS. Never guess or fetch an audio URL before SUCCESS.
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | ||
| job_type | Yes | single = text_to_speech, multi = multi_voice_to_speech, srt = srt_to_speech. | |
| wait_seconds | No | Seconds the server waits for the audio before returning. If the job is still PENDING, call get_job_status later with the returned job_id. |
get_localization_statusVideo dubbing statusRead-onlyIdempotentInspect
Status of localize_video jobs: current step, and when Completed the dubbed audio_url, final_video_url and translated SRT for each language.
| Name | Required | Description | Default |
|---|---|---|---|
| job_guids | Yes | ||
| wait_seconds | No | Seconds the server waits for the audio before returning. If the job is still PENDING, call get_job_status later with the returned job_id. |
get_transcriptionTranscription statusRead-onlyIdempotentInspect
Check a transcribe_media job and get its SRT once finished.
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | ||
| wait_seconds | No | Seconds the server waits for the audio before returning. If the job is still PENDING, call get_job_status later with the returned job_id. |
get_voice_detailsVoice detailsRead-onlyIdempotentInspect
Get full metadata for one voice token: persona, use case, accent, pitch, styles, preview audio and credit cost.
| Name | Required | Description | Default |
|---|---|---|---|
| voice | Yes | Voice token (v1:...) from list_voices, favorites or custom voices. |
list_favorite_voicesMy favorite voicesRead-onlyIdempotentInspect
List the voices the user marked as favorites, in their saved order. Check this first when the user did not name a voice.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_languagesList languagesRead-onlyIdempotentInspect
List every language supported by TTSForFree text-to-speech. Returns language codes to pass to list_voices.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_my_custom_voicesMy custom voicesRead-onlyIdempotentInspect
List the user's personal voices created with Voice Design (from a text prompt) or Voice Clone (from an audio sample), plus the remaining custom-voice quota. Use voice from the result in any speech tool.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_recent_jobsRecent jobsRead-onlyIdempotentInspect
List the user's most recent speech jobs with status and audio URLs, to reuse earlier audio instead of paying again.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| job_type | No | single |
list_voicesFind voicesRead-onlyIdempotentInspect
Search the AI voice catalog for one language. Each result has a voice token (v1:...) - pass it unchanged as voice to text_to_speech, multi_voice_to_speech or srt_to_speech. Results are sorted by popularity; can_use=false means the user's plan cannot use that voice. Prefer the user's favorite or custom voices when they exist.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | Optional keywords matched against name, style, persona and use case, e.g. 'warm narrator', 'news', 'young'. | |
| gender | No | ||
| language | Yes | Language code from list_languages, e.g. en, vi, es, ja. | |
| provider | No | Optional voice engine filter. Gemini/OpenAI voices are the most expressive. | |
| only_usable | No | Hide voices the current plan cannot use. |
localize_videoDub a video into other languagesInspect
Full automatic dubbing of an uploaded video: transcribe once, translate, voice every target language with its own voice and render a dubbed video per language. Each language returns an audio_url (voice track aligned to the original timeline - upload it to YouTube Studio as a multi-language audio track) and a final_video_url. Takes several minutes: returns job_guids immediately; poll get_localization_status. Confirm the cost with estimate_video_localization for long videos.
| Name | Required | Description | Default |
|---|---|---|---|
| targets | Yes | One entry per target language (the server allows 10 per job by default). | |
| video_url | Yes | public_url from create_upload_url. | |
| source_language | Yes | Spoken language of the video, e.g. vi. | |
| original_audio_volume_percent | No | Keep the original sound (music/effects) under the new voice at this volume in the dubbed video. 0 = remove. |
multi_voice_to_speechMulti-voice audio (podcast / dialogue)Inspect
Render ordered segments, each with its own voice, into ONE merged MP3. Use for podcasts, dialogues, interviews, audio dramas or explainer videos with several speakers when there are no fixed timestamps. Consumes credits.
| Name | Required | Description | Default |
|---|---|---|---|
| segments | Yes | ||
| wait_seconds | No | Seconds the server waits for the audio before returning. If the job is still PENDING, call get_job_status later with the returned job_id. |
remove_favorite_voiceRemove favorite voiceDestructiveIdempotentInspect
Remove a voice from the user's favorites (only when the user asks).
| Name | Required | Description | Default |
|---|---|---|---|
| voice | Yes | Voice token (v1:...) from list_favorite_voices. |
srt_to_speechSubtitles to speech (video voiceover / dubbing)Inspect
Create ONE MP3 that follows a subtitle timeline: every cue starts at its timestamp and speech speed auto-fits the cue duration. Use for video voiceover, dubbing translated subtitles, YouTube localization, tutorials and any edit where audio must line up with existing video. Pass either raw srt (SRT or WebVTT text) or segments with start_ms/end_ms. For several speakers set speaker_voices and prefix cue text with '[Name]' or 'Name:'. The resulting MP3 starts at 00:00 of the video, so it can be muxed directly with ffmpeg (commands are returned). Consumes credits.
| Name | Required | Description | Default |
|---|---|---|---|
| srt | No | Full SRT or WebVTT content. | |
| voice | No | Default voice token for cues without a speaker/voice. | |
| segments | No | Alternative to srt: timed segments. | |
| wait_seconds | No | Seconds the server waits for the audio before returning. If the job is still PENDING, call get_job_status later with the returned job_id. | |
| speaker_voices | No | Map speaker name -> voice token, e.g. {"Host": "v1:...", "Guest": "v1:..."}. | |
| max_speech_rate | No | Highest auto-fit speed when a cue is too short for its text. | |
| min_speech_rate | No | Lowest auto-fit speed. Set min = max for a fixed speed. |
text_to_speechText to speechInspect
Convert one text into one MP3 with one voice. Use for narration, voiceover scripts, articles, lessons, announcements or any audio whose length can follow the speech. Consumes credits (characters x voice rate). Returns job_id, status and audio_url when ready.
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Text to read. Plain text; long text is split and merged automatically. | |
| pitch | No | Only some providers support pitch. | |
| voice | Yes | Voice token (v1:...). | |
| wait_seconds | No | Seconds the server waits for the audio before returning. If the job is still PENDING, call get_job_status later with the returned job_id. |
transcribe_mediaTranscribe video/audio to SRTInspect
Speech-to-text for an uploaded video or audio file: returns timestamped SRT (the timeline to rewrite, translate or re-voice with srt_to_speech). Credits are charged per second of media, measured by the server. Use language = the spoken language code from list_languages.
| Name | Required | Description | Default |
|---|---|---|---|
| language | Yes | Spoken language code, e.g. vi, en, ja. | |
| media_url | Yes | public_url from create_upload_url (or a ttsforfree CDN link). | |
| wait_seconds | No | Seconds the server waits for the audio before returning. If the job is still PENDING, call get_job_status later with the returned job_id. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
21 tool updates
- First observed
add_favorite_voice - First observed
create_upload_url - First observed
design_custom_voice - First observed
estimate_video_localization - First observed
get_account_status - First observed
get_job_detail - First observed
get_job_status - First observed
get_localization_status - First observed
get_transcription - First observed
get_voice_details - First observed
list_favorite_voices - First observed
list_languages - First observed
list_my_custom_voices - First observed
list_recent_jobs - First observed
list_voices - First observed
localize_video - First observed
multi_voice_to_speech - First observed
remove_favorite_voice - First observed
srt_to_speech - First observed
text_to_speech - First observed
transcribe_media
Related MCP Connectors
Natural AI voiceovers: search 500+ voices, generate speech, design and save custom voices.
Transcribe, subtitle and dub videos into 100+ languages, and translate text.
Transcribe, subtitle, dub and lip-sync media; create speech, voices, images and thumbnails.
Text to speech and transcription for any AI model: MP3 voiceovers, audio and YouTube to text.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI-powered translation of YouTube videos into localized versions with synthesized voiceovers and avatar videos. Supports the full content pipeline from transcript extraction and translation to video generation and publishing across social platforms.-
- AlicenseNot gradedqualityBmaintenanceGenerates coherent mixed audio scenes (speech, music, SFX, ambience) from text using an LLM-driven model, with speech in 9 languages and emotion control.2Apache 2.0
- AlicenseAqualityBmaintenanceDiscover audio and LLM services, compare seven voices, and check prices for free. Generate speech, transcribe audio and request LLM text with optional capped USDC payments on Base; voice-cloning requirements are also available.61MIT

audio.ditto/ttsofficial
FlicenseNot gradedqualityCmaintenanceEnables AI clients to browse voices and languages and synthesize text into downloadable audio links, including batch jobs of up to 1,000 texts.1-
Glama MCP Gateway
Add one secure layer between your agents and this server.