VOICEVOX TTS MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VOICEVOX_URL | No | VOICEVOX Engine URL | http://localhost:50021 |
| MCP_HTTP_HOST | No | HTTP host | 0.0.0.0 |
| MCP_HTTP_MODE | No | Enable HTTP mode | false |
| MCP_HTTP_PORT | No | HTTP port | 3000 |
| MCP_ALLOWED_HOSTS | No | Allowed hosts (comma-separated) | localhost,127.0.0.1,[::1] |
| MCP_ALLOWED_ORIGINS | No | Allowed origins (comma-separated) | http://localhost,http://127.0.0.1 |
| VOICEVOX_USE_STREAMING | No | Streaming playback (requires ffplay) | false |
| VOICEVOX_DISABLED_TOOLS | No | Comma-separated list of tools to disable (e.g., generate_query,synthesize_file) | |
| VOICEVOX_DEFAULT_SPEAKER | No | Default speaker ID | 1 |
| VOICEVOX_DEFAULT_IMMEDIATE | No | Immediate playback default setting | true |
| VOICEVOX_RESTRICT_IMMEDIATE | No | Restrict AI from specifying the immediate option | |
| VOICEVOX_DEFAULT_SPEED_SCALE | No | Default playback speed | 1.0 |
| VOICEVOX_DEFAULT_WAIT_FOR_END | No | Wait for playback end default setting | false |
| VOICEVOX_RESTRICT_WAIT_FOR_END | No | Restrict AI from specifying the waitForEnd option | |
| VOICEVOX_DEFAULT_WAIT_FOR_START | No | Wait for playback start default setting | false |
| VOICEVOX_RESTRICT_WAIT_FOR_START | No | Restrict AI from specifying the waitForStart option |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ping_voicevoxB | Check if VOICEVOX Engine is running and reachable |
| speakA | Convert text to speech and play it. Text is split by line breaks (\n) into separate speech units. Each line is processed as an independent audio segment. |
| generate_queryC | Generate a query for voice synthesis |
| synthesize_fileC | Generate an audio file and return its absolute path |
| stop_speakerA | Stop current audio playback |
| get_speakersC | Get a list of available speakers |
| get_speaker_detailC | Get detail of a speaker by id |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose with no overlap: generate_query creates synthesis queries, get_speaker_detail and get_speakers handle speaker metadata, ping_voicevox checks engine status, speak plays audio, stop_speaker stops playback, and synthesize_file creates files. The descriptions make it easy to distinguish between query generation, metadata retrieval, status checking, real-time playback control, and file synthesis.
The naming is mostly consistent with a verb_noun pattern (e.g., get_speakers, stop_speaker, synthesize_file), but there are minor deviations: generate_query uses 'generate' instead of a more specific verb like 'create', and ping_voicevox uses 'ping' as a verb which is less conventional but still understandable. All tools use snake_case consistently.
With 7 tools, this server is well-scoped for a TTS system. It covers essential operations like checking engine status, retrieving speaker information, generating queries, real-time speech playback with control, and file synthesis. Each tool earns its place without feeling excessive or insufficient for the domain.
The tool set provides complete coverage for a TTS domain: it includes status checking (ping_voicevox), metadata retrieval (get_speakers, get_speaker_detail), query preparation (generate_query), real-time audio handling (speak, stop_speaker), and file output (synthesize_file). There are no obvious gaps—agents can perform the full lifecycle from setup to synthesis and playback control.