list_agents
Read-only
List all available conversational AI agents in your ElevenLabs account for easy management and selection.
Instructions
List all available conversational AI agents
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| text | Yes | ||
| annotations | No | ||
| _meta | No |
Implementation Reference
- elevenlabs_mcp/server.py:739-742 (registration)MCP tool registration for list_agents using FastMCP's @tool decorator with read-only hint and description
@mcp.tool( annotations=ToolAnnotations(readOnlyHint=True, openWorldHint=True), description="List all available conversational AI agents" ) - elevenlabs_mcp/server.py:743-758 (handler)Handler function that calls ElevenLabs conversational_ai.agents.list() API and formats the agent names/IDs into a comma-separated list, returning a TextContent response
def list_agents() -> TextContent: """List all available conversational AI agents. Returns: TextContent with a formatted list of available agents """ response = client.conversational_ai.agents.list() if not response.agents: return TextContent(type="text", text="No agents found.") agent_list = ",".join( f"{agent.name} (ID: {agent.agent_id})" for agent in response.agents ) return TextContent(type="text", text=f"Available agents: {agent_list}")