Voice Mode Tools Reference¶
Voice Mode provides several tools through the Model Context Protocol (MCP) for voice interactions.
Available Tools¶
converse¶
Have a voice conversation - speak a message and optionally listen for response.
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
message | string | required | The message to speak |
wait_for_response | boolean | true | Whether to listen for a response after speaking |
listen_duration | number | 30.0 | Maximum time to listen for response in seconds |
min_listen_duration | number | 1.0 | Minimum time to record before silence detection can stop |
transport | string | "auto" | Transport method: "auto", "local", or "livekit" |
voice | string | auto | TTS voice override (e.g., "nova", "alloy", "af_sky") |
tts_provider | string | auto | TTS provider: "openai" or "kokoro" |
tts_model | string | auto | TTS model (e.g., "tts-1", "tts-1-hd", "gpt-4o-mini-tts") |
tts_instructions | string | none | Tone/style instructions for gpt-4o-mini-tts model |
Example:
listen_for_speech¶
Listen for speech and convert to text.
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
duration | number | 5.0 | How long to listen in seconds |
min_listen_duration | number | 1.0 | Minimum time to record before silence detection |
check_room_status¶
Check LiveKit room status and participants.
Parameters: None
check_audio_devices¶
List available audio input and output devices.
Parameters: None
voice_status¶
Check the status of all voice services including TTS, STT, LiveKit, and audio devices.
Parameters: None
kokoro_start¶
Start the Kokoro TTS service.
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
models_dir | string | ~/Models/kokoro | Path to Kokoro models directory |
kokoro_stop¶
Stop the Kokoro TTS service.
Parameters: None
kokoro_status¶
Check the status of Kokoro TTS service.
Parameters: None
Voice Statistics Tools¶
voice_statistics¶
Display live statistics dashboard for voice conversation performance.
Parameters: None
voice_statistics_summary¶
Get a concise summary of voice conversation performance metrics.
Parameters: None
voice_statistics_recent¶
Show recent voice conversation interactions with timing details.
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | integer | 10 | Maximum number of recent interactions (max: 50) |
voice_statistics_reset¶
Reset all voice conversation statistics and start a new session.
Parameters: None
voice_statistics_export¶
Export detailed voice conversation statistics as JSON data.
Parameters: None