elevenlabs-voice-agent-mcp 1.0.0

package/dist/tools/batch-calling-tools.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Batch calling tools
+ *
+ * MCP tools for submitting batch call jobs, listing batches, and retrieving batch details.
+ */
+/**
+ * Submits a batch calling job
+ */
+export declare const elevenlabs_submit_batch_call: {
+    name: string;
+    description: string;
+    zodSchema: import("zod").ZodObject<{
+        call_name: import("zod").ZodString;
+        agent_id: import("zod").ZodString;
+        recipients: import("zod").ZodArray<import("zod").ZodEffects<import("zod").ZodObject<{
+            id: import("zod").ZodOptional<import("zod").ZodString>;
+            phone_number: import("zod").ZodOptional<import("zod").ZodString>;
+            whatsapp_user_id: import("zod").ZodOptional<import("zod").ZodString>;
+            conversation_initiation_client_data: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+        }, "strip", import("zod").ZodTypeAny, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }>, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }>, "many">;
+        scheduled_time_unix: import("zod").ZodOptional<import("zod").ZodNumber>;
+        agent_phone_number_id: import("zod").ZodOptional<import("zod").ZodString>;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+        call_name: import("zod").ZodString;
+        agent_id: import("zod").ZodString;
+        recipients: import("zod").ZodArray<import("zod").ZodEffects<import("zod").ZodObject<{
+            id: import("zod").ZodOptional<import("zod").ZodString>;
+            phone_number: import("zod").ZodOptional<import("zod").ZodString>;
+            whatsapp_user_id: import("zod").ZodOptional<import("zod").ZodString>;
+            conversation_initiation_client_data: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+        }, "strip", import("zod").ZodTypeAny, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }>, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }>, "many">;
+        scheduled_time_unix: import("zod").ZodOptional<import("zod").ZodNumber>;
+        agent_phone_number_id: import("zod").ZodOptional<import("zod").ZodString>;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+        call_name: import("zod").ZodString;
+        agent_id: import("zod").ZodString;
+        recipients: import("zod").ZodArray<import("zod").ZodEffects<import("zod").ZodObject<{
+            id: import("zod").ZodOptional<import("zod").ZodString>;
+            phone_number: import("zod").ZodOptional<import("zod").ZodString>;
+            whatsapp_user_id: import("zod").ZodOptional<import("zod").ZodString>;
+            conversation_initiation_client_data: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+        }, "strip", import("zod").ZodTypeAny, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }>, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }, {
+            phone_number?: string | undefined;
+            conversation_initiation_client_data?: Record<string, any> | undefined;
+            id?: string | undefined;
+            whatsapp_user_id?: string | undefined;
+        }>, "many">;
+        scheduled_time_unix: import("zod").ZodOptional<import("zod").ZodNumber>;
+        agent_phone_number_id: import("zod").ZodOptional<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;
+        }[];
+    }>;
+};
+/**
+ * Lists all batch calling jobs in workspace
+ */
+export declare const elevenlabs_list_batch_calls: {
+    name: string;
+    description: string;
+    zodSchema: import("zod").ZodObject<{
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        last_doc: import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        last_doc: import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        last_doc: import("zod").ZodNullable<import("zod").ZodOptional<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;
+        }[];
+    }>;
+};
+/**
+ * Gets detailed information about a specific batch call
+ */
+export declare const elevenlabs_get_batch_call: {
+    name: string;
+    description: string;
+    zodSchema: import("zod").ZodObject<{
+        batch_id: import("zod").ZodString;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+        batch_id: import("zod").ZodString;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+        batch_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;
+        }[];
+    }>;
+};
+//# sourceMappingURL=batch-calling-tools.d.ts.map

package/dist/tools/batch-calling-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-calling-tools.d.ts","sourceRoot":"","sources":["../../src/tools/batch-calling-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAuDjB,OAAO;;;;;;CA6B9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;oBAuChB,OAAO;;;;;;CAyB9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;oBA4Cd,OAAO;;;;;;CAgB9B,CAAC"}

