elevenlabs-voice-agent-mcp 1.0.2 → 1.0.3

package/src/constants.ts

@@ -1,62 +0,0 @@
-/**
- * Constants for ElevenLabs Voice Agent MCP Server
- *
- * Contains API URLs, character limits, default values, and supported options
- * for ElevenLabs Voice Agent API integration.
- */
-
-export const API_BASE_URL = "https://api.elevenlabs.io/v1";
-
-// Response limits
-export const CHARACTER_LIMIT = 25000;
-export const DEFAULT_LIMIT = 20;
-export const MAX_LIMIT = 100;
-
-// Default configuration values
-export const DEFAULT_LLM = "gpt-4o-mini";
-export const DEFAULT_VOICE_MODEL = "eleven_flash_v2_5";
-export const DEFAULT_VOICE_ID = "21m00Tcm4TlvDq8ikWAM"; // Rachel voice
-export const DEFAULT_LANGUAGE = "en";
-
-// Supported LLM models
-export const SUPPORTED_LLMS = [
-  "gpt-4o",
-  "gpt-4o-mini",
-  "claude-3-5-sonnet-20241022",
-  "claude-3-5-haiku-20241022",
-  "gemini-2.0-flash-exp"
-] as const;
-
-// Supported voice models
-export const SUPPORTED_VOICE_MODELS = [
-  "eleven_turbo_v2_5",
-  "eleven_flash_v2_5",
-  "eleven_multilingual_v2"
-] as const;
-
-// Supported languages
-export const SUPPORTED_LANGUAGES = [
-  "en", "es", "fr", "de", "it", "pt", "pl", "nl", "ja", "zh", "ko", "ar", "hi"
-] as const;
-
-// Authentication types
-export const AUTH_TYPES = ["none", "manual", "open"] as const;
-
-// API timeouts
-export const REQUEST_TIMEOUT = 30000; // 30 seconds
-
-// Batch calling limits
-export const MAX_BATCH_RECIPIENTS = 10000;
-export const MIN_BATCH_RECIPIENTS = 1;
-
-// Phone providers
-export const PHONE_PROVIDERS = ["twilio", "sip_trunk"] as const;
-
-// Phone number regions
-export const REGION_IDS = ["us1", "ie1", "au1"] as const;
-
-// Edge locations
-export const EDGE_LOCATIONS = [
-  "ashburn", "dublin", "frankfurt", "sao-paulo",
-  "singapore", "sydney", "tokyo", "umatilla", "roaming"
-] as const;

package/src/index.ts

