RetellAI Voice Services

This is a Model Context Protocol (MCP) server implementation for RetellAI, allowing AI assistants to interact with RetellAI's voice services.

Features

The RetellAI MCP server provides tools for:

• Call Management: Create and manage phone calls and web calls
• Agent Management: Create and manage voice agents with different LLM configurations
• Phone Number Management: Provision and configure phone numbers
• Voice Management: Access and use different voice options

Claude Desktop Setup

1. Open Claude Desktop and press CMD + , to go to Settings.
2. Click on the Developer tab.
3. Click on the Edit Config button.
4. This will open the claude_desktop_config.json file in your file explorer.
5. Get your Retell API key from the Retell dashboard (https://dashboard.retellai.com/apiKey).
6. Add the following to your claude_desktop_config.json file. See here for more details.
7. Restart the Claude Desktop after editing the config file.

{
  "mcpServers": {
    "retellai-mcp-server": {
      "command": "npx",
      "args": ["-y", "@abhaybabbar/retellai-mcp-server"],
      "env": {
        "RETELL_API_KEY": "<your_retellai_token>"
      }
    }
  }
}

Troubleshooting: "No tools available"

If Claude Desktop shows the server but no tools, upgrade to the latest package version:

npx -y @abhaybabbar/retellai-mcp-server@latest

This issue is typically caused by dependency/version mismatch in older installs.

Example use cases:

1. List all the numbers I have in retellai
2. List all the agents I have
3. Tell me more about pizza delivery agent
4. Creating agent and calling example:
   1. Create an agent that calls my local pizza shop, make sure to keep the conversation short and to the point.
   2. Order a margeritta pizza
   3. Payment will be done by cash on delivery
   4. Send it to
   5. The agent should pretend to be me. My name is
   6. Make an outbound call to my local pizza shop at , using the usa number

Repo Setup

1. Install dependencies:

   npm i
   

2. Create a .env file with your RetellAI API key:

   RETELL_API_KEY=your_api_key_here
   

3. Run the server:

   node src/retell/index.js
   

Available Tools

Call Tools

• list_calls: Lists all Retell calls
• create_phone_call: Creates a new phone call
• create_web_call: Creates a new web call
• get_call: Gets details of a specific call
• delete_call: Deletes a specific call

Agent Tools

• list_agents: Lists all Retell agents
• create_agent: Creates a new Retell agent
• get_agent: Gets a Retell agent by ID
• update_agent: Updates an existing Retell agent
• delete_agent: Deletes a Retell agent
• get_agent_versions: Gets all versions of a Retell agent

Phone Number Tools

• list_phone_numbers: Lists all Retell phone numbers
• create_phone_number: Creates a new phone number
• get_phone_number: Gets details of a specific phone number
• update_phone_number: Updates a phone number
• delete_phone_number: Deletes a phone number

Voice Tools

• list_voices: Lists all available Retell voices
• get_voice: Gets details of a specific voice

License

MIT