Telenow — AI Phone Calls & Voice Agents

npx add-mcp 'https://api.telenow.ai/mcp'

Telenow MCP Server

Permite que tu asistente de IA realice llamadas telefónicas reales.

Documentación · Referencia de herramientas · Protocolo y OAuth · Costos por minuto

Telenow es un servidor MCP remoto que le da a Claude, ChatGPT, Cursor, Grok, Gemini CLI y a cualquier cliente MCP un teléfono real. Realiza llamadas desde tus propios números de Telenow, obtén el resultado, el resumen y la transcripción, crea agentes de voz, cotiza el precio por minuto y ejecuta campañas de llamadas salientes.

Este repositorio solo contiene documentación y configuración de cliente. El servidor está alojado por Telenow en https://api.telenow.ai/mcp; no hay nada que instalar ni ejecutar.

URL del servidor	https://api.telenow.ai/mcp
Transporte	HTTP Streamable (sin estado, respuestas JSON)
Autenticación	Inicio de sesión OAuth 2.1 (PKCE, registro dinámico de clientes) o una clave API de organización Authorization: Bearer vai_live_…
Versiones de protocolo	2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26
Precios	Pago por uso desde tu billetera de Telenow, aproximadamente $0.05/min para una configuración típica

Qué puedes pedir

• "Llama al +1 415 555 0100 y reserva una mesa para 4 a las 8pm del viernes a mi nombre. Dime qué dijeron."
• "¿Qué llamadas entraron a mi línea de ventas ayer? Resume cualquier cosa que necesite seguimiento."
• "Crea un agente de voz que confirme citas dentales en español y dime su costo por minuto."
• "Redacta una campaña que llame a estos 200 prospectos entre las 10am y las 6pm en su horario, con dos reintentos si no contestan. No la inicies todavía."
• "¿Cómo fue la campaña de renovación de ayer? ¿Quién pidió que le devolvieran la llamada?"

Instalación

Necesitas una cuenta de Telenow con al menos un número de teléfono. Al conectarte, Telenow te pedirá iniciar sesión y elegir la organización, los números y los permisos que el asistente puede usar.

Claude (claude.ai, Desktop, móvil)

Configuración → Conectores → Agregar conector personalizado → URL https://api.telenow.ai/mcp → Conectar e iniciar sesión.

Claude Code

# OAuth sign-in
claude mcp add --transport http telenow https://api.telenow.ai/mcp

# or with an API key
claude mcp add --transport http telenow https://api.telenow.ai/mcp \
  --header "Authorization: Bearer vai_live_…"

ChatGPT

Configuración → Apps y conectores → Avanzado → habilita Modo desarrollador → Crear conector → URL https://api.telenow.ai/mcp, autenticación OAuth. En espacios de trabajo Business/Enterprise, un administrador debe permitir conectores personalizados primero.

Cursor

O agrégalo a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "telenow": { "url": "https://api.telenow.ai/mcp" }
  }
}

VS Code (GitHub Copilot)

// .vscode/mcp.json
{
  "servers": {
    "telenow": { "type": "http", "url": "https://api.telenow.ai/mcp" }
  }
}

Windsurf / Cline / otros clientes con OAuth

Agrega un servidor remoto (HTTP Streamable) con la URL https://api.telenow.ai/mcp. El cliente abrirá la página de inicio de sesión de Telenow.

Clientes sin OAuth

Envía una clave API de organización como encabezado:

{
  "mcpServers": {
    "telenow": {
      "url": "https://api.telenow.ai/mcp",
      "headers": { "Authorization": "Bearer vai_live_…" }
    }
  }
}

Una clave de solo lectura otorga herramientas de solo lectura; una clave con capacidad de escritura tiene permisos completos en su organización.

Gemini CLI

gemini extensions install https://github.com/TelenowAI/Telenow-AI-MCP

Grok

grok.com/connectors → Nuevo conector → Personalizado → URL https://api.telenow.ai/mcp.

Herramientas (17)

Área	Herramienta	Qué hace	Tipo
Llamadas	list_numbers	Números desde los que el asistente puede llamar; el primero es el identificador de llamada predeterminado	solo lectura
	place_call	Realiza una llamada real y devuelve un call_id de inmediato	contacta personas
	get_call	Una llamada: estado, resultado, resumen, transcripción	solo lectura
	list_calls	Llamadas entrantes/salientes recientes, más recientes primero	solo lectura
Agentes	list_agents	Los agentes de voz de la organización	solo lectura
	get_agent	Configuración de un agente, claves enmascaradas	solo lectura
	create_agent	Agente de contexto único a partir de un nombre y un prompt de sistema	crea
	create_flow_agent	Agente de múltiples pasos definido como un grafo	crea
	update_agent	Cambia un agente creado por este asistente	cambia
	list_voices	Voces con muestras de audio	solo lectura
	estimate_cost	Costo por minuto (USD) para un agente o configuración planificada	solo lectura
Campañas	list_campaigns	Campañas en los números del asistente	solo lectura
	get_campaign	Una campaña y resultados por persona	solo lectura
	create_campaign	Borrador de campaña; no se marca ningún número	crea
	add_campaign_targets	Agrega hasta 1,000 personas	contacta personas
	start_campaign	Inicia o reanuda una campaña	contacta personas
	pause_campaign	Pausa; las llamadas en curso terminan	cambia

Parámetros completos: https://telenow.ai/docs/mcp-tools

Seguridad y permisos

• El asistente debe preguntar antes de contactar a personas reales.
• Solo puede llamar desde los números que elegiste al conectarte.
• Nunca ve ni establece tus claves API.
• Solo puede cambiar agentes y campañas que él mismo creó.
• Las herramientas de agentes, webhooks y transferencias permanecen desactivadas a menos que marques Dar herramientas a los agentes (alcance agents:tools).
• Alcances OAuth: calls:read, calls:write, agents:write, agents:tools, campaigns:write, offline_access.
• Límite de velocidad: 3,000 solicitudes por 15 minutos por conexión o clave API.

Precios

Las llamadas se facturan por minuto desde la billetera de tu organización, dentro de tus límites de gasto. Una configuración típica (voz Cartesia, GPT-4o-mini, Deepgram Nova-3, Plivo) cuesta aproximadamente $0.049/min; una llamada de 2 minutos a 100 personas cuesta alrededor de $10. Usa la herramienta estimate_cost para una cotización exacta. Las partes que se ejecutan con tus propias claves de proveedor o operador no las factura Telenow. Consulta https://telenow.ai/docs/mcp-costs.

Soporte

• Documentación: https://telenow.ai/docs
• Correo electrónico: support@telenow.ai · Contacto: https://telenow.ai/contact
• Privacidad: https://telenow.ai/privacy · Términos: https://telenow.ai/terms · Teléfono: +1 (605) 597-8532

Licencia

Los archivos de este repositorio tienen licencia MIT. El servicio de Telenow es propietario y se rige por los Términos de Servicio de Telenow.