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.

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