text_to_speech
Convert text into spoken audio in 31 languages. Automatically chunks long text and supports configurable output modes.
Instructions
Generate natural-sounding speech audio from text. Use this when the user wants to: hear text read aloud, create narration or voiceover, generate voice audio, preview how text sounds when spoken, or convert any writing into spoken audio. Supports 31 languages including Korean, English, and Japanese. There is no text-length limit: long text is automatically split (auto-chunked) by the service, and credit usage and latency scale with the length of the text. Set output_mode ('files', 'resources', or 'both') to control how audio is returned, and autoplay=true to play it back on macOS. These per-call parameters REPLACE the removed SUPERTONE_MCP_OUTPUT_MODE and SUPERTONE_MCP_AUTOPLAY environment variables; autoplay now defaults to false. A default voice is already configured -- just call this tool directly. Only call search_voice if the user explicitly asks to change or browse voices.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| model | No | ||
| speed | No | ||
| style | No | ||
| autoplay | No | ||
| language | No | ||
| voice_id | No | ||
| streaming | No | When true, stream the audio via the chunked synthesize path instead of a single one-shot request. Streaming is ONLY supported by model=sona_speech_1; using streaming=true with any other model returns a validation error. Defaults to false (one-shot synthesize). | |
| output_mode | No | ||
| pitch_shift | No | ||
| output_format | No | ||
| normalized_text | No | Optional pre-normalized text to use for synthesis (SDK 0.2.3). Only applies to the sona_speech_2 and sona_speech_2_flash models; other models ignore it. When omitted, the SDK default (None) is used. | |
| include_phonemes | No | When true, request phoneme timing data alongside the audio (SDK 0.2.3). Defaults to false. Note: the phoneme data is not yet surfaced in the tool response — this is a pass-through flag for now. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |