TTSForFree MCP
A remote MCP server that enables AI assistants to generate audio via text-to-speech, multi-voice podcasts, SRT-to-speech dubbing, and video localization. It supports voice browsing, custom voice design, and async job polling for high-quality audio generation in 100+ languages.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://api.ttsforfree.com/mcpWhat you can do with it
- Generate narration audio from text using single or multi-voice TTS
- Create synchronized dubbed audio tracks from SRT subtitle files
- Design custom AI voices or clone existing voices for branding
- Localize videos by generating dubbed audio tracks in multiple languages
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- ttsforfree 1.0.0
- MCP protocol
- 2025-06-18
- Tools
- 21 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- 4 advertised
{
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
21 advertised
list_languages — List languages
List every language supported by TTSForFree text-to-speech. Returns language codes to pass to list_voices.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"title": "List languages",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_voices — Find 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 or custom voices when they exist.
{
"type": "object",
"required": [
"language"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"description": "Optional keywords matched against name, style, persona and use case, e.g. 'warm narrator', 'news', 'young'."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"language": {
"type": "string",
"description": "Language code from list_languages, e.g. en, vi, es, ja."
},
"provider": {
"enum": [
"Google",
"Azure",
"Gemini",
"OpenAI",
"FPT"
],
"type": "string",
"description": "Optional voice engine filter. Gemini/OpenAI voices are the most expressive."
},
"only_usable": {
"type": "boolean",
"default": true,
"description": "Hide voices the current plan cannot use."
}
},
"additionalProperties": false
}{
"title": "Find voices",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_voice_details — Voice details
Get full metadata for one voice token: persona, use case, accent, pitch, styles, preview audio and credit cost.
{
"type": "object",
"required": [
"voice"
],
"properties": {
"voice": {
"type": "string",
"description": "Voice token (v1:...) from list_voices, favorites or custom voices."
}
},
"additionalProperties": false
}{
"title": "Voice details",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_my_custom_voices — 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.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"title": "My custom voices",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_favorite_voices — My 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.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"title": "My favorite voices",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}add_favorite_voice — Add favorite voice
Save a voice to the user's favorites (only when the user asks).
{
"type": "object",
"required": [
"voice"
],
"properties": {
"voice": {
"type": "string",
"description": "Voice token (v1:...) from list_voices."
}
},
"additionalProperties": false
}{
"title": "Add favorite voice",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}remove_favorite_voice — Remove favorite voice
Remove a voice from the user's favorites (only when the user asks).
{
"type": "object",
"required": [
"voice"
],
"properties": {
"voice": {
"type": "string",
"description": "Voice token (v1:...) from list_favorite_voices."
}
},
"additionalProperties": false
}{
"title": "Remove favorite voice",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}design_custom_voice — Design a 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.
{
"type": "object",
"required": [
"display_name",
"gender",
"language_code",
"prompt"
],
"properties": {
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 1500,
"minLength": 20,
"description": "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": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"language_code": {
"type": "string",
"description": "BCP-47 locale, e.g. en-US, vi-VN."
}
},
"additionalProperties": false
}{
"title": "Design a custom voice",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}get_account_status — 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.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"title": "Account status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}text_to_speech — 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.
{
"type": "object",
"required": [
"text",
"voice"
],
"properties": {
"text": {
"type": "string",
"minLength": 1,
"description": "Text to read. Plain text; long text is split and merged automatically."
},
"pitch": {
"type": "number",
"default": 0,
"maximum": 100,
"minimum": -100,
"description": "Only some providers support pitch."
},
"voice": {
"type": "string",
"description": "Voice token (v1:...)."
},
"wait_seconds": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 0,
"description": "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."
}
},
"additionalProperties": false
}{
"title": "Text to speech",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}multi_voice_to_speech — Multi-voice audio (podcast / dialogue)
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.
{
"type": "object",
"required": [
"segments"
],
"properties": {
"segments": {
"type": "array",
"items": {
"type": "object",
"required": [
"text",
"voice"
],
"properties": {
"text": {
"type": "string",
"minLength": 1
},
"speed": {
"type": "number",
"default": 1,
"maximum": 2.5,
"minimum": 0.5
},
"voice": {
"type": "string",
"description": "Voice token (v1:...)."
},
"volume": {
"type": "number",
"default": 1,
"maximum": 2,
"minimum": 0
},
"pause_after_ms": {
"type": "integer",
"default": 300,
"maximum": 10000,
"minimum": 0,
"description": "Silence after this segment."
}
},
"additionalProperties": false
},
"minItems": 1
},
"wait_seconds": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 0,
"description": "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."
}
},
"additionalProperties": false
}{
"title": "Multi-voice audio (podcast / dialogue)",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}srt_to_speech — Subtitles to speech (video voiceover / dubbing)
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.
{
"type": "object",
"properties": {
"srt": {
"type": "string",
"description": "Full SRT or WebVTT content."
},
"voice": {
"type": "string",
"description": "Default voice token for cues without a speaker/voice."
},
"segments": {
"type": "array",
"items": {
"type": "object",
"required": [
"text",
"start_ms",
"end_ms"
],
"properties": {
"text": {
"type": "string",
"minLength": 1
},
"speed": {
"type": "number",
"maximum": 2.5,
"minimum": 0.5
},
"voice": {
"type": "string",
"description": "Optional per-segment voice token; defaults to `voice`."
},
"end_ms": {
"type": "integer",
"minimum": 1
},
"start_ms": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"description": "Alternative to srt: timed segments."
},
"wait_seconds": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 0,
"description": "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": {
"type": "object",
"description": "Map speaker name -> voice token, e.g. {\"Host\": \"v1:...\", \"Guest\": \"v1:...\"}.",
"additionalProperties": {
"type": "string"
}
},
"max_speech_rate": {
"type": "number",
"default": 1.5,
"maximum": 2.5,
"minimum": 0.8,
"description": "Highest auto-fit speed when a cue is too short for its text."
},
"min_speech_rate": {
"type": "number",
"default": 0.95,
"maximum": 2.5,
"minimum": 0.8,
"description": "Lowest auto-fit speed. Set min = max for a fixed speed."
}
},
"additionalProperties": false
}{
"title": "Subtitles to speech (video voiceover / dubbing)",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}get_job_status — 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.
{
"type": "object",
"required": [
"job_id",
"job_type"
],
"properties": {
"job_id": {
"type": "integer",
"minimum": 1
},
"job_type": {
"enum": [
"single",
"multi",
"srt"
],
"type": "string",
"description": "single = text_to_speech, multi = multi_voice_to_speech, srt = srt_to_speech."
},
"wait_seconds": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 0,
"description": "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."
}
},
"additionalProperties": false
}{
"title": "Job status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_recent_jobs — Recent jobs
List the user's most recent speech jobs with status and audio URLs, to reuse earlier audio instead of paying again.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1
},
"job_type": {
"enum": [
"single",
"multi",
"srt"
],
"type": "string",
"default": "single"
}
},
"additionalProperties": false
}{
"title": "Recent jobs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_job_detail — Job segments (for Remotion / editors)
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).
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}{
"title": "Job segments (for Remotion / editors)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}create_upload_url — Upload a video/audio file
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.
{
"type": "object",
"required": [
"file_name"
],
"properties": {
"file_name": {
"type": "string",
"description": "Original file name with extension, e.g. lesson-01.mp4"
},
"file_size_bytes": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}{
"title": "Upload a video/audio file",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}transcribe_media — Transcribe video/audio to SRT
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.
{
"type": "object",
"required": [
"media_url",
"language"
],
"properties": {
"language": {
"type": "string",
"description": "Spoken language code, e.g. vi, en, ja."
},
"media_url": {
"type": "string",
"description": "public_url from create_upload_url (or a ttsforfree CDN link)."
},
"wait_seconds": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 0,
"description": "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."
}
},
"additionalProperties": false
}{
"title": "Transcribe video/audio to SRT",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}get_transcription — Transcription status
Check a transcribe_media job and get its SRT once finished.
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "integer",
"minimum": 1
},
"wait_seconds": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 0,
"description": "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."
}
},
"additionalProperties": false
}{
"title": "Transcription status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}estimate_video_localization — Estimate video dubbing cost
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.
{
"type": "object",
"required": [
"source_language",
"targets"
],
"properties": {
"targets": {
"type": "array",
"items": {
"type": "object",
"required": [
"language",
"voice"
],
"properties": {
"voice": {
"type": "string",
"description": "Voice token (v1:...) for that language from list_voices / favorites / custom voices."
},
"language": {
"type": "string",
"description": "Target language code, e.g. en, es, ja."
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1,
"description": "One entry per target language (the server allows 10 per job by default)."
},
"video_url": {
"type": "string"
},
"source_language": {
"type": "string"
},
"duration_seconds": {
"type": "number",
"minimum": 1
}
},
"additionalProperties": false
}{
"title": "Estimate video dubbing cost",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}localize_video — Dub a video into other languages
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.
{
"type": "object",
"required": [
"video_url",
"source_language",
"targets"
],
"properties": {
"targets": {
"type": "array",
"items": {
"type": "object",
"required": [
"language",
"voice"
],
"properties": {
"voice": {
"type": "string",
"description": "Voice token (v1:...) for that language from list_voices / favorites / custom voices."
},
"language": {
"type": "string",
"description": "Target language code, e.g. en, es, ja."
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1,
"description": "One entry per target language (the server allows 10 per job by default)."
},
"video_url": {
"type": "string",
"description": "public_url from create_upload_url."
},
"source_language": {
"type": "string",
"description": "Spoken language of the video, e.g. vi."
},
"original_audio_volume_percent": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Keep the original sound (music/effects) under the new voice at this volume in the dubbed video. 0 = remove."
}
},
"additionalProperties": false
}{
"title": "Dub a video into other languages",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}get_localization_status — Video dubbing status
Status of localize_video jobs: current step, and when Completed the dubbed audio_url, final_video_url and translated SRT for each language.
{
"type": "object",
"required": [
"job_guids"
],
"properties": {
"job_guids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1
},
"wait_seconds": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 0,
"description": "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."
}
},
"additionalProperties": false
}{
"title": "Video dubbing status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
4 advertised
video_voiceover — Voiceover a video
Write or translate subtitles for a video and generate a timed voiceover track, then give ffmpeg commands to merge it.
- target_language
- Language of the voiceover, e.g. English, Vietnamese. (required)
- voice_style
- Optional voice style, e.g. 'calm male narrator', 'energetic female YouTuber'.
- keep_original_audio
- yes = keep the original sound under the voiceover (ducked), no = replace it.
youtube_multi_language_audio — Dub a YouTube video into many languages
Turn one video into dubbed audio tracks for YouTube multi-language audio (and dubbed videos).
- languages
- Target languages, e.g. 'English, Spanish, Japanese'. (required)
- source_language
- Language spoken in the video (optional, ask if unknown).
- voice_style
- Optional voice style for every language, e.g. 'friendly male presenter'.
podcast_episode — Create a podcast episode
Turn a topic or article into a multi-speaker podcast script and render it as one MP3.
- topic
- Topic, article text or URL summary to discuss. (required)
- language
- Language of the episode.
- speakers
- Number or names of hosts, e.g. 'Anna and Minh'.
narrate_text — Narrate text
Read a text aloud with the best matching voice and return the MP3 link.
- text
- Text to narrate. (required)
- language
- Language of the text (optional, detected if empty).
- voice_style
- Optional style, e.g. 'audiobook', 'news anchor'.
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 5834 ms
- 95th percentile latency
- 5834 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 5834 ms · metadata changed · 21 tool(s), 4 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http ttsforfree-mcp https://api.ttsforfree.com/mcpCodex
codex mcp add ttsforfree-mcp --url https://api.ttsforfree.com/mcpCursor
{
"mcpServers": {
"ttsforfree-mcp": {
"url": "https://api.ttsforfree.com/mcp"
}
}
}Cline
{
"mcpServers": {
"ttsforfree-mcp": {
"type": "streamableHttp",
"url": "https://api.ttsforfree.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"ttsforfree-mcp": {
"type": "http",
"url": "https://api.ttsforfree.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http ttsforfree-mcp https://api.ttsforfree.com/mcpClaude Desktop
{
"mcpServers": {
"ttsforfree-mcp": {
"url": "https://api.ttsforfree.com/mcp"
}
}
}Windsurf
{
"mcpServers": {
"ttsforfree-mcp": {
"serverUrl": "https://api.ttsforfree.com/mcp"
}
}
}Let your agent find its tools
Find servers like TTSForFree MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.