get_voice
Read-only
Retrieve detailed information about a specific voice, including characteristics and settings, by providing its unique voice ID.
Instructions
Get details of a specific voice
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| voice_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| name | Yes | ||
| category | Yes | ||
| fine_tuning_status | No |
Implementation Reference
- elevenlabs_mcp/server.py:508-520 (handler)The 'get_voice' tool function decorated with @mcp.tool. Calls client.voices.get(voice_id) and returns an McpVoice model with id, name, category, and fine_tuning_status.
@mcp.tool( annotations=ToolAnnotations(readOnlyHint=True, openWorldHint=True), description="Get details of a specific voice" ) def get_voice(voice_id: str) -> McpVoice: """Get details of a specific voice.""" response = client.voices.get(voice_id=voice_id) return McpVoice( id=response.voice_id, name=response.name, category=response.category, fine_tuning_status=response.fine_tuning.state, ) - elevenlabs_mcp/model.py:5-9 (schema)The McpVoice Pydantic model used as the return type schema for get_voice.
class McpVoice(BaseModel): id: str name: str category: str fine_tuning_status: Optional[Dict] = None - elevenlabs_mcp/server.py:508-511 (registration)Tool registration via @mcp.tool decorator with annotations and description.
@mcp.tool( annotations=ToolAnnotations(readOnlyHint=True, openWorldHint=True), description="Get details of a specific voice" ) - elevenlabs_mcp/server.py:31-32 (helper)Import of McpVoice model into server.py for the get_voice handler.
from elevenlabs_mcp.model import McpVoice, McpModel, McpLanguage from elevenlabs_mcp.utils import (