package/dist/tools/batch-calling-tools.js

@@ -0,0 +1,203 @@
+/**
+ * Batch calling tools
+ *
+ * MCP tools for submitting batch call jobs, listing batches, and retrieving batch details.
+ */
+import { getRequest, postRequest } from "../services/elevenlabs-api.js";
+import { formatResponse } from "../services/formatters.js";
+import { SubmitBatchCallSchema, ListBatchCallsSchema, GetBatchCallSchema } from "../schemas/batch-calling-schemas.js";
+/**
+ * Submits a batch calling job
+ */
+export const elevenlabs_submit_batch_call = {
+    name: "elevenlabs_submit_batch_call",
+    description: `Submit a batch calling job to initiate multiple outbound calls simultaneously.
+
+This tool allows you to call multiple phone numbers in parallel using your voice agent. Upload a list of recipients with optional personalization data for each call. Batch calling is ideal for surveys, alerts, reminders, appointment confirmations, and mass outreach.
+
+Prerequisites:
+  - A Twilio phone number must be imported and associated with an agent
+  - Zero Retention Mode (ZRM) must be disabled
+  - Minimum 50% workspace concurrency or 70% agent concurrency available
+
+Args:
+  - call_name (string): Descriptive name for this batch (e.g., "Q4 Customer Survey")
+  - agent_id (string): Agent to use for all calls (e.g., 'ag_abc123')
+  - recipients (array): Array of recipient objects, each containing:
+    - phone_number (string): Phone in E.164 format (e.g., '+1234567890')
+    - OR whatsapp_user_id (string): WhatsApp user ID (alternative)
+    - id (string, optional): Custom tracking ID for this recipient
+    - conversation_initiation_client_data (object, optional): Personalization data
+      - dynamic_variables (object): Dynamic variables for personalization
+        Example: {dynamic_variables: {name: 'John', appointment_time: '3pm'}}
+      - conversation_config_override (object): Override agent settings for this call
+        - Special fields: language, first_message, prompt.prompt, voice_id
+  - scheduled_time_unix (number, optional): Unix timestamp to schedule for future
+  - agent_phone_number_id (string, optional): Phone number ID to use as caller ID
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Batch job details including ID, status, scheduling info, and call counts.
+
+Limits:
+  - Minimum: 1 recipient
+  - Maximum: 10,000 recipients per batch
+
+Examples:
+  - Use when: "Call 500 customers with appointment reminders"
+  - Use when: "Send survey to all users with personalized greetings"
+  - Use when: "Dispatch agent to call lead list from CSV"
+  - Don't use when: Making a single call (use elevenlabs_start_outbound_call)
+  - Don't use when: Phone number isn't assigned to agent yet
+
+Error Handling:
+  - Returns "Error: Invalid recipient count" if outside 1-10,000 range
+  - Returns "Error: Phone number not assigned" if agent lacks phone number
+  - Returns "Error: ZRM enabled" if Zero Retention Mode is active`,
+    zodSchema: SubmitBatchCallSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = SubmitBatchCallSchema.parse(args);
+        const requestData = {
+            call_name: parsed.call_name,
+            agent_id: parsed.agent_id,
+            recipients: parsed.recipients,
+            ...(parsed.scheduled_time_unix !== undefined && {
+                scheduled_time_unix: parsed.scheduled_time_unix
+            }),
+            ...(parsed.agent_phone_number_id && {
+                agent_phone_number_id: parsed.agent_phone_number_id
+            })
+        };
+        const response = await postRequest("/convai/batch-calling/submit", requestData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(response, parsed.response_format, "batch_call")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Lists all batch calling jobs in workspace
+ */
+export const elevenlabs_list_batch_calls = {
+    name: "elevenlabs_list_batch_calls",
+    description: `List all batch calling jobs in your workspace with pagination.
+
+This tool retrieves all batch call jobs you've submitted, showing their status, scheduling, and progress. Use cursor-based pagination to navigate through large lists.
+
+Args:
+  - limit (number): Maximum items to return (1-100, default: 20)
+  - last_doc (string, optional): Pagination cursor from previous response
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  - batch_calls: Array of batch job objects with status and metrics
+  - next_doc: Cursor for next page (null if no more pages)
+  - has_more: Whether more batches exist
+
+Pagination:
+  - First page: Don't include last_doc parameter
+  - Next pages: Use next_doc value from previous response as last_doc
+
+Examples:
+  - Use when: "Show me all my batch calling jobs"
+  - Use when: "List recent batch calls"
+  - Use when: "Get next page of batches with cursor xyz123"
+  - Don't use when: You want details about a specific batch (use elevenlabs_get_batch_call)
+
+Error Handling:
+  - Returns empty list if no batches exist
+  - Returns "Error: Invalid API key" if authentication fails`,
+    zodSchema: ListBatchCallsSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = ListBatchCallsSchema.parse(args);
+        const params = {
+            limit: parsed.limit
+        };
+        if (parsed.last_doc) {
+            params.last_doc = parsed.last_doc;
+        }
+        const response = await getRequest("/convai/batch-calling/workspace", params);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(response, parsed.response_format, "batch_call_list")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Gets detailed information about a specific batch call
+ */
+export const elevenlabs_get_batch_call = {
+    name: "elevenlabs_get_batch_call",
+    description: `Get detailed information about a specific batch calling job including all recipient statuses.
+
+This tool retrieves complete details for a batch call job, including the status of each individual recipient. Use this to monitor batch progress, identify failed calls, detect voicemails, and track which recipients have been successfully contacted.
+
+Args:
+  - batch_id (string): Unique batch job identifier (e.g., 'batch_abc123')
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Complete batch details including:
+  - Batch metadata (name, agent, status, timing)
+  - Call metrics (dispatched, scheduled counts)
+  - Recipients array with individual statuses:
+    - pending: Not yet called
+    - initiated: Call started
+    - in_progress: Currently in conversation
+    - completed: Call finished successfully
+    - failed: Call failed
+    - cancelled: Call was cancelled
+    - voicemail: Went to voicemail
+  - Each recipient includes conversation_id for transcript lookup
+
+Examples:
+  - Use when: "Check status of batch job batch_abc123"
+  - Use when: "Show me which recipients answered in the sales batch"
+  - Use when: "Get details on appointment reminder batch"
+  - Use when: "Find failed calls in batch xyz789"
+  - Don't use when: You want to list all batches (use elevenlabs_list_batch_calls)
+
+Error Handling:
+  - Returns "Error: Batch not found" if batch_id doesn't exist
+  - Returns "Error: Invalid API key" if authentication fails`,
+    zodSchema: GetBatchCallSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = GetBatchCallSchema.parse(args);
+        const response = await getRequest(`/convai/batch-calling/${parsed.batch_id}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(response, parsed.response_format, "batch_call_detail")
+                }
+            ]
+        };
+    }
+};
+//# sourceMappingURL=batch-calling-tools.js.map

package/dist/tools/batch-calling-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-calling-tools.js","sourceRoot":"","sources":["../../src/tools/batch-calling-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qCAAqC,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEA0CmD;IAEhE,SAAS,EAAE,qBAAqB;IAEhC,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,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjD,MAAM,WAAW,GAAG;YAClB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,GAAG,CAAC,MAAM,CAAC,mBAAmB,KAAK,SAAS,IAAI;gBAC9C,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;aAChD,CAAC;YACF,GAAG,CAAC,MAAM,CAAC,qBAAqB,IAAI;gBAClC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;aACpD,CAAC;SACH,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,WAAW,CAChC,8BAA8B,EAC9B,WAAW,CACZ,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;iBACrE;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;6DA0B8C;IAE3D,SAAS,EAAE,oBAAoB;IAE/B,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,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,MAAM,MAAM,GAA4B;YACtC,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;QAEF,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACpC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,UAAU,CAC/B,iCAAiC,EACjC,MAAM,CACP,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC;iBAC1E;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DA+B8C;IAE3D,SAAS,EAAE,kBAAkB;IAE7B,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,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE9C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAC/B,yBAAyB,MAAM,CAAC,QAAQ,EAAE,CAC3C,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC;iBAC5E;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,103 @@
+/**
+ * Conversation retrieval tools
+ *
+ * MCP tools for accessing conversation histories, transcripts, and analytics.
+ */
+/**
+ * Retrieves a single conversation with full transcript
+ */
+export declare const elevenlabs_get_conversation: {
+    name: string;
+    description: string;
+    zodSchema: import("zod").ZodObject<{
+        conversation_id: import("zod").ZodString;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+        conversation_id: import("zod").ZodString;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+        conversation_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;
+        }[];
+    }>;
+};
+/**
+ * Lists conversations with filtering and pagination
+ */
+export declare const elevenlabs_list_conversations: {
+    name: string;
+    description: string;
+    zodSchema: import("zod").ZodObject<{
+        agent_id: import("zod").ZodOptional<import("zod").ZodString>;
+        status: import("zod").ZodOptional<import("zod").ZodEnum<["in_progress", "completed", "failed"]>>;
+        date_range: import("zod").ZodOptional<import("zod").ZodObject<{
+            start: import("zod").ZodOptional<import("zod").ZodString>;
+            end: import("zod").ZodOptional<import("zod").ZodString>;
+        }, "strip", import("zod").ZodTypeAny, {
+            start?: string | undefined;
+            end?: string | undefined;
+        }, {
+            start?: string | undefined;
+            end?: string | undefined;
+        }>>;
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+        agent_id: import("zod").ZodOptional<import("zod").ZodString>;
+        status: import("zod").ZodOptional<import("zod").ZodEnum<["in_progress", "completed", "failed"]>>;
+        date_range: import("zod").ZodOptional<import("zod").ZodObject<{
+            start: import("zod").ZodOptional<import("zod").ZodString>;
+            end: import("zod").ZodOptional<import("zod").ZodString>;
+        }, "strip", import("zod").ZodTypeAny, {
+            start?: string | undefined;
+            end?: string | undefined;
+        }, {
+            start?: string | undefined;
+            end?: string | undefined;
+        }>>;
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+        response_format: import("zod").ZodDefault<import("zod").ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+    }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+        agent_id: import("zod").ZodOptional<import("zod").ZodString>;
+        status: import("zod").ZodOptional<import("zod").ZodEnum<["in_progress", "completed", "failed"]>>;
+        date_range: import("zod").ZodOptional<import("zod").ZodObject<{
+            start: import("zod").ZodOptional<import("zod").ZodString>;
+            end: import("zod").ZodOptional<import("zod").ZodString>;
+        }, "strip", import("zod").ZodTypeAny, {
+            start?: string | undefined;
+            end?: string | undefined;
+        }, {
+            start?: string | undefined;
+            end?: string | undefined;
+        }>>;
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+        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;
+        }[];
+    }>;
+};
+//# sourceMappingURL=conversation-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-tools.d.ts","sourceRoot":"","sources":["../../src/tools/conversation-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;oBAoChB,OAAO;;;;;;CAgB9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAwClB,OAAO;;;;;;CAoD9B,CAAC"}

package/dist/tools/conversation-tools.js

@@ -0,0 +1,140 @@
+/**
+ * Conversation retrieval tools
+ *
+ * MCP tools for accessing conversation histories, transcripts, and analytics.
+ */
+import { getRequest } from "../services/elevenlabs-api.js";
+import { formatResponse } from "../services/formatters.js";
+import { GetConversationSchema, ListConversationsSchema } from "../schemas/conversation-schemas.js";
+/**
+ * Retrieves a single conversation with full transcript
+ */
+export const elevenlabs_get_conversation = {
+    name: "elevenlabs_get_conversation",
+    description: `Retrieve complete details and transcript for a specific conversation.
+
+This tool fetches full conversation details including the complete transcript, tool calls made, analysis metrics, and metadata. Use this to review past conversations, debug issues, or analyze agent performance.
+
+Args:
+  - conversation_id (string): Unique conversation identifier
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Complete conversation object with:
+  - Conversation metadata (status, timestamps, duration)
+  - Full transcript with user and agent messages
+  - Tool calls made during the conversation
+  - Analysis data (sentiment, performance, key topics)
+
+Examples:
+  - Use when: "Show me the transcript for conversation conv_xyz789"
+  - Use when: "What did the agent say in this conversation?"
+  - Use when: "Review the conversation that failed"
+  - Don't use when: You want to list multiple conversations (use elevenlabs_list_conversations)
+
+Error Handling:
+  - Returns "Error: Conversation not found" if conversation_id doesn't exist
+  - Returns "Error: Invalid API key" if authentication fails`,
+    zodSchema: GetConversationSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = GetConversationSchema.parse(args);
+        const conversation = await getRequest(`/convai/conversations/${parsed.conversation_id}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(conversation, parsed.response_format, "conversation")
+                }
+            ]
+        };
+    }
+};
+/**
+ * Lists conversations with filtering and pagination
+ */
+export const elevenlabs_list_conversations = {
+    name: "elevenlabs_list_conversations",
+    description: `List conversations with optional filtering by agent, status, and date range.
+
+This tool retrieves a paginated list of conversations. You can filter by agent ID, conversation status, or date range to find specific conversations. Use this for monitoring, analytics, or reviewing agent interactions.
+
+Args:
+  - agent_id (string): Optional - filter by specific agent
+  - status ('in_progress' | 'completed' | 'failed'): Optional - filter by status
+  - date_range (object): Optional - filter by date range with:
+    - start (string): Start date in ISO 8601 format
+    - end (string): End date in ISO 8601 format
+  - limit (number): Maximum conversations to return (1-100, default: 20)
+  - offset (number): Number to skip for pagination (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 conversations with key details and pagination guidance
+
+Examples:
+  - Use when: "Show me all conversations from yesterday"
+  - Use when: "List failed conversations for agent ag_abc123"
+  - Use when: "Get the last 50 conversations"
+  - Use when: "Show conversations that are still in progress"
+  - Don't use when: You want full transcript (use elevenlabs_get_conversation)
+
+Error Handling:
+  - Returns empty list if no conversations match filters
+  - Returns "Error: Invalid date format" if date_range is malformed`,
+    zodSchema: ListConversationsSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    },
+    handler: async (args) => {
+        const parsed = ListConversationsSchema.parse(args);
+        const params = {
+            limit: parsed.limit,
+            offset: parsed.offset
+        };
+        if (parsed.agent_id) {
+            params.agent_id = parsed.agent_id;
+        }
+        if (parsed.status) {
+            params.status = parsed.status;
+        }
+        if (parsed.date_range) {
+            if (parsed.date_range.start) {
+                params.start_date = parsed.date_range.start;
+            }
+            if (parsed.date_range.end) {
+                params.end_date = parsed.date_range.end;
+            }
+        }
+        const response = await getRequest("/convai/conversations", params);
+        const conversations = response.conversations || [];
+        const total = conversations.length;
+        const hasMore = conversations.length === parsed.limit;
+        const paginatedResponse = {
+            total,
+            count: conversations.length,
+            offset: parsed.offset,
+            items: conversations,
+            has_more: hasMore,
+            next_offset: hasMore ? parsed.offset + conversations.length : undefined
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResponse(paginatedResponse, parsed.response_format, "conversation_list")
+                }
+            ]
+        };
+    }
+};
+//# sourceMappingURL=conversation-tools.js.map

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

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