@mindstone/mcp-server-elevenlabs-agents

ElevenLabs Conversational AI MCP server for Model Context Protocol hosts. Inspect and author voice agents, review conversation transcripts and recordings, manage phone-number assignments, place outbound calls, submit or monitor scheduled batch calls, and write to the knowledge base through the ElevenLabs ConvAI API.

Status

• Version: bootstrap placeholder 0.0.0 until the first publish stage
• Auth: API key (ELEVENLABS_API_KEY)
• Tools: 24 (configure, agents, conversations, phone numbers, outbound calls, batch calls, knowledge base)
• Surface: cloud-api
• Machine-readable: STATUS.json

Requirements

• Node.js 20+
• npm
• An ElevenLabs API key with Conversational AI access

One-click install

After clicking the button, your host will prompt you to fill: ELEVENLABS_API_KEY.

{
  "mcpServers": {
    "ElevenLabs Agents": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-elevenlabs-agents"
      ],
      "env": {
        "ELEVENLABS_API_KEY": ""
      }
    }
  }
}

Quick Start

Install & build

cd <path-to-repo>/connectors/elevenlabs-agents
npm install
npm run build

Local

node dist/index.js

Configuration

Environment variables

• ELEVENLABS_API_KEY — ElevenLabs API key (starts with sk_)
• MCP_WORKSPACE_PATH — optional sandbox root for knowledge-base file uploads
• MCP_HOST_BRIDGE_STATE — optional path to a host bridge state file used for credential management
• MINDSTONE_REBEL_BRIDGE_STATE — backwards-compatible alias for MCP_HOST_BRIDGE_STATE

Host configuration example

{
  "mcpServers": {
    "ElevenLabs Agents": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/elevenlabs-agents/dist/index.js"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key"
      }
    }
  }
}

Tools (24)

Configuration

• configure_elevenlabs_agents_api_key — Save your ElevenLabs API key

Agents

• list_agents — List voice agents in the workspace
• get_agent — Get one agent, including prompts and nested conversation config
• create_agent — Create a new agent from a user-friendly authoring surface
• update_agent — Partially update one agent via PATCH deep-merge semantics
• duplicate_agent — Duplicate an existing agent before experimenting
• delete_agent — Permanently remove an agent
• simulate_conversation — Test an agent with a simulated user message before telephony work

Conversations

• list_conversations — List conversations, optionally filtered by agent/date/success
• get_conversation — Get a full conversation transcript and analysis
• get_conversation_audio — Download the conversation recording to a tmp file

Phone numbers

• list_phone_numbers — List configured phone numbers
• get_phone_number — Get one phone number and its label/assignment
• update_phone_number — Update one phone number label and/or assigned agent

Outbound calls

• make_outbound_call — Place one outbound call after resolving the phone-number provider automatically

Batch calls

• submit_batch_call — Submit a multi-recipient batch, optionally scheduled for the future
• list_batch_calls — List recent batch-call jobs in the workspace
• get_batch_call — Inspect one batch job, including per-recipient statuses
• cancel_batch_call — Cancel a queued or scheduled batch job
• retry_batch_call — Retry a previously submitted batch job

Knowledge base

• list_knowledge_base_docs — List knowledge-base documents
• get_knowledge_base_doc — Get one knowledge-base document (metadata + /content body, capped ~50KB)
• add_knowledge_base_document — Add a KB document in text, file, or URL mode
• delete_knowledge_base_document — Delete a KB document, optionally with force

Security notes

All external text returned by the ElevenLabs API is wrapped in <untrusted-content> envelopes before it reaches the model. This is especially important for conversation transcripts, which can contain attacker-controlled caller speech.

Outbound numbers are validated in E.164 format before any billing-surface call is sent upstream. Scheduled batches run on ElevenLabs' servers even if the client app is closed, so they should be monitored with list_batch_calls / get_batch_call and stopped with cancel_batch_call when needed.

Licence

FSL-1.1-MIT — Functional Source License, Version 1.1, with MIT future licence. The software converts to MIT licence on 2030-04-08.