MCP server for text-to-speech conversion using Kokoro TTS
Four tools with complete schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. Tool naming is clear and action-oriented (text_to_speech, list_voices, get_model_status). Descriptions are present but brief (10-50 chars for some). Critical issue: no output schemas documented for any tool, LLMs cannot plan downstream calls or extract structured data. Parameters lack descriptions for optional fields (voice parameter in both TTS tools has no guidance on valid values or defaults). Error handling is minimal, no recovery guidance or actionable error messages visible in tool definitions.
Get the current status of the TTS model initialization
List all available voices for text-to-speech
Convert text to speech and play it through system audio
Convert text to speech with customizable speed
No output schemas documented for any tool. LLMs cannot infer what fields are returned, breaking downstream tool chaining and forcing agents to guess at response structure.
Optional 'voice' parameter in text_to_speech and text_to_speech_with_options lacks description. No guidance on valid values, defaults, or how to discover available voices. LLMs will guess or pass invalid values.
Tool descriptions are too brief (10-50 chars). 'List all available voices for text-to-speech' and 'Get the current status of the TTS model initialization' lack context on WHEN to call these tools or what to do with results.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | 2026-07-28+ | v2 |
No error handling guidance in tool definitions. Code shows retry logic and initialization errors, but tool descriptions do not explain failure modes or recovery steps to LLMs.
text_to_speech and text_to_speech_with_options both perform the same core action (TTS synthesis and playback). The distinction is only the speed parameter. Consider consolidating into one tool with optional speed, or clarify in descriptions when to use each.