elevenlabs-voice-agent-mcp 1.0.0

package/dist/tools/phone-number-tools.js

@@ -0,0 +1,295 @@
+/**
+ * Phone number management tools
+ *
+ * MCP tools for listing, importing, updating, and deleting phone numbers
+ * connected to voice agents via Twilio or SIP trunking.
+ */
+import { getRequest, postRequest, patchRequest, deleteRequest } from "../services/elevenlabs-api.js";
+import { formatResponse } from "../services/formatters.js";
+import { ListPhoneNumbersSchema, GetPhoneNumberSchema, ImportPhoneNumberSchema, UpdatePhoneNumberSchema, DeletePhoneNumberSchema } from "../schemas/phone-number-schemas.js";
+/**
+ * Lists all phone numbers connected to the workspace
+ */
+export const elevenlabs_list_phone_numbers = {
+    name: "elevenlabs_list_phone_numbers",
+    description: `List all phone numbers connected to your ElevenLabs workspace.
+
+This tool retrieves all phone numbers you've imported (Twilio or SIP trunk), showing which agents they're assigned to, their capabilities (inbound/outbound), and configuration details.
+
+Args:
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Array of phone number objects, each containing:
+  - phone_number: The actual phone number
+  - label: Descriptive name
+  - phone_number_id: Unique identifier for API operations
+  - provider: 'twilio' or 'sip_trunk'
+  - supports_inbound: Whether it can receive calls
+  - supports_outbound: Whether it can make calls
+  - assigned_agent: Agent details (if assigned) or null
+
+Examples:
+  - Use when: "Show me all my phone numbers"
+  - Use when: "List available phone numbers for outbound calling"
+  - Use when: "Which phone numbers are assigned to agents?"
+  - Don't use when: You want details about a specific phone number (use elevenlabs_get_phone_number)
+
+Error Handling:
+  - Returns empty array if no phone numbers exist
+  - Returns "Error: Invalid API key" if authentication fails`,
+    zodSchema: ListPhoneNumbersSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = ListPhoneNumbersSchema.parse(args);
+        const response = await getRequest("/convai/phone-numbers");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(response, parsed.response_format, "phone_number_list")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Gets details about a specific phone number
+ */
+export const elevenlabs_get_phone_number = {
+    name: "elevenlabs_get_phone_number",
+    description: `Get detailed information about a specific phone number.
+
+This tool retrieves complete configuration details for a phone number, including provider settings, agent assignment, trunk configurations, and capability flags.
+
+Args:
+  - phone_number_id (string): Unique phone number identifier (e.g., 'pn_abc123')
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Complete phone number details including provider-specific configuration.
+
+Examples:
+  - Use when: "Show me details for phone number pn_abc123"
+  - Use when: "What agent is assigned to phone pn_xyz789?"
+  - Use when: "Get configuration for phone number ID pn_test456"
+  - Don't use when: You want to list all phone numbers (use elevenlabs_list_phone_numbers)
+
+Error Handling:
+  - Returns "Error: Phone number not found" if phone_number_id doesn't exist
+  - Returns "Error: Invalid API key" if authentication fails`,
+    zodSchema: GetPhoneNumberSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = GetPhoneNumberSchema.parse(args);
+        const response = await getRequest(`/convai/phone-numbers/${parsed.phone_number_id}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(response, parsed.response_format, "phone_number")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Imports a Twilio phone number
+ */
+export const elevenlabs_import_phone_number = {
+    name: "elevenlabs_import_phone_number",
+    description: `Import a Twilio phone number to use with ElevenLabs Voice Agents.
+
+This tool connects your existing Twilio phone number to ElevenLabs, enabling it for inbound and/or outbound voice agent calls. You'll need your Twilio Account SID and Auth Token.
+
+Prerequisites:
+  - Active Twilio account with a purchased phone number
+  - Twilio Account SID and Auth Token
+  - Phone number must not already be imported
+
+Args:
+  - phone_number (string): Phone number to import in E.164 format (e.g., '+1234567890')
+  - label (string): Descriptive name for this number (e.g., 'Customer Support Line')
+  - sid (string): Twilio Account SID (starts with 'AC')
+  - token (string): Twilio Auth Token
+  - provider (string): Must be 'twilio'
+  - supports_inbound (boolean, optional): Enable inbound calls (default: true)
+  - supports_outbound (boolean, optional): Enable outbound calls (default: true)
+  - region_config (object, optional): Regional configuration
+    - region_id: 'us1', 'ie1', or 'au1'
+    - token: Regional token
+    - edge_location: Twilio edge location
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  - phone_number_id: Unique identifier for the imported phone number
+
+Examples:
+  - Use when: "Import my Twilio number +1234567890 for customer support"
+  - Use when: "Connect Twilio phone number with SID AC123... for outbound calling"
+  - Use when: "Add new phone number +447911123456 from Twilio account"
+  - Don't use when: Number is already imported (update it instead)
+  - Don't use when: You need to assign it to an agent (use elevenlabs_update_phone_number after)
+
+Error Handling:
+  - Returns "Error: Invalid Twilio credentials" if SID/token are wrong
+  - Returns "Error: Phone number already exists" if already imported
+  - Returns "Error: Invalid phone number format" if not E.164`,
+    zodSchema: ImportPhoneNumberSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = ImportPhoneNumberSchema.parse(args);
+        const requestData = {
+            phone_number: parsed.phone_number,
+            label: parsed.label,
+            sid: parsed.sid,
+            token: parsed.token,
+            provider: parsed.provider,
+            ...(parsed.supports_inbound !== undefined && {
+                supports_inbound: parsed.supports_inbound
+            }),
+            ...(parsed.supports_outbound !== undefined && {
+                supports_outbound: parsed.supports_outbound
+            }),
+            ...(parsed.region_config && {
+                region_config: parsed.region_config
+            })
+        };
+        const response = await postRequest("/convai/phone-numbers", requestData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(response, parsed.response_format, "phone_number_import")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Updates a phone number (primarily for agent assignment)
+ */
+export const elevenlabs_update_phone_number = {
+    name: "elevenlabs_update_phone_number",
+    description: `Update a phone number's configuration, primarily to assign or unassign agents.
+
+This tool modifies phone number settings. The most common use is assigning an agent to a phone number so the agent can handle calls from that number. You can also configure SIP trunk settings for advanced deployments.
+
+Args:
+  - phone_number_id (string): Phone number identifier to update (e.g., 'pn_abc123')
+  - agent_id (string, optional): Agent ID to assign (set to null to unassign)
+  - inbound_trunk_config (object, optional): SIP trunk configuration for inbound
+  - outbound_trunk_config (object, optional): SIP trunk configuration for outbound
+  - livekit_stack ('standard' | 'static', optional): LiveKit stack configuration
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Updated phone number object with new configuration.
+
+Examples:
+  - Use when: "Assign agent ag_abc123 to phone number pn_xyz789"
+  - Use when: "Connect my customer support agent to the main phone line"
+  - Use when: "Unassign agent from phone number pn_test456"
+  - Use when: "Update phone number pn_sales to use agent ag_sales"
+  - Don't use when: You need to import a new number (use elevenlabs_import_phone_number)
+
+Error Handling:
+  - Returns "Error: Phone number not found" if phone_number_id doesn't exist
+  - Returns "Error: Agent not found" if agent_id doesn't exist
+  - Returns "Error: Invalid API key" if authentication fails`,
+    zodSchema: UpdatePhoneNumberSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = UpdatePhoneNumberSchema.parse(args);
+        const updateData = {};
+        if (parsed.agent_id !== undefined) {
+            updateData.agent_id = parsed.agent_id;
+        }
+        if (parsed.inbound_trunk_config !== undefined) {
+            updateData.inbound_trunk_config = parsed.inbound_trunk_config;
+        }
+        if (parsed.outbound_trunk_config !== undefined) {
+            updateData.outbound_trunk_config = parsed.outbound_trunk_config;
+        }
+        if (parsed.livekit_stack !== undefined) {
+            updateData.livekit_stack = parsed.livekit_stack;
+        }
+        const response = await patchRequest(`/convai/phone-numbers/${parsed.phone_number_id}`, updateData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(response, parsed.response_format, "phone_number")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Deletes a phone number
+ */
+export const elevenlabs_delete_phone_number = {
+    name: "elevenlabs_delete_phone_number",
+    description: `Delete a phone number from your ElevenLabs workspace.
+
+This tool permanently removes a phone number from ElevenLabs. This does NOT delete the number from your Twilio account - it only disconnects it from ElevenLabs. You can re-import it later if needed.
+
+IMPORTANT: This action cannot be undone. Any agent assignments will be removed.
+
+Args:
+  - phone_number_id (string): Phone number identifier to delete (e.g., 'pn_abc123')
+
+Returns:
+  Confirmation message indicating successful deletion.
+
+Examples:
+  - Use when: "Delete phone number pn_test123"
+  - Use when: "Remove phone number pn_old456 from ElevenLabs"
+  - Use when: "Disconnect Twilio number pn_unused789"
+  - Don't use when: You just want to unassign an agent (use elevenlabs_update_phone_number)
+  - Don't use when: You're not sure - this is permanent!
+
+Error Handling:
+  - Returns "Error: Phone number not found" if phone_number_id doesn't exist
+  - Returns "Error: Invalid API key" if authentication fails`,
+    zodSchema: DeletePhoneNumberSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = DeletePhoneNumberSchema.parse(args);
+        await deleteRequest(`/convai/phone-numbers/${parsed.phone_number_id}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully deleted phone number: ${parsed.phone_number_id}`
+                }
+            ]
+        };
+    }
+};
+//# sourceMappingURL=phone-number-tools.js.map

package/dist/tools/phone-number-tools.js.map

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

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

@@ -0,0 +1,165 @@
+/**
+ * Agent tool management
+ *
+ * MCP tools for creating, listing, and deleting webhook tools that agents can invoke.
+ */
+/**
+ * Creates a webhook tool for an agent
+ */
+export declare const elevenlabs_create_webhook_tool: {
+    name: string;
+    description: string;
+    zodSchema: import("zod").ZodObject<{
+        agent_id: import("zod").ZodString;
+        name: import("zod").ZodString;
+        description: import("zod").ZodString;
+        url: import("zod").ZodString;
+        method: import("zod").ZodDefault<import("zod").ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
+        headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        parameters: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodEnum<["string", "number", "boolean", "object", "array"]>;
+            description: import("zod").ZodString;
+            required: import("zod").ZodBoolean;
+            enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodEnum<["string", "number", "boolean", "object", "array"]>;
+            description: import("zod").ZodString;
+            required: import("zod").ZodBoolean;
+            enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodEnum<["string", "number", "boolean", "object", "array"]>;
+            description: import("zod").ZodString;
+            required: import("zod").ZodBoolean;
+            enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, import("zod").ZodTypeAny, "passthrough">>, "many">;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+        agent_id: import("zod").ZodString;
+        name: import("zod").ZodString;
+        description: import("zod").ZodString;
+        url: import("zod").ZodString;
+        method: import("zod").ZodDefault<import("zod").ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
+        headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        parameters: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodEnum<["string", "number", "boolean", "object", "array"]>;
+            description: import("zod").ZodString;
+            required: import("zod").ZodBoolean;
+            enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodEnum<["string", "number", "boolean", "object", "array"]>;
+            description: import("zod").ZodString;
+            required: import("zod").ZodBoolean;
+            enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodEnum<["string", "number", "boolean", "object", "array"]>;
+            description: import("zod").ZodString;
+            required: import("zod").ZodBoolean;
+            enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, import("zod").ZodTypeAny, "passthrough">>, "many">;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+        agent_id: import("zod").ZodString;
+        name: import("zod").ZodString;
+        description: import("zod").ZodString;
+        url: import("zod").ZodString;
+        method: import("zod").ZodDefault<import("zod").ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
+        headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        parameters: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodEnum<["string", "number", "boolean", "object", "array"]>;
+            description: import("zod").ZodString;
+            required: import("zod").ZodBoolean;
+            enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodEnum<["string", "number", "boolean", "object", "array"]>;
+            description: import("zod").ZodString;
+            required: import("zod").ZodBoolean;
+            enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodEnum<["string", "number", "boolean", "object", "array"]>;
+            description: import("zod").ZodString;
+            required: import("zod").ZodBoolean;
+            enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, import("zod").ZodTypeAny, "passthrough">>, "many">;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, import("zod").ZodTypeAny, "passthrough">>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    handler: (args: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Lists all tools configured for an agent
+ */
+export declare const elevenlabs_list_tools: {
+    name: string;
+    description: string;
+    zodSchema: import("zod").ZodObject<{
+        agent_id: import("zod").ZodString;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+        agent_id: import("zod").ZodString;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+        agent_id: import("zod").ZodString;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, import("zod").ZodTypeAny, "passthrough">>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    handler: (args: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Deletes a tool from an agent
+ */
+export declare const elevenlabs_delete_tool: {
+    name: string;
+    description: string;
+    zodSchema: import("zod").ZodObject<{
+        agent_id: import("zod").ZodString;
+        tool_name: import("zod").ZodString;
+    }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+        agent_id: import("zod").ZodString;
+        tool_name: import("zod").ZodString;
+    }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+        agent_id: import("zod").ZodString;
+        tool_name: import("zod").ZodString;
+    }, import("zod").ZodTypeAny, "passthrough">>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    handler: (args: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=tool-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-tools.d.ts","sourceRoot":"","sources":["../../src/tools/tool-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA4CnB,OAAO;;;;;;CA2B9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;oBAgCV,OAAO;;;;;;CAgB9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;oBA+BX,OAAO;;;;;;CAgB9B,CAAC"}

package/dist/tools/tool-tools.js

@@ -0,0 +1,166 @@
+/**
+ * Agent tool management
+ *
+ * MCP tools for creating, listing, and deleting webhook tools that agents can invoke.
+ */
+import { getRequest, postRequest, deleteRequest } from "../services/elevenlabs-api.js";
+import { formatResponse } from "../services/formatters.js";
+import { CreateWebhookToolSchema, ListToolsSchema, DeleteToolSchema } from "../schemas/tool-schemas.js";
+/**
+ * Creates a webhook tool for an agent
+ */
+export const elevenlabs_create_webhook_tool = {
+    name: "elevenlabs_create_webhook_tool",
+    description: `Create a webhook tool that the agent can invoke during conversations.
+
+This tool allows agents to interact with external APIs and services. When the agent determines it needs to use the tool, it will make an HTTP request to the specified URL with the provided parameters. The webhook response can inform the agent's next response.
+
+Args:
+  - agent_id (string): Agent to add the tool to
+  - name (string): Unique tool name (alphanumeric, hyphens, underscores only, max 64 chars)
+  - description (string): Clear description of what the tool does (10-500 chars)
+  - url (string): Webhook URL to call when tool is invoked
+  - method (string): HTTP method (GET, POST, PUT, PATCH, DELETE, default: POST)
+  - headers (object): Optional custom headers as key-value pairs
+  - parameters (array): Array of parameter definitions with:
+    - name (string): Parameter name
+    - type (string): Data type (string, number, boolean, object, array)
+    - description (string): Parameter description
+    - required (boolean): Whether parameter is required
+    - enum (array): Optional array of allowed values
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Created tool configuration.
+
+Examples:
+  - Use when: "Add a tool to check order status from our API"
+  - Use when: "Create a webhook tool to schedule callbacks"
+  - Use when: "Give the agent ability to search our product catalog"
+  - Don't use when: You want to add knowledge/documents (use elevenlabs_add_knowledge_base)
+
+Error Handling:
+  - Returns "Error: Agent not found" if agent_id doesn't exist
+  - Returns "Error: Tool name already exists" if name is taken
+  - Returns "Error: Invalid URL" if webhook URL is not valid`,
+    zodSchema: CreateWebhookToolSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = CreateWebhookToolSchema.parse(args);
+        const toolData = {
+            name: parsed.name,
+            description: parsed.description,
+            type: "webhook",
+            url: parsed.url,
+            method: parsed.method,
+            ...(parsed.headers && { headers: parsed.headers }),
+            parameters: parsed.parameters
+        };
+        const tool = await postRequest(`/convai/agents/${parsed.agent_id}/tools`, toolData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(tool, parsed.response_format, "tool")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Lists all tools configured for an agent
+ */
+export const elevenlabs_list_tools = {
+    name: "elevenlabs_list_tools",
+    description: `List all tools configured for an agent.
+
+This tool retrieves all webhook tools that have been added to an agent. Use this to see what external capabilities the agent currently has access to.
+
+Args:
+  - agent_id (string): Agent identifier
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Array of tool configurations including names, descriptions, URLs, and parameters.
+
+Examples:
+  - Use when: "Show me all tools for this agent"
+  - Use when: "What APIs can the agent access?"
+  - Use when: "List the webhook tools configured"
+  - Don't use when: You want to see agent configuration (use elevenlabs_get_agent)
+
+Error Handling:
+  - Returns "Error: Agent not found" if agent_id doesn't exist
+  - Returns empty list if agent has no tools`,
+    zodSchema: ListToolsSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = ListToolsSchema.parse(args);
+        // Get agent to access tools from conversation config
+        const agent = await getRequest(`/convai/agents/${parsed.agent_id}`);
+        const tools = agent.conversation_config.agent.prompt.tools || [];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(tools, parsed.response_format, "tool_list")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Deletes a tool from an agent
+ */
+export const elevenlabs_delete_tool = {
+    name: "elevenlabs_delete_tool",
+    description: `Remove a webhook tool from an agent.
+
+This tool permanently deletes a webhook tool from an agent's configuration. The agent will no longer be able to invoke this tool in conversations. This action cannot be undone.
+
+Args:
+  - agent_id (string): Agent identifier
+  - tool_name (string): Name of the tool to delete
+
+Returns:
+  Confirmation message indicating successful deletion.
+
+Examples:
+  - Use when: "Remove the order_status tool from the agent"
+  - Use when: "Delete the deprecated webhook tool"
+  - Don't use when: You want to modify the tool (delete and recreate instead)
+
+Error Handling:
+  - Returns "Error: Agent not found" if agent_id doesn't exist
+  - Returns "Error: Tool not found" if tool_name doesn't exist`,
+    zodSchema: DeleteToolSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = DeleteToolSchema.parse(args);
+        await deleteRequest(`/convai/agents/${parsed.agent_id}/tools/${parsed.tool_name}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully deleted tool "${parsed.tool_name}" from agent ${parsed.agent_id}`
+                }
+            ]
+        };
+    }
+};
+//# sourceMappingURL=tool-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-tools.js","sourceRoot":"","sources":["../../src/tools/tool-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DA+B8C;IAE3D,SAAS,EAAE,uBAAuB;IAElC,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,IAAI;KACpB;IAED,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEnD,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,SAAS;YACf,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YAClD,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,WAAW,CAC5B,kBAAkB,MAAM,CAAC,QAAQ,QAAQ,EACzC,QAAQ,CACT,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC;iBAC3D;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;6CAmB8B;IAE3C,SAAS,EAAE,eAAe;IAE1B,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IAED,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3C,qDAAqD;QACrD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAQ,kBAAkB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QAEjE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC;iBACjE;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE;;;;;;;;;;;;;;;;;;+DAkBgD;IAE7D,SAAS,EAAE,gBAAgB;IAE3B,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IAED,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5C,MAAM,aAAa,CACjB,kBAAkB,MAAM,CAAC,QAAQ,UAAU,MAAM,CAAC,SAAS,EAAE,CAC9D,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,8BAA8B,MAAM,CAAC,SAAS,gBAAgB,MAAM,CAAC,QAAQ,EAAE;iBACtF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}