RetellAI

Interactúa con los servicios de voz de RetellAI para crear IA de voz conversacional.

Documentación

Servidor MCP de RetellAI

Esta es una implementación del servidor del Model Context Protocol (MCP) para RetellAI, que permite a los asistentes de IA interactuar con los servicios de voz de RetellAI.

Características

El servidor MCP de RetellAI proporciona herramientas para:

Gestión de llamadas: Crear y gestionar llamadas telefónicas y llamadas web
Gestión de agentes: Crear y gestionar agentes de voz con diferentes configuraciones de LLM
Gestión de números de teléfono: Aprovisionar y configurar números de teléfono
Gestión de voces: Acceder y utilizar diferentes opciones de voz

Configuración de Claude Desktop

Abre Claude Desktop y presiona CMD + , para ir a Settings.
Haz clic en la pestaña Developer.
Haz clic en el botón Edit Config.
Esto abrirá el archivo claude_desktop_config.json en tu explorador de archivos.
Obtén tu clave de API de Retell desde el panel de Retell (https://dashboard.retellai.com/apiKey).
Añade lo siguiente a tu archivo claude_desktop_config.json. Consulta aquí para más detalles.
Reinicia Claude Desktop después de editar el archivo de configuración.

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

Solución de problemas: "No hay herramientas disponibles"

Si Claude Desktop muestra el servidor pero no las herramientas, actualiza a la última versión del paquete:

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

Este problema suele estar causado por una discrepancia de dependencias/versiones en instalaciones antiguas.

Ejemplos de casos de uso:

Lista todos los números que tengo en retellai
Lista todos los agentes que tengo
Cuéntame más sobre el agente de entrega de pizza
Ejemplo de creación de agente y llamada:
1. Crea un agente que llame a mi pizzería local, asegúrate de mantener la conversación breve y concisa.
2. Pide una pizza margarita
3. El pago se realizará en efectivo contra reembolso
4. Envíalo a
5. El agente debe hacerse pasar por mí. Mi nombre es <your_name>
6. Haz una llamada saliente a mi pizzería local al <phone_number>, usando el número de usa

Configuración del repositorio

Instala las dependencias:
```
npm i
```
Crea un archivo .env con tu clave de API de RetellAI:
```
RETELL_API_KEY=your_api_key_here
```
Ejecuta el servidor:
```
node src/retell/index.js
```

Herramientas disponibles

Herramientas de llamadas

list_calls: Lista todas las llamadas de Retell
create_phone_call: Crea una nueva llamada telefónica
create_web_call: Crea una nueva llamada web
get_call: Obtiene los detalles de una llamada específica
delete_call: Elimina una llamada específica

Herramientas de agentes

list_agents: Lista todos los agentes de Retell
create_agent: Crea un nuevo agente de Retell
get_agent: Obtiene un agente de Retell por ID
update_agent: Actualiza un agente de Retell existente
delete_agent: Elimina un agente de Retell
get_agent_versions: Obtiene todas las versiones de un agente de Retell

Herramientas de números de teléfono

list_phone_numbers: Lista todos los números de teléfono de Retell
create_phone_number: Crea un nuevo número de teléfono
get_phone_number: Obtiene los detalles de un número de teléfono específico
update_phone_number: Actualiza un número de teléfono
delete_phone_number: Elimina un número de teléfono

Herramientas de voz

list_voices: Lista todas las voces disponibles de Retell
get_voice: Obtiene los detalles de una voz específica

Licencia

MIT