Retellai Voice Services

🚀 RetellAI MCP Server

A Model Context Protocol (MCP) server implemented for RetellAI, enabling AI assistants to interact with RetellAI's voice services.

🚀 Quick Start

The RetellAI MCP server is a powerful tool that allows AI assistants to interact with RetellAI's voice services. Here's a quick guide on how to get started.

✨ Features

The RetellAI MCP server offers the following features:

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

📚 Documentation

Claude Desktop Setup

1. Open Claude Desktop and press CMD + , to access Settings.
2. Click on the Developer tab.
3. Click the Edit Configuration button.
4. This will open the claude_desktop_config.json folder in your file explorer.
5. Obtain your Retell API key from the Retell dashboard (https://dashboard.retellai.com/apiKey).
6. Add the following content to your claude_desktop_config.json file. For more details, refer to here.
7. Restart Claude Desktop after editing the configuration file.

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

Example Use Cases

1. List all my phone numbers on RetellAI.
2. List all my agents.
3. Tell me more about the pizza delivery agent.
4. Example of creating an agent and making a call:
   1. Create an agent to call my local pizza shop, ensuring the conversation is short and to the point.
   2. Order a Margherita pizza.
   3. Pay by cash on delivery.
   4. Send it to
      .
   5. The agent should pretend to be me. My name is .
   6. Call my local pizza shop using a US phone number .

Repository Setup

1. Install dependencies:

   npm i
   

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

   RETELL_API_KEY=your_api_key_here
   

3. Run the server:

   node src/retell/index.js
   

💻 Usage Examples

Basic Usage

The following are some basic usage examples of the RetellAI MCP server:

• List all phone numbers:

  # Assume there is a corresponding command to list phone numbers
  command_to_list_phone_numbers
  

• List all agents:

  # Assume there is a corresponding command to list agents
  command_to_list_agents
  

Advanced Usage

The following is an example of creating an agent and making a call:

# Assume there are corresponding commands to create an agent and make a call
command_to_create_agent_and_call

🔧 Technical Details

Available Tools

Call Tools

• list_calls: List all Retell calls.
• create_phone_call: Create a new phone call.
• create_web_call: Create a new web call.
• get_call: Get details of a specific call.
• delete_call: Delete a specific call.

Agent Tools

• list_agents: List all Retell agents.
• create_agent: Create a new Retell agent.
• get_agent: Get a Retell agent by ID.
• update_agent: Update an existing Retell agent.
• delete_agent: Delete a Retell agent.
• get_agent_versions: Get all versions of a Retell agent.

Phone Number Tools

• list_phone_numbers: List all Retell phone numbers.
• create_phone_number: Create a new phone number.
• get_phone_number: Get details of a specific phone number.
• update_phone_number: Update a phone number.
• delete_phone_number: Delete a phone number.

Voice Tools

• list_voices: List all available Retell voices.
• get_voice: Get details of a specific voice.

📄 License

This project is licensed under the MIT license.