This is a Model Context Protocol (MCP) server implementation for RetellAI, allowing AI assistants to interact with RetellAI's voice services.
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
- Open
Claude Desktop
and pressCMD + ,
to go toSettings
. - Click on the
Developer
tab. - Click on the
Edit Config
button. - This will open the
claude_desktop_config.json
file in your file explorer. - Get your Retell API key from the Retell dashboard (
https://dashboard.retellai.com/apiKey). - Add the following to your
claude_desktop_config.json
file. Seehere for more details. - 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>"
}
}
}
}
- List all the numbers I have in retellai
- List all the agents I have
- Tell me more about pizza delivery agent
- Creating agent and calling example:
- Create an agent that calls my local pizza shop, make sure to keep the conversation short and to the point.
- Order a margeritta pizza
- Payment will be done by cash on delivery
- Send it to
- The agent should pretend to be me. My name is <your_name>
- Make an outbound call to my local pizza shop at <phone_number>, using the usa number
-
Install dependencies:
npm i
-
Create a
.env
file with your RetellAI API key:RETELL_API_KEY=your_api_key_here
-
Run the server:
node src/retell/index.js
list_calls
: Lists all Retell callscreate_phone_call
: Creates a new phone callcreate_web_call
: Creates a new web callget_call
: Gets details of a specific calldelete_call
: Deletes a specific call
list_agents
: Lists all Retell agentscreate_agent
: Creates a new Retell agentget_agent
: Gets a Retell agent by IDupdate_agent
: Updates an existing Retell agentdelete_agent
: Deletes a Retell agentget_agent_versions
: Gets all versions of a Retell agent
list_phone_numbers
: Lists all Retell phone numberscreate_phone_number
: Creates a new phone numberget_phone_number
: Gets details of a specific phone numberupdate_phone_number
: Updates a phone numberdelete_phone_number
: Deletes a phone number
list_voices
: Lists all available Retell voicesget_voice
: Gets details of a specific voice
MIT