语音代理管理服务器

ELEVENLABS_API_KEY=your_elevenlabs_api_key_here

claude mcp add --transport stdio elevenlabs-voice-agents \
  -e ELEVENLABS_API_KEY=your_key_here \
  -- npx -y elevenlabs-voice-agent-mcp

{
  "mcpServers": {
    "elevenlabs-voice-agents": {
      "command": "node",
      "args": [
        "/absolute/path/to/elevenlabs-voice-agent-mcp/dist/index.js"
      ],
      "env": {
        "ELEVENLABS_API_KEY": "your_elevenlabs_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "elevenlabs-voice-agents": {
      "command": "npx",
      "args": ["-y", "elevenlabs-voice-agent-mcp"],
      "env": { "ELEVENLABS_API_KEY": "your_key_here" }
    }
  }
}

{
  "mcpServers": {
    "elevenlabs-voice-agents": {
      "command": "node",
      "args": ["/absolute/path/to/elevenlabs-voice-agent-mcp/dist/index.js"],
      "env": { "ELEVENLABS_API_KEY": "your_key_here" }
    }
  }
}

{
  "mcpServers": {
    "elevenlabs-voice-agents": {
      "url": "https://your-hosted-mcp.example.com/mcp",
      "type": "http"
    }
  }
}

{
  "mcpServers": {
    "elevenlabs-voice-agents": {
      "command": "npx",
      "args": ["-y", "elevenlabs-voice-agent-mcp"],
      "env": { "ELEVENLABS_API_KEY": "your_key_here" }
    }
  }
}

claude mcp add --transport stdio elevenlabs-voice-agents \
  -e ELEVENLABS_API_KEY=your_key_here \
  -- npx -y elevenlabs-voice-agent-mcp

codex mcp add --transport stdio elevenlabs-voice-agents \
  -e ELEVENLABS_API_KEY=your_key_here \
  -- npx -y elevenlabs-voice-agent-mcp

{
  "servers": {
    "elevenlabs-voice-agents": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "elevenlabs-voice-agent-mcp"],
      "env": { "ELEVENLABS_API_KEY": "your_key_here" }
    }
  }
}

elevenlabs_import_phone_number({
  phone_number: "+14155551234",
  label: "Sales Line",
  sid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxx",  // Your Twilio Account SID
  token: "your_twilio_auth_token",
  provider: "twilio",
  supports_inbound: true,
  supports_outbound: true
})
// Returns: { phone_number_id: "pn_abc123" }

elevenlabs_update_phone_number({
  phone_number_id: "pn_abc123",
  agent_id: "ag_xyz789"
})

elevenlabs_start_outbound_call({
  agent_id: "ag_xyz789",
  agent_phone_number_id: "pn_abc123",
  to_number: "+19175551234",
  conversation_initiation_client_data: {
    dynamic_variables: {
      customer_name: "John Smith",
      account_balance: 1500
    }
  }
})

elevenlabs_submit_batch_call({
  call_name: "Q4 Customer Survey",
  agent_id: "ag_xyz789",
  agent_phone_number_id: "pn_abc123",
  recipients: [
    {
      phone_number: "+14155551234",
      conversation_initiation_client_data: {
        dynamic_variables: {
          name: "Alice Johnson",
          account_id: "A123"
        }
      }
    },
    {
      phone_number: "+19175555678",
      conversation_initiation_client_data: {
        dynamic_variables: {
          name: "Bob Williams",
          account_id: "B456"
        }
      }
    }
  ]
})

elevenlabs_get_batch_call({
  batch_id: "batch_abc123"
})
// Shows status for each recipient: completed, in_progress, failed, voicemail, etc.

// Create a basic customer service agent
elevenlabs_create_agent({
  name: "Customer Support Bot",
  prompt: "You are a helpful customer service agent for TechCorp. Be friendly, professional, and solve customer issues efficiently.",
  llm: "gpt-4o-mini",
  voice_id: "21m00Tcm4TlvDq8ikWAM",
  first_message: "Hi! How can I help you today?",
  language: "en"
})

// Add company documentation
elevenlabs_add_knowledge_base({
  agent_id: "ag_abc123",
  documents: [
    {
      type: "url",
      content: "https://example.com/company-policies"
    },
    {
      type: "text",
      content: "Our support hours are Monday-Friday, 9 AM to 6 PM EST."
    }
  ]
})

// Add order status checking capability
elevenlabs_create_webhook_tool({
  agent_id: "ag_abc123",
  name: "check_order_status",
  description: "Check the status of a customer order by order ID",
  url: "https://api.example.com/orders/status",
  method: "POST",
  parameters: [
    {
      name: "order_id",
      type: "string",
      description: "The unique order identifier",
      required: true
    }
  ]
})

