RetellAI

Interaja com os serviços de voz da RetellAI para criar IA de voz conversacional.

Documentação

Servidor MCP RetellAI

Esta é uma implementação de servidor Model Context Protocol (MCP) para RetellAI, permitindo que assistentes de IA interajam com os serviços de voz da RetellAI.

Recursos

O servidor MCP RetellAI fornece ferramentas para:

Gerenciamento de Chamadas: Criar e gerenciar chamadas telefônicas e chamadas web
Gerenciamento de Agentes: Criar e gerenciar agentes de voz com diferentes configurações de LLM
Gerenciamento de Números de Telefone: Provisionar e configurar números de telefone
Gerenciamento de Voz: Acessar e usar diferentes opções de voz

Configuração do Claude Desktop

Abra Claude Desktop e pressione CMD + , para ir para Settings.
Clique na aba Developer.
Clique no botão Edit Config.
Isso abrirá o arquivo claude_desktop_config.json no seu explorador de arquivos.
Obtenha sua chave de API Retell no painel da Retell (https://dashboard.retellai.com/apiKey).
Adicione o seguinte ao seu arquivo claude_desktop_config.json. Veja aqui para mais detalhes.
Reinicie o Claude Desktop após editar o arquivo de configuração.

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

Solução de problemas: "Nenhuma ferramenta disponível"

Se o Claude Desktop mostrar o servidor, mas nenhuma ferramenta, atualize para a versão mais recente do pacote:

npx -y @abhaybabbar/retellai-mcp-server@latest

Esse problema geralmente é causado por incompatibilidade de dependência/versão em instalações mais antigas.

Exemplos de casos de uso:

Liste todos os números que tenho no retellai
Liste todos os agentes que tenho
Conte-me mais sobre o agente de entrega de pizza
Exemplo de criação de agente e chamada:
1. Crie um agente que ligue para minha pizzaria local, certifique-se de manter a conversa curta e objetiva.
2. Peça uma pizza margeritta
3. O pagamento será feito em dinheiro na entrega
4. Envie para
5. O agente deve fingir ser eu. Meu nome é <your_name>
6. Faça uma chamada de saída para minha pizzaria local em <phone_number>, usando o número dos EUA

Configuração do Repositório

Instale as dependências:
```
npm i
```
Crie um arquivo .env com sua chave de API RetellAI:
```
RETELL_API_KEY=your_api_key_here
```
Execute o servidor:
```
node src/retell/index.js
```

Ferramentas Disponíveis

Ferramentas de Chamada

list_calls: Lista todas as chamadas Retell
create_phone_call: Cria uma nova chamada telefônica
create_web_call: Cria uma nova chamada web
get_call: Obtém detalhes de uma chamada específica
delete_call: Exclui uma chamada específica

Ferramentas de Agente

list_agents: Lista todos os agentes Retell
create_agent: Cria um novo agente Retell
get_agent: Obtém um agente Retell por ID
update_agent: Atualiza um agente Retell existente
delete_agent: Exclui um agente Retell
get_agent_versions: Obtém todas as versões de um agente Retell

Ferramentas de Número de Telefone

list_phone_numbers: Lista todos os números de telefone Retell
create_phone_number: Cria um novo número de telefone
get_phone_number: Obtém detalhes de um número de telefone específico
update_phone_number: Atualiza um número de telefone
delete_phone_number: Exclui um número de telefone

Ferramentas de Voz

list_voices: Lista todas as vozes Retell disponíveis
get_voice: Obtém detalhes de uma voz específica

Licença

MIT