retellai-mcp-server

MCP.Pizza Chef: abhaybabbar

The retellai-mcp-server is a Model Context Protocol server that integrates RetellAI's voice services with AI assistants. It enables management of phone and web calls, voice agents with customizable LLM configurations, phone number provisioning, and voice options. This server facilitates seamless AI interaction with telephony and voice agent workflows, enhancing automated communication capabilities within RetellAI's ecosystem.

Use This MCP server To

Create and manage phone and web calls via AI Provision and configure phone numbers programmatically Manage voice agents with different LLM configurations Access and utilize various voice options for calls Integrate AI assistants with RetellAI voice services Automate call workflows using AI-driven commands

README

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

retellai-mcp-server FAQ

How do I configure the retellai-mcp-server with Claude Desktop?
Open Claude Desktop settings, edit the config file, and add your Retell API key as per the documentation.
What voice management features does this MCP server provide?
It allows access to and usage of different voice options for calls and agents.
Can I manage phone numbers using this MCP server?
Yes, you can provision and configure phone numbers programmatically.
How does the server support agent management?
It enables creation and management of voice agents with customizable LLM configurations.
Is the retellai-mcp-server compatible with multiple LLM providers?
Yes, it supports integration with various LLMs like OpenAI, Claude, and Gemini through MCP.
Where can I get the Retell API key?
You can obtain it from the Retell dashboard at https://dashboard.retellai.com/apiKey.
What types of calls can be managed?
Both phone calls and web calls can be created and managed via this server.
Does this server support secure API key handling?
Yes, MCP principles ensure secure, scoped, and observable interactions with API keys and services.