io.github.CalmNguyen/ttsforfree · v1.0.0 · ai-and-media
TTSForFree is healthy: it completed an MCP handshake in 1377 ms and exposes 21 tools.
Generate AI voices, text-to-speech, subtitles, transcription, and video localization.
Endpoint: https://api.ttsforfree.com/mcp (streamable-http)
Repository · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 21 |
| Latency | 1377 ms |
| Last checked (UTC) | 2026-10-22T22:55:17.299Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-22T22:55:17.299Z | Healthy | 1377 |
list_languages | List every language supported by TTSForFree text-to-speech. Returns language codes to pass to list_voices. |
list_voices | 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 o |
get_voice_details | Get full metadata for one voice token: persona, use case, accent, pitch, styles, preview audio and credit cost. |
list_my_custom_voices | 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. |
list_favorite_voices | List the voices the user marked as favorites, in their saved order. Check this first when the user did not name a voice. |
add_favorite_voice | Save a voice to the user's favorites (only when the user asks). |
remove_favorite_voice | Remove a voice from the user's favorites (only when the user asks). |
design_custom_voice | 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. |
get_account_status | 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. |
text_to_speech | 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. |
multi_voice_to_speech | 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. |
srt_to_speech | 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 |
get_job_status | 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. |
list_recent_jobs | List the user's most recent speech jobs with status and audio URLs, to reuse earlier audio instead of paying again. |
get_job_detail | 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 <Sequence> per segment; measure each file's duration in the renderer). |
create_upload_url | 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 o |
transcribe_media | 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. |
get_transcription | Check a transcribe_media job and get its SRT once finished. |
estimate_video_localization | 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. |
localize_video | 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 tra |
get_localization_status | Status of localize_video jobs: current step, and when Completed the dubbed audio_url, final_video_url and translated SRT for each language. |