README.md•3.05 kB
# 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](https://modelcontextprotocol.io/quickstart/user) for more details.
7. Restart the Claude Desktop after editing the config file.
```json
{
"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 <address>
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:
```bash
npm i
```
2. Create a `.env` file with your RetellAI API key:
```
RETELL_API_KEY=your_api_key_here
```
3. Run the server:
```bash
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