elevenlabs-voice-agent-mcp 1.0.0

package/dist/tools/agent-tools.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Agent management tools
+ *
+ * MCP tools for creating, retrieving, updating, deleting, and listing voice agents.
+ */
+import { z } from "zod";
+import { ResponseFormat } from "../types.js";
+/**
+ * Creates a new ElevenLabs Voice Agent
+ */
+export declare const elevenlabs_create_agent: {
+    name: string;
+    description: string;
+    zodSchema: z.ZodObject<{
+        name: z.ZodString;
+        prompt: z.ZodString;
+        llm: z.ZodDefault<z.ZodEnum<["gpt-4o", "gpt-4o-mini", "claude-3-5-sonnet-20241022", "claude-3-5-haiku-20241022", "gemini-2.0-flash-exp"]>>;
+        voice_id: z.ZodDefault<z.ZodString>;
+        voice_model: z.ZodDefault<z.ZodEnum<["eleven_turbo_v2_5", "eleven_flash_v2_5", "eleven_multilingual_v2"]>>;
+        first_message: z.ZodOptional<z.ZodString>;
+        language: z.ZodDefault<z.ZodEnum<["en", "es", "fr", "de", "it", "pt", "pl", "nl", "ja", "zh", "ko", "ar", "hi"]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        stability: z.ZodOptional<z.ZodNumber>;
+        similarity_boost: z.ZodOptional<z.ZodNumber>;
+        widget_color: z.ZodOptional<z.ZodString>;
+        widget_avatar_url: z.ZodOptional<z.ZodString>;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        name: z.ZodString;
+        prompt: z.ZodString;
+        llm: z.ZodDefault<z.ZodEnum<["gpt-4o", "gpt-4o-mini", "claude-3-5-sonnet-20241022", "claude-3-5-haiku-20241022", "gemini-2.0-flash-exp"]>>;
+        voice_id: z.ZodDefault<z.ZodString>;
+        voice_model: z.ZodDefault<z.ZodEnum<["eleven_turbo_v2_5", "eleven_flash_v2_5", "eleven_multilingual_v2"]>>;
+        first_message: z.ZodOptional<z.ZodString>;
+        language: z.ZodDefault<z.ZodEnum<["en", "es", "fr", "de", "it", "pt", "pl", "nl", "ja", "zh", "ko", "ar", "hi"]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        stability: z.ZodOptional<z.ZodNumber>;
+        similarity_boost: z.ZodOptional<z.ZodNumber>;
+        widget_color: z.ZodOptional<z.ZodString>;
+        widget_avatar_url: z.ZodOptional<z.ZodString>;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        name: z.ZodString;
+        prompt: z.ZodString;
+        llm: z.ZodDefault<z.ZodEnum<["gpt-4o", "gpt-4o-mini", "claude-3-5-sonnet-20241022", "claude-3-5-haiku-20241022", "gemini-2.0-flash-exp"]>>;
+        voice_id: z.ZodDefault<z.ZodString>;
+        voice_model: z.ZodDefault<z.ZodEnum<["eleven_turbo_v2_5", "eleven_flash_v2_5", "eleven_multilingual_v2"]>>;
+        first_message: z.ZodOptional<z.ZodString>;
+        language: z.ZodDefault<z.ZodEnum<["en", "es", "fr", "de", "it", "pt", "pl", "nl", "ja", "zh", "ko", "ar", "hi"]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        stability: z.ZodOptional<z.ZodNumber>;
+        similarity_boost: z.ZodOptional<z.ZodNumber>;
+        widget_color: z.ZodOptional<z.ZodString>;
+        widget_avatar_url: z.ZodOptional<z.ZodString>;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    handler: (args: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Retrieves an agent by ID
+ */
+export declare const elevenlabs_get_agent: {
+    name: string;
+    description: string;
+    zodSchema: z.ZodObject<{
+        agent_id: z.ZodString;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        agent_id: z.ZodString;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        agent_id: z.ZodString;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    handler: (args: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Updates an existing agent
+ */
+export declare const elevenlabs_update_agent: {
+    name: string;
+    description: string;
+    zodSchema: z.ZodObject<{
+        agent_id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+        llm: z.ZodOptional<z.ZodEnum<["gpt-4o", "gpt-4o-mini", "claude-3-5-sonnet-20241022", "claude-3-5-haiku-20241022", "gemini-2.0-flash-exp"]>>;
+        voice_id: z.ZodOptional<z.ZodString>;
+        voice_model: z.ZodOptional<z.ZodEnum<["eleven_turbo_v2_5", "eleven_flash_v2_5", "eleven_multilingual_v2"]>>;
+        first_message: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodEnum<["en", "es", "fr", "de", "it", "pt", "pl", "nl", "ja", "zh", "ko", "ar", "hi"]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        stability: z.ZodOptional<z.ZodNumber>;
+        similarity_boost: z.ZodOptional<z.ZodNumber>;
+        widget_color: z.ZodOptional<z.ZodString>;
+        widget_avatar_url: z.ZodOptional<z.ZodString>;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        agent_id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+        llm: z.ZodOptional<z.ZodEnum<["gpt-4o", "gpt-4o-mini", "claude-3-5-sonnet-20241022", "claude-3-5-haiku-20241022", "gemini-2.0-flash-exp"]>>;
+        voice_id: z.ZodOptional<z.ZodString>;
+        voice_model: z.ZodOptional<z.ZodEnum<["eleven_turbo_v2_5", "eleven_flash_v2_5", "eleven_multilingual_v2"]>>;
+        first_message: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodEnum<["en", "es", "fr", "de", "it", "pt", "pl", "nl", "ja", "zh", "ko", "ar", "hi"]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        stability: z.ZodOptional<z.ZodNumber>;
+        similarity_boost: z.ZodOptional<z.ZodNumber>;
+        widget_color: z.ZodOptional<z.ZodString>;
+        widget_avatar_url: z.ZodOptional<z.ZodString>;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        agent_id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+        llm: z.ZodOptional<z.ZodEnum<["gpt-4o", "gpt-4o-mini", "claude-3-5-sonnet-20241022", "claude-3-5-haiku-20241022", "gemini-2.0-flash-exp"]>>;
+        voice_id: z.ZodOptional<z.ZodString>;
+        voice_model: z.ZodOptional<z.ZodEnum<["eleven_turbo_v2_5", "eleven_flash_v2_5", "eleven_multilingual_v2"]>>;
+        first_message: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodEnum<["en", "es", "fr", "de", "it", "pt", "pl", "nl", "ja", "zh", "ko", "ar", "hi"]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        stability: z.ZodOptional<z.ZodNumber>;
+        similarity_boost: z.ZodOptional<z.ZodNumber>;
+        widget_color: z.ZodOptional<z.ZodString>;
+        widget_avatar_url: z.ZodOptional<z.ZodString>;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    handler: (args: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Deletes an agent
+ */
+export declare const elevenlabs_delete_agent: {
+    name: string;
+    description: string;
+    zodSchema: z.ZodObject<{
+        agent_id: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        agent_id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        agent_id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    handler: (args: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Lists all agents with pagination
+ */
+export declare const elevenlabs_list_agents: {
+    name: string;
+    description: string;
+    zodSchema: z.ZodObject<{
+        limit: z.ZodDefault<z.ZodNumber>;
+        offset: z.ZodDefault<z.ZodNumber>;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        limit: z.ZodDefault<z.ZodNumber>;
+        offset: z.ZodDefault<z.ZodNumber>;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        limit: z.ZodDefault<z.ZodNumber>;
+        offset: z.ZodDefault<z.ZodNumber>;
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    handler: (args: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=agent-tools.d.ts.map

package/dist/tools/agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../src/tools/agent-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAA4B,cAAc,EAAE,MAAM,aAAa,CAAC;AASvE;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAgDZ,OAAO;;;;;;CA6C9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;oBA+BT,OAAO;;;;;;CAa9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA6CZ,OAAO;;;;;;CA0F9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;oBA+BZ,OAAO;;;;;;CAa9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;oBAkCX,OAAO;;;;;;CAiC9B,CAAC"}

package/dist/tools/agent-tools.js

@@ -0,0 +1,369 @@
+/**
+ * Agent management tools
+ *
+ * MCP tools for creating, retrieving, updating, deleting, and listing voice agents.
+ */
+import { getRequest, postRequest, patchRequest, deleteRequest } from "../services/elevenlabs-api.js";
+import { formatResponse } from "../services/formatters.js";
+import { CreateAgentSchema, GetAgentSchema, UpdateAgentSchema, DeleteAgentSchema, ListAgentsSchema } from "../schemas/agent-schemas.js";
+/**
+ * Creates a new ElevenLabs Voice Agent
+ */
+export const elevenlabs_create_agent = {
+    name: "elevenlabs_create_agent",
+    description: `Create a new ElevenLabs Voice Agent with specified configuration.
+
+This tool creates a complete voice agent with conversation settings, including the AI model, voice configuration, ASR settings, and initial behavior. It does NOT start conversations or deploy the agent - it only creates the configuration.
+
+Args:
+  - name (string): Display name for the agent (max 100 chars)
+  - prompt (string): System prompt defining behavior (10-5000 chars)
+  - llm (string): AI model to use (default: "gpt-4o-mini")
+    Options: gpt-4o, gpt-4o-mini, claude-3-5-sonnet-20241022, claude-3-5-haiku-20241022, gemini-2.0-flash-exp
+  - voice_id (string): ElevenLabs voice ID (default: "21m00Tcm4TlvDq8ikWAM" - Rachel)
+  - voice_model (string): Voice synthesis model (default: "eleven_flash_v2_5")
+    Options: eleven_turbo_v2_5, eleven_flash_v2_5, eleven_multilingual_v2
+  - first_message (string): Optional greeting message (max 500 chars)
+  - language (string): Primary language code (default: "en")
+  - temperature (number): LLM temperature 0-2 for response randomness (higher = more creative)
+  - max_tokens (number): Maximum tokens for LLM responses (1-4096)
+  - stability (number): Voice stability 0-1 (higher = more consistent)
+  - similarity_boost (number): Voice similarity boost 0-1 (higher = closer to original)
+  - widget_color (string): Widget theme color in hex format (e.g., "#FF5733")
+  - widget_avatar_url (string): Widget avatar image URL
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  For JSON format: Complete agent object with agent_id, name, conversation_config, created_at
+  For Markdown format: Formatted agent details with configuration summary
+
+Examples:
+  - Use when: "Create a customer service agent for tech support"
+  - Use when: "Set up a voice agent for appointment scheduling"
+  - Don't use when: You want to test an existing agent (use elevenlabs_generate_widget_code)
+  - Don't use when: You want to modify an agent (use elevenlabs_update_agent)
+
+Error Handling:
+  - Returns "Error: Invalid voice_id" if voice doesn't exist
+  - Returns "Error: Invalid API key" if authentication fails
+  - Returns "Error: Rate limit exceeded" if too many requests (wait 60s and retry)`,
+    zodSchema: CreateAgentSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = CreateAgentSchema.parse(args);
+        // Build agent configuration
+        const agentData = {
+            name: parsed.name,
+            conversation_config: {
+                agent: {
+                    prompt: {
+                        prompt: parsed.prompt,
+                        llm: parsed.llm,
+                        ...(parsed.temperature !== undefined && { temperature: parsed.temperature }),
+                        ...(parsed.max_tokens !== undefined && { max_tokens: parsed.max_tokens })
+                    },
+                    ...(parsed.first_message && { first_message: parsed.first_message }),
+                    language: parsed.language
+                },
+                tts: {
+                    voice_id: parsed.voice_id,
+                    model_id: parsed.voice_model,
+                    ...(parsed.stability !== undefined && { stability: parsed.stability }),
+                    ...(parsed.similarity_boost !== undefined && { similarity_boost: parsed.similarity_boost })
+                }
+            },
+            ...(parsed.widget_color || parsed.widget_avatar_url ? {
+                platform_settings: {
+                    widget: {
+                        ...(parsed.widget_color && { color: parsed.widget_color }),
+                        ...(parsed.widget_avatar_url && { avatar_url: parsed.widget_avatar_url })
+                    }
+                }
+            } : {})
+        };
+        const agent = await postRequest("/convai/agents", agentData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(agent, parsed.response_format, "agent")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Retrieves an agent by ID
+ */
+export const elevenlabs_get_agent = {
+    name: "elevenlabs_get_agent",
+    description: `Retrieve complete configuration for an existing ElevenLabs Voice Agent.
+
+This tool fetches all details about an agent including its conversation configuration, tools, knowledge base, and platform settings. Use this to inspect an agent before modifying it or to check current settings.
+
+Args:
+  - agent_id (string): Unique agent identifier (e.g., 'ag_abc123')
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Complete agent configuration including prompt, LLM settings, voice configuration, tools, and knowledge base.
+
+Examples:
+  - Use when: "Show me the configuration for agent ag_abc123"
+  - Use when: "What's the current prompt for this agent?"
+  - Don't use when: You want to list all agents (use elevenlabs_list_agents)
+
+Error Handling:
+  - Returns "Error: Agent not found" if agent_id doesn't exist
+  - Returns "Error: Invalid API key" if authentication fails`,
+    zodSchema: GetAgentSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = GetAgentSchema.parse(args);
+        const agent = await getRequest(`/convai/agents/${parsed.agent_id}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(agent, parsed.response_format, "agent")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Updates an existing agent
+ */
+export const elevenlabs_update_agent = {
+    name: "elevenlabs_update_agent",
+    description: `Update an existing ElevenLabs Voice Agent's configuration.
+
+This tool modifies one or more settings of an existing agent. You only need to provide the fields you want to change - all other settings will remain the same. Changes take effect immediately for new conversations.
+
+Args:
+  - agent_id (string): Unique agent identifier (e.g., 'ag_abc123')
+  - name (string): Updated display name (max 100 chars)
+  - prompt (string): Updated system prompt (10-5000 chars)
+  - llm (string): Updated AI model
+  - voice_id (string): Updated voice ID
+  - voice_model (string): Updated voice model
+  - first_message (string): Updated greeting (max 500 chars)
+  - language (string): Updated language code
+  - temperature (number): Updated temperature (0-2)
+  - max_tokens (number): Updated max tokens (1-4096)
+  - stability (number): Updated voice stability (0-1)
+  - similarity_boost (number): Updated similarity boost (0-1)
+  - widget_color (string): Updated widget color
+  - widget_avatar_url (string): Updated widget avatar URL
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Updated agent configuration.
+
+Examples:
+  - Use when: "Change the agent's voice to voice ID xyz123"
+  - Use when: "Update the system prompt to be more friendly"
+  - Use when: "Switch the agent to use Claude instead of GPT"
+  - Don't use when: You want to create a new agent (use elevenlabs_create_agent)
+
+Error Handling:
+  - Returns "Error: Agent not found" if agent_id doesn't exist
+  - Returns "Error: Invalid voice_id" if new voice doesn't exist`,
+    zodSchema: UpdateAgentSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = UpdateAgentSchema.parse(args);
+        // Get current agent config
+        const currentAgent = await getRequest(`/convai/agents/${parsed.agent_id}`);
+        // Build update payload with only changed fields
+        const updateData = {};
+        if (parsed.name !== undefined) {
+            updateData.name = parsed.name;
+        }
+        // Build conversation config updates
+        const conversationConfigUpdates = {
+            agent: { ...currentAgent.conversation_config.agent },
+            tts: { ...currentAgent.conversation_config.tts }
+        };
+        let hasConversationConfigChanges = false;
+        // Agent updates
+        if (parsed.prompt !== undefined || parsed.llm !== undefined ||
+            parsed.temperature !== undefined || parsed.max_tokens !== undefined) {
+            conversationConfigUpdates.agent = {
+                ...conversationConfigUpdates.agent,
+                prompt: {
+                    ...(currentAgent.conversation_config.agent.prompt),
+                    ...(parsed.prompt !== undefined && { prompt: parsed.prompt }),
+                    ...(parsed.llm !== undefined && { llm: parsed.llm }),
+                    ...(parsed.temperature !== undefined && { temperature: parsed.temperature }),
+                    ...(parsed.max_tokens !== undefined && { max_tokens: parsed.max_tokens })
+                }
+            };
+            hasConversationConfigChanges = true;
+        }
+        if (parsed.first_message !== undefined) {
+            conversationConfigUpdates.agent.first_message = parsed.first_message;
+            hasConversationConfigChanges = true;
+        }
+        if (parsed.language !== undefined) {
+            conversationConfigUpdates.agent.language = parsed.language;
+            hasConversationConfigChanges = true;
+        }
+        // TTS updates
+        if (parsed.voice_id !== undefined || parsed.voice_model !== undefined ||
+            parsed.stability !== undefined || parsed.similarity_boost !== undefined) {
+            conversationConfigUpdates.tts = {
+                ...conversationConfigUpdates.tts,
+                ...(parsed.voice_id !== undefined && { voice_id: parsed.voice_id }),
+                ...(parsed.voice_model !== undefined && { model_id: parsed.voice_model }),
+                ...(parsed.stability !== undefined && { stability: parsed.stability }),
+                ...(parsed.similarity_boost !== undefined && { similarity_boost: parsed.similarity_boost })
+            };
+            hasConversationConfigChanges = true;
+        }
+        if (hasConversationConfigChanges) {
+            updateData.conversation_config = conversationConfigUpdates;
+        }
+        // Widget updates
+        if (parsed.widget_color !== undefined || parsed.widget_avatar_url !== undefined) {
+            updateData.platform_settings = {
+                ...(currentAgent.platform_settings || {}),
+                widget: {
+                    ...(currentAgent.platform_settings?.widget || {}),
+                    ...(parsed.widget_color !== undefined && { color: parsed.widget_color }),
+                    ...(parsed.widget_avatar_url !== undefined && { avatar_url: parsed.widget_avatar_url })
+                }
+            };
+        }
+        const updatedAgent = await patchRequest(`/convai/agents/${parsed.agent_id}`, updateData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(updatedAgent, parsed.response_format, "agent")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Deletes an agent
+ */
+export const elevenlabs_delete_agent = {
+    name: "elevenlabs_delete_agent",
+    description: `Delete an ElevenLabs Voice Agent permanently.
+
+This tool permanently removes an agent and all its configuration. This action CANNOT be undone. All conversations associated with this agent will remain accessible, but the agent itself will be deleted.
+
+Args:
+  - agent_id (string): Unique agent identifier to delete (e.g., 'ag_abc123')
+
+Returns:
+  Confirmation message indicating successful deletion.
+
+Examples:
+  - Use when: "Delete the test agent ag_test123"
+  - Use when: "Remove agent ag_old456 permanently"
+  - Don't use when: You want to temporarily disable an agent (no disable feature - just don't use it)
+  - Don't use when: You're not sure - this is permanent!
+
+Error Handling:
+  - Returns "Error: Agent not found" if agent_id doesn't exist
+  - Returns "Error: Invalid API key" if authentication fails`,
+    zodSchema: DeleteAgentSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = DeleteAgentSchema.parse(args);
+        await deleteRequest(`/convai/agents/${parsed.agent_id}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully deleted agent: ${parsed.agent_id}`
+                }
+            ]
+        };
+    }
+};
+/**
+ * Lists all agents with pagination
+ */
+export const elevenlabs_list_agents = {
+    name: "elevenlabs_list_agents",
+    description: `List all ElevenLabs Voice Agents with pagination.
+
+This tool retrieves a paginated list of all your voice agents. Use the offset and limit parameters to navigate through large agent lists. The response includes pagination metadata to help you fetch additional pages.
+
+Args:
+  - limit (number): Maximum agents to return (1-100, default: 20)
+  - offset (number): Number of agents to skip (default: 0)
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  For JSON format: Object with total count, items array, offset, has_more, and next_offset
+  For Markdown format: Formatted list of agents with key details and pagination guidance
+
+Examples:
+  - Use when: "Show me all my voice agents"
+  - Use when: "List the first 10 agents"
+  - Use when: "Get the next page of agents with offset=20"
+  - Don't use when: You want details about a specific agent (use elevenlabs_get_agent)
+
+Error Handling:
+  - Returns empty list if no agents exist
+  - Returns "Error: Invalid API key" if authentication fails`,
+    zodSchema: ListAgentsSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = ListAgentsSchema.parse(args);
+        const response = await getRequest("/convai/agents", {
+            limit: parsed.limit,
+            offset: parsed.offset
+        });
+        const agents = response.agents || [];
+        const total = agents.length; // Note: ElevenLabs API may not return total count
+        const hasMore = agents.length === parsed.limit;
+        const paginatedResponse = {
+            total,
+            count: agents.length,
+            offset: parsed.offset,
+            items: agents,
+            has_more: hasMore,
+            next_offset: hasMore ? parsed.offset + agents.length : undefined
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(paginatedResponse, parsed.response_format, "agent_list")
+                }
+            ]
+        };
+    }
+};
+//# sourceMappingURL=agent-tools.js.map

package/dist/tools/agent-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.js","sourceRoot":"","sources":["../../src/tools/agent-tools.ts"],"names":[],"mappings":"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"}