RetellAI

You use the RetellAI MCP Server to connect RetellAI’s voice services with your applications. This MCP server lets you manage calls, agents, phone numbers, and voices, enabling automated and programmable voice interactions through a standard MCP client.

How to use

You interact with the RetellAI MCP Server through an MCP client to accomplish practical tasks such as listing resources, creating calls, and managing agents. You can: list all calls, create and manage phone calls or web calls, create and manage voice agents with different configurations, provision and configure phone numbers, and access available voices.

How to install

Prerequisites: you need Node.js and npm installed on your system.

1. Install dependencies for the MCP server client-side package and the server itself.

2. Set up your environment with your RetellAI API key.

3. Run the MCP server and start interacting with it from your MCP client.

npm i

# Create the environment variable with your RetellAI API key
RETELL_API_KEY=your_api_key_here

# Run the MCP server (example startup command used by the repository setup)
node src/retell/index.js

Additional notes

To integrate with Claude Desktop, follow these steps to enable the RetellAI MCP server locally: open Claude Desktop, go to Settings, then Developer, click Edit Config, and modify the claude_desktop_config.json to point to the RetellAI MCP server. Use the provided configuration snippet to set your API key and server command.

{
  "mcpServers": {
    "retellai-mcp-server": {
      "command": "npx",
      "args": ["-y", "@abhaybabbar/retellai-mcp-server"],
      "env": {
        "RETELL_API_KEY": "<your_retellai_token>"
      }
    }
  }
}

Available tools

list_calls

Lists all Retell calls for monitoring and management.

create_phone_call

Creates a new phone call with configured parameters.

create_web_call

Creates a new web-based call session.

get_call

Retrieves details for a specific call by ID.

delete_call

Deletes a specific call.

list_agents

Lists all Retell agents currently configured.

create_agent

Creates a new Retell agent with specified configuration.

get_agent

Fetches details of 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.

list_phone_numbers

Lists all provisioned Retell phone numbers.

create_phone_number

Provisions a new Retell phone number.

get_phone_number

Gets details of a specific phone number by ID.

update_phone_number

Updates an existing phone number.

delete_phone_number

Deletes a phone number.

list_voices

Lists all available Retell voices.

get_voice

Gets details for a specific voice.