get_agent
Read-only
Retrieve detailed information about a specific conversational AI agent by providing its agent ID. Access configuration, capabilities, and metadata to manage or integrate the agent.
Instructions
Get details about a specific conversational AI agent
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| text | Yes | ||
| annotations | No | ||
| _meta | No |
Implementation Reference
- elevenlabs_mcp/server.py:761-783 (handler)Handler function that executes the 'get_agent' tool logic. It calls the ElevenLabs conversational AI API to get agent details by ID, extracts voice configuration info, and returns a formatted TextContent response with agent name, ID, voice config, and creation timestamp.
@mcp.tool( annotations=ToolAnnotations(readOnlyHint=True, openWorldHint=True), description="Get details about a specific conversational AI agent" ) def get_agent(agent_id: str) -> TextContent: """Get details about a specific conversational AI agent. Args: agent_id: The ID of the agent to retrieve Returns: TextContent with detailed information about the agent """ response = client.conversational_ai.agents.get(agent_id=agent_id) voice_info = "None" if response.conversation_config.tts: voice_info = f"Voice ID: {response.conversation_config.tts.voice_id}" return TextContent( type="text", text=f"Agent Details: Name: {response.name}, Agent ID: {response.agent_id}, Voice Configuration: {voice_info}, Created At: {datetime.fromtimestamp(response.metadata.created_at_unix_secs).strftime('%Y-%m-%d %H:%M:%S')}", ) - elevenlabs_mcp/server.py:761-763 (registration)Registration of 'get_agent' as an MCP tool via the @mcp.tool decorator on the FastMCP instance, with read-only and open-world hints.
@mcp.tool( annotations=ToolAnnotations(readOnlyHint=True, openWorldHint=True), description="Get details about a specific conversational AI agent"