@@ -1,141 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * ElevenLabs Voice Agent MCP Server
- *
- * Main entry point for the MCP server providing tools for voice agent development.
- */
-
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { validateApiKey } from "./utils/error-handlers.js";
-
-// Import all tools
-import {
-  elevenlabs_create_agent,
-  elevenlabs_get_agent,
-  elevenlabs_update_agent,
-  elevenlabs_delete_agent,
-  elevenlabs_list_agents
-} from "./tools/agent-tools.js";
-
-import { elevenlabs_add_knowledge_base } from "./tools/knowledge-tools.js";
-
-import {
-  elevenlabs_create_webhook_tool,
-  elevenlabs_list_tools,
-  elevenlabs_delete_tool
-} from "./tools/tool-tools.js";
-
-import {
-  elevenlabs_get_conversation,
-  elevenlabs_list_conversations
-} from "./tools/conversation-tools.js";
-
-import {
-  elevenlabs_generate_widget_code,
-  elevenlabs_list_voices
-} from "./tools/utility-tools.js";
-
-import { elevenlabs_start_outbound_call } from "./tools/outbound-tools.js";
-
-import {
-  elevenlabs_submit_batch_call,
-  elevenlabs_list_batch_calls,
-  elevenlabs_get_batch_call
-} from "./tools/batch-calling-tools.js";
-
-import {
-  elevenlabs_list_phone_numbers,
-  elevenlabs_get_phone_number,
-  elevenlabs_import_phone_number,
-  elevenlabs_update_phone_number,
-  elevenlabs_delete_phone_number
-} from "./tools/phone-number-tools.js";
-
-/**
- * Initialize and start the MCP server
- */
-async function main() {
-  // Validate API key on startup
-  try {
-    validateApiKey();
-  } catch (error) {
-    console.error("Failed to start MCP server:", error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  }
-
-  // Create MCP server instance
-  const server = new McpServer({
-    name: "elevenlabs-voice-agent-mcp",
-    version: "1.0.0"
-  });
-
-  // Register all tools
-  const tools = [
-    // Tier 1: Core Agent Management
-    elevenlabs_create_agent,
-    elevenlabs_get_agent,
-    elevenlabs_update_agent,
-    elevenlabs_delete_agent,
-    elevenlabs_list_agents,
-
-    // Tier 2: Knowledge Base & Tools
-    elevenlabs_add_knowledge_base,
-    elevenlabs_create_webhook_tool,
-    elevenlabs_list_tools,
-    elevenlabs_delete_tool,
-
-    // Tier 3: Testing & Monitoring
-    elevenlabs_get_conversation,
-    elevenlabs_list_conversations,
-    elevenlabs_generate_widget_code,
-
-    // Tier 4: Utilities
-    elevenlabs_list_voices,
-
-    // Tier 5: Outbound Calling & Phone Management
-    elevenlabs_start_outbound_call,
-    elevenlabs_submit_batch_call,
-    elevenlabs_list_batch_calls,
-    elevenlabs_get_batch_call,
-    elevenlabs_list_phone_numbers,
-    elevenlabs_get_phone_number,
-    elevenlabs_import_phone_number,
-    elevenlabs_update_phone_number,
-    elevenlabs_delete_phone_number
-  ];
-
-  // Register each tool with the server
-  for (const tool of tools) {
-    const zodSchema = (tool as any).zodSchema;
-    const annotations = (tool as any).annotations;
-
-    server.registerTool(
-      tool.name,
-      {
-        description: tool.description,
-        ...(zodSchema && { inputSchema: zodSchema }),
-        ...(annotations && { annotations })
-      },
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      tool.handler as any
-    );
-  }
-
-  // Set up stdio transport
-  const transport = new StdioServerTransport();
-
-  // Connect server to transport
-  await server.connect(transport);
-
-  console.error("ElevenLabs Voice Agent MCP server running on stdio");
-  console.error(`Registered ${tools.length} tools`);
-  console.error("API Key:", process.env.ELEVENLABS_API_KEY ? "✓ Set" : "✗ Not set");
-}
-
-// Start the server
-main().catch((error) => {
-  console.error("Fatal error:", error);
-  process.exit(1);
-});

package/src/schemas/agent-schemas.ts

@@ -1,193 +0,0 @@
-/**
- * Zod validation schemas for agent-related operations
- *
- * Provides strict input validation for creating, updating, and managing agents.
- */
-
-import { z } from "zod";
-import {
-  SUPPORTED_LLMS,
-  SUPPORTED_VOICE_MODELS,
-  SUPPORTED_LANGUAGES,
-  DEFAULT_LLM,
-  DEFAULT_VOICE_MODEL,
-  DEFAULT_VOICE_ID,
-  DEFAULT_LANGUAGE
-} from "../constants.js";
-import {
-  ResponseFormatSchema,
-  LimitSchema,
-  OffsetSchema,
-  AgentIdSchema,
-  VoiceIdSchema,
-  ColorSchema,
-  URLSchema
-} from "./common-schemas.js";
-
-/**
- * Schema for creating a new agent
- */
-export const CreateAgentSchema = z.object({
-  name: z.string()
-    .min(1, "Agent name is required")
-    .max(100, "Name must not exceed 100 characters")
-    .describe("Display name for the agent (e.g., 'Customer Support Bot')"),
-
-  prompt: z.string()
-    .min(10, "Prompt must be at least 10 characters")
-    .max(5000, "Prompt must not exceed 5000 characters")
-    .describe("System prompt defining agent behavior and personality"),
-
-  llm: z.enum(SUPPORTED_LLMS, {
-    errorMap: () => ({ message: `LLM must be one of: ${SUPPORTED_LLMS.join(", ")}` })
-  })
-    .default(DEFAULT_LLM)
-    .describe(`LLM model to use (default: ${DEFAULT_LLM})`),
-
-  voice_id: VoiceIdSchema
-    .default(DEFAULT_VOICE_ID)
-    .describe(`ElevenLabs voice ID (default: ${DEFAULT_VOICE_ID} - Rachel)`),
-
-  voice_model: z.enum(SUPPORTED_VOICE_MODELS, {
-    errorMap: () => ({ message: `Voice model must be one of: ${SUPPORTED_VOICE_MODELS.join(", ")}` })
-  })
-    .default(DEFAULT_VOICE_MODEL)
-    .describe(`Voice model to use (default: ${DEFAULT_VOICE_MODEL})`),
-
-  first_message: z.string()
-    .max(500, "First message must not exceed 500 characters")
-    .optional()
-    .describe("Optional greeting message the agent will say first"),
-
-  language: z.enum(SUPPORTED_LANGUAGES, {
-    errorMap: () => ({ message: `Language must be one of: ${SUPPORTED_LANGUAGES.join(", ")}` })
-  })
-    .default(DEFAULT_LANGUAGE)
-    .describe(`Primary language code (default: ${DEFAULT_LANGUAGE})`),
-
-  temperature: z.number()
-    .min(0, "Temperature must be between 0 and 2")
-    .max(2, "Temperature must be between 0 and 2")
-    .optional()
-    .describe("LLM temperature for response randomness (0-2, higher = more creative)"),
-
-  max_tokens: z.number()
-    .int("Max tokens must be an integer")
-    .min(1, "Max tokens must be at least 1")
-    .max(4096, "Max tokens must not exceed 4096")
-    .optional()
-    .describe("Maximum tokens for LLM responses"),
-
-  stability: z.number()
-    .min(0, "Stability must be between 0 and 1")
-    .max(1, "Stability must be between 0 and 1")
-    .optional()
-    .describe("Voice stability (0-1, higher = more consistent)"),
-
-  similarity_boost: z.number()
-    .min(0, "Similarity boost must be between 0 and 1")
-    .max(1, "Similarity boost must be between 0 and 1")
-    .optional()
-    .describe("Voice similarity boost (0-1, higher = closer to original voice)"),
-
-  widget_color: ColorSchema.optional().describe("Widget theme color"),
-
-  widget_avatar_url: URLSchema.optional().describe("Widget avatar image URL"),
-
-  response_format: ResponseFormatSchema
-}).passthrough();
-
-/**
- * Schema for getting an agent by ID
- */
-export const GetAgentSchema = z.object({
-  agent_id: AgentIdSchema,
-  response_format: ResponseFormatSchema
-}).passthrough();
-
-/**
- * Schema for updating an agent
- */
-export const UpdateAgentSchema = z.object({
-  agent_id: AgentIdSchema,
-
-  name: z.string()
-    .min(1, "Agent name cannot be empty")
-    .max(100, "Name must not exceed 100 characters")
-    .optional()
-    .describe("New display name for the agent"),
-
-  prompt: z.string()
-    .min(10, "Prompt must be at least 10 characters")
-    .max(5000, "Prompt must not exceed 5000 characters")
-    .optional()
-    .describe("Updated system prompt"),
-
-  llm: z.enum(SUPPORTED_LLMS)
-    .optional()
-    .describe("Updated LLM model"),
-
-  voice_id: VoiceIdSchema
-    .optional()
-    .describe("Updated voice ID"),
-
-  voice_model: z.enum(SUPPORTED_VOICE_MODELS)
-    .optional()
-    .describe("Updated voice model"),
-
-  first_message: z.string()
-    .max(500, "First message must not exceed 500 characters")
-    .optional()
-    .describe("Updated first message"),
-
-  language: z.enum(SUPPORTED_LANGUAGES)
-    .optional()
-    .describe("Updated language"),
-
-  temperature: z.number()
-    .min(0)
-    .max(2)
-    .optional()
-    .describe("Updated temperature"),
-
-  max_tokens: z.number()
-    .int()
-    .min(1)
-    .max(4096)
-    .optional()
-    .describe("Updated max tokens"),
-
-  stability: z.number()
-    .min(0)
-    .max(1)
-    .optional()
-    .describe("Updated voice stability"),
-
-  similarity_boost: z.number()
-    .min(0)
-    .max(1)
-    .optional()
-    .describe("Updated similarity boost"),
-
-  widget_color: ColorSchema.optional().describe("Updated widget color"),
-
-  widget_avatar_url: URLSchema.optional().describe("Updated widget avatar URL"),
-
-  response_format: ResponseFormatSchema
-}).passthrough();
-
-/**
- * Schema for deleting an agent
- */
-export const DeleteAgentSchema = z.object({
-  agent_id: AgentIdSchema
-}).passthrough();
-
-/**
- * Schema for listing agents
- */
-export const ListAgentsSchema = z.object({
-  limit: LimitSchema,
-  offset: OffsetSchema,
-  response_format: ResponseFormatSchema
-}).passthrough();

package/src/schemas/batch-calling-schemas.ts

@@ -1,96 +0,0 @@
-/**
- * Zod validation schemas for batch calling operations
- *
- * Provides strict input validation for submitting batch call jobs,
- * listing batch calls, and retrieving batch call details.
- */
-
-import { z } from "zod";
-import { ResponseFormatSchema, AgentIdSchema, LimitSchema } from "./common-schemas.js";
-import { PhoneNumberSchema, PhoneNumberIdSchema } from "./outbound-schemas.js";
-
-/**
- * Batch ID schema
- */
-export const BatchIdSchema = z.string()
-  .min(1, "Batch ID is required")
-  .regex(/^[a-zA-Z0-9_-]+$/, "Batch ID must contain only alphanumeric characters, hyphens, and underscores")
-  .describe("Unique identifier for the batch call job");
-
-/**
- * Recipient schema for batch calling
- */
-export const OutboundCallRecipientSchema = z.object({
-  id: z.string()
-    .optional()
-    .describe("Optional recipient identifier for tracking"),
-
-  phone_number: PhoneNumberSchema
-    .optional()
-    .describe("Recipient phone number (required if whatsapp_user_id not provided)"),
-
-  whatsapp_user_id: z.string()
-    .optional()
-    .describe("WhatsApp user ID (alternative to phone_number)"),
-
-  conversation_initiation_client_data: z.record(z.any())
-    .optional()
-    .describe("Personalization data for this recipient (e.g., {dynamic_variables: {name: 'John', account_id: '123'}})")
-}).refine(
-  (data) => data.phone_number || data.whatsapp_user_id,
-  {
-    message: "Either phone_number or whatsapp_user_id must be provided"
-  }
-);
-
-/**
- * Schema for submitting a batch call job
- */
-export const SubmitBatchCallSchema = z.object({
-  call_name: z.string()
-    .min(1, "Call name is required")
-    .max(200, "Call name must not exceed 200 characters")
-    .describe("Descriptive name for this batch call job"),
-
-  agent_id: AgentIdSchema,
-
-  recipients: z.array(OutboundCallRecipientSchema)
-    .min(1, "At least one recipient is required")
-    .max(10000, "Maximum 10,000 recipients per batch")
-    .describe("Array of recipients to call"),
-
-  scheduled_time_unix: z.number()
-    .int("Scheduled time must be a Unix timestamp")
-    .positive("Scheduled time must be in the future")
-    .optional()
-    .describe("Optional Unix timestamp to schedule the batch for future execution"),
-
-  agent_phone_number_id: PhoneNumberIdSchema
-    .optional()
-    .describe("Phone number to use as caller ID (optional)"),
-
-  response_format: ResponseFormatSchema
-}).passthrough();
-
-/**
- * Schema for listing batch calls
- */
-export const ListBatchCallsSchema = z.object({
-  limit: LimitSchema,
-
-  last_doc: z.string()
-    .optional()
-    .nullable()
-    .describe("Pagination cursor from previous response"),
-
-  response_format: ResponseFormatSchema
-}).passthrough();
-
-/**
- * Schema for getting batch call details
- */
-export const GetBatchCallSchema = z.object({
-  batch_id: BatchIdSchema,
-
-  response_format: ResponseFormatSchema
-}).passthrough();

package/src/schemas/common-schemas.ts

@@ -1,83 +0,0 @@
-/**
- * Common Zod validation schemas
- *
- * Shared schemas used across multiple tools for pagination,
- * formatting, and common parameters.
- */
-
-import { z } from "zod";
-import { DEFAULT_LIMIT, MAX_LIMIT } from "../constants.js";
-import { ResponseFormat } from "../types.js";
-
-/**
- * Response format schema (JSON or Markdown)
- */
-export const ResponseFormatSchema = z.nativeEnum(ResponseFormat, {
-  errorMap: () => ({ message: "Format must be 'json' or 'markdown'" })
-}).default(ResponseFormat.MARKDOWN).describe(
-  "Output format: 'markdown' for human-readable or 'json' for structured data"
-);
-
-/**
- * Pagination limit schema
- */
-export const LimitSchema = z.number()
-  .int("Limit must be an integer")
-  .min(1, "Limit must be at least 1")
-  .max(MAX_LIMIT, `Limit must not exceed ${MAX_LIMIT}`)
-  .default(DEFAULT_LIMIT)
-  .describe(`Maximum number of items to return (1-${MAX_LIMIT}, default: ${DEFAULT_LIMIT})`);
-
-/**
- * Pagination offset schema
- */
-export const OffsetSchema = z.number()
-  .int("Offset must be an integer")
-  .min(0, "Offset must be 0 or greater")
-  .default(0)
-  .describe("Number of items to skip for pagination (default: 0)");
-
-/**
- * Agent ID schema
- */
-export const AgentIdSchema = z.string()
-  .min(1, "Agent ID is required")
-  .regex(/^[a-zA-Z0-9_-]+$/, "Agent ID must contain only alphanumeric characters, hyphens, and underscores")
-  .describe("Unique identifier for the agent (e.g., 'ag_abc123')");
-
-/**
- * Conversation ID schema
- */
-export const ConversationIdSchema = z.string()
-  .min(1, "Conversation ID is required")
-  .regex(/^[a-zA-Z0-9_-]+$/, "Conversation ID must contain only alphanumeric characters, hyphens, and underscores")
-  .describe("Unique identifier for the conversation (e.g., 'conv_xyz789')");
-
-/**
- * Voice ID schema
- */
-export const VoiceIdSchema = z.string()
-  .min(1, "Voice ID is required")
-  .describe("ElevenLabs voice ID (e.g., '21m00Tcm4TlvDq8ikWAM' for Rachel)");
-
-/**
- * URL schema
- */
-export const URLSchema = z.string()
-  .url("Must be a valid URL")
-  .describe("A valid HTTP or HTTPS URL");
-
-/**
- * Color hex schema
- */
-export const ColorSchema = z.string()
-  .regex(/^#[0-9A-Fa-f]{6}$/, "Must be a valid hex color (e.g., #FF5733)")
-  .describe("Hex color code (e.g., '#FF5733')");
-
-/**
- * Date range schema
- */
-export const DateRangeSchema = z.object({
-  start: z.string().datetime().optional().describe("Start date in ISO 8601 format"),
-  end: z.string().datetime().optional().describe("End date in ISO 8601 format")
-}).optional().describe("Optional date range filter");

package/src/schemas/conversation-schemas.ts

@@ -1,44 +0,0 @@
-/**
- * Zod validation schemas for conversation operations
- *
- * Provides strict input validation for retrieving and managing conversations.
- */
-
-import { z } from "zod";
-import {
-  AgentIdSchema,
-  ConversationIdSchema,
-  ResponseFormatSchema,
-  LimitSchema,
-  OffsetSchema,
-  DateRangeSchema
-} from "./common-schemas.js";
-
-/**
- * Schema for getting a single conversation
- */
-export const GetConversationSchema = z.object({
-  conversation_id: ConversationIdSchema,
-  response_format: ResponseFormatSchema
-}).passthrough();
-
-/**
- * Schema for listing conversations
- */
-export const ListConversationsSchema = z.object({
-  agent_id: AgentIdSchema
-    .optional()
-    .describe("Optional: filter by agent ID"),
-
-  status: z.enum(["in_progress", "completed", "failed"])
-    .optional()
-    .describe("Optional: filter by conversation status"),
-
-  date_range: DateRangeSchema,
-
-  limit: LimitSchema,
-
-  offset: OffsetSchema,
-
-  response_format: ResponseFormatSchema
-}).passthrough();

package/src/schemas/outbound-schemas.ts

@@ -1,70 +0,0 @@
-/**
- * Zod validation schemas for outbound calling operations
- *
- * Provides strict input validation for making single outbound calls via Twilio.
- */
-
-import { z } from "zod";
-import { ResponseFormatSchema, AgentIdSchema } from "./common-schemas.js";
-
-/**
- * Phone number schema with E.164 format validation
- */
-export const PhoneNumberSchema = z.string()
-  .min(1, "Phone number is required")
-  .regex(/^\+?[1-9]\d{1,14}$/, "Phone number must be in E.164 format (e.g., +1234567890)")
-  .describe("Phone number in E.164 format (e.g., '+1234567890')");
-
-/**
- * Phone number ID schema
- */
-export const PhoneNumberIdSchema = z.string()
-  .min(1, "Phone number ID is required")
-  .regex(/^[a-zA-Z0-9_-]+$/, "Phone number ID must contain only alphanumeric characters, hyphens, and underscores")
-  .describe("Unique identifier for the phone number");
-
-/**
- * Config overrides schema for conversation customization
- */
-export const ConfigOverridesSchema = z.object({
-  agent: z.object({
-    first_message: z.string().optional(),
-    system_prompt: z.string().optional(),
-    language: z.string().optional()
-  }).optional(),
-  tts: z.object({
-    voice_id: z.string().optional(),
-    model_id: z.string().optional()
-  }).optional(),
-  turn: z.object({
-    mode: z.string().optional()
-  }).optional(),
-  conversation: z.object({
-    max_duration_seconds: z.number().int().positive().optional()
-  }).optional()
-}).optional().describe("Configuration overrides for this specific call");
-
-/**
- * Conversation initiation data schema
- */
-export const ConversationInitDataSchema = z.record(z.any())
-  .optional()
-  .describe("Dynamic variables and configuration overrides for personalization");
-
-/**
- * Schema for starting an outbound call
- */
-export const StartOutboundCallSchema = z.object({
-  agent_id: AgentIdSchema,
-
-  agent_phone_number_id: PhoneNumberIdSchema,
-
-  to_number: PhoneNumberSchema
-    .describe("Destination phone number to call"),
-
-  conversation_initiation_client_data: z.record(z.any())
-    .optional()
-    .describe("Personalization data including dynamic_variables object (e.g., {dynamic_variables: {name: 'John', user_id: '123'}})"),
-
-  response_format: ResponseFormatSchema
-}).passthrough();