// Generate widget code for testing
elevenlabs_generate_widget_code({
  agent_id: "ag_abc123",
  color: "#4A90E2",
  avatar_url: "https://example.com/avatar.png"
})

// List recent conversations
elevenlabs_list_conversations({
  agent_id: "ag_abc123",
  limit: 10,
  status: "completed"
})

// Get full transcript
elevenlabs_get_conversation({
  conversation_id: "conv_xyz789"
})

elevenlabs_get_agent({
  agent_id: "ag_abc123",
  response_format: "json"
})

elevenlabs_list_agents({
  limit: 20,      // Items per page (1-100)
  offset: 0       // Skip this many items
})

elevenlabs-voice-agent-mcp/
├── src/
│   ├── index.ts                 # Server initialization & tool registration
│   ├── types.ts                 # TypeScript interfaces for all entities
│   ├── constants.ts             # API URLs, limits, and defaults
│   ├── schemas/                 # Zod validation schemas
│   │   ├── agent-schemas.ts     # Agent CRUD schemas
│   │   ├── tool-schemas.ts      # Webhook tool & knowledge base schemas
│   │   ├── conversation-schemas.ts
│   │   ├── outbound-schemas.ts  # Single call schemas
│   │   ├── batch-calling-schemas.ts
│   │   ├── phone-number-schemas.ts
│   │   └── common-schemas.ts    # Shared schemas (pagination, etc.)
│   ├── services/                # API clients and utilities
│   │   ├── elevenlabs-api.ts    # HTTP client with auth
│   │   └── formatters.ts        # Response formatting (Markdown/JSON)
│   ├── tools/                   # MCP tool implementations
│   │   ├── agent-tools.ts       # CRUD for agents
│   │   ├── knowledge-tools.ts   # Knowledge base management
│   │   ├── tool-tools.ts        # Webhook tool management
│   │   ├── conversation-tools.ts
│   │   ├── utility-tools.ts     # Voices, widgets
│   │   ├── outbound-tools.ts    # Single outbound calls
│   │   ├── batch-calling-tools.ts
│   │   └── phone-number-tools.ts
│   └── utils/                   # Helper functions
│       ├── error-handlers.ts    # Error parsing & messages
│       ├── truncation.ts        # Response size management
│       └── phone-normalizer.ts  # E.164 format conversion
├── dist/                        # Compiled JavaScript (gitignored)
├── test/                        # Test files
└── CLAUDE.md                    # AI assistant guidance

# Run all unit tests
npm test

# Run tests in watch mode (re-runs on file changes)
npm run test:watch

# Run tests with coverage report
npm run test:coverage

# Run tests with UI (browser-based test runner)
npm run test:ui

# TypeScript type checking for test files
npm run test:types

# Run integration tests (requires API key)
npm run test:integration

src/__tests__/
├── mocks/
│   └── fixtures.ts          # Mock data and test fixtures
├── schemas/
│   └── schemas.test.ts      # Zod schema validation tests
├── services/
│   ├── elevenlabs-api.test.ts  # API client tests
│   └── formatters.test.ts      # Response formatter tests
├── tools/
│   ├── agent-tools.test.ts        # Agent CRUD tests
│   ├── batch-calling-tools.test.ts
│   ├── conversation-tools.test.ts
│   ├── knowledge-tools.test.ts
│   ├── outbound-tools.test.ts
│   ├── phone-number-tools.test.ts
│   ├── tool-tools.test.ts
│   └── utility-tools.test.ts
├── utils/
│   ├── error-handlers.test.ts
│   └── truncation.test.ts
└── setup.ts                 # Test environment setup

// Import leads from CSV and call them all
elevenlabs_submit_batch_call({
  call_name: "Lead Qualification Q1",
  agent_id: "ag_sales",
  recipients: [
    { phone_number: "+1...", conversation_initiation_client_data: { name: "...", company: "..." } },
    // ... up to 10,000 recipients
  ]
})

// Call customers with personalized reminders
elevenlabs_start_outbound_call({
  agent_id: "ag_scheduler",
  agent_phone_number_id: "pn_main",
  to_number: "+14155551234",
  conversation_initiation_client_data: {
    dynamic_variables: {
      patient_name: "Sarah",
      appointment_time: "3:00 PM tomorrow",
      doctor_name: "Dr. Smith"
    }
  }
})

// Batch call for post-purchase surveys
elevenlabs_submit_batch_call({
  call_name: "Post-Purchase NPS Survey",
  agent_id: "ag_survey",
  recipients: recentCustomers.map(c => ({
    phone_number: c.phone,
    conversation_initiation_client_data: {
      dynamic_variables: {
        name: c.name,
        product: c.lastPurchase,
        order_id: c.orderId
      }
    }
  }))
})