retellai-mcp-server

RetellAI MCP Server

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>"
      }
    }
  }
}

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 <your_name>
   6. Make an outbound call to my local pizza shop at <phone_number>, 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