Novu para agentes de IA

Conecta tu cliente

Agrega Novu como servidor MCP remoto. No necesitas llave ni inicio de sesión. El equipo de Novu probó la conexión con Claude Code y compras completas con MCP Inspector. Los demás clientes están configurados según su documentación oficial.

claude mcp add --transport http novu https://novu.isbry.com/mcp

claude mcp add --transport http novu --scope user https://novu.isbry.com/mcp

{
  "mcpServers": {
    "novu": {
      "type": "http",
      "url": "https://novu.isbry.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "novu": {
      "url": "https://novu.isbry.com/mcp"
    }
  }
}

code --add-mcp '{"name":"novu","type":"http","url":"https://novu.isbry.com/mcp"}'

{
  "servers": {
    "novu": {
      "type": "http",
      "url": "https://novu.isbry.com/mcp"
    }
  }
}

curl -sS https://novu.isbry.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

curl -sS https://novu.isbry.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

npx @modelcontextprotocol/inspector --cli https://novu.isbry.com/mcp --transport http --method tools/list

Cómo compra un agente

Una compra tiene cinco pasos. El agente hace casi todo. La persona elige la voz, aprueba el texto y paga.

1. Agente y persona

   Elegir la voz

   El agente llama a list_voices y comparte los enlaces preview_url. La persona escucha las muestras y elige.

2. Agente y persona

   Acordar el texto exacto

   La voz lee el texto tal como está escrito. Para la central telefónica, el agente redacta los mensajes con la persona. Para un video, acuerdan el guion completo.

3. Agente

   Crear el paquete y decir el precio

   El agente llama a create_ivr_package o create_video_package. Novu fija el plan y devuelve price_cop. Todavía no cobra nada.

4. La persona paga

   Pagar con código o con enlace

   El agente llama a pay_for_ivr_package o pay_for_video_package con el correo de la persona. Si la persona tiene un código promocional, el agente lo envía y el paquete se desbloquea al instante. Si no, el agente le entrega checkout_url, un enlace de pago de ePayco que dura 24 horas. La persona abre el enlace y paga.

5. Agente

   Entregar el audio

   El agente llama a get_ivr_package o get_video_package hasta que status es ready. Luego le entrega a la persona download_url.

Un paquete de central telefónica suele estar listo en 1 a 5 minutos. Un video puede tardar varios minutos si hay otros pedidos antes.

Herramientas

El servidor tiene 7 herramientas. Cada resultado trae los datos en structuredContent y el mismo JSON como texto en content. tools/list publica el JSON Schema de entrada y de salida de cada herramienta. Los ejemplos muestran los arguments de tools/call y el structuredContent del resultado.

Novu fija el plan según la cantidad de mensajes o el largo del guion. create_ivr_package y create_video_package devuelven price_cop antes de cobrar nada. Los planes y precios vigentes están en Precios.

Común

{}

{
  "voices": [
    {
      "voice_id": "5z6tF6eAwkAluMyjDFJJ",
      "name": "Alejandro",
      "gender": "M",
      "description": "Una cálida voz masculina en español latinoamericano con un tono íntimo.",
      "preview_url": "https://novu.isbry.com/api/v1/voices/5z6tF6eAwkAluMyjDFJJ/demo?v=2"
    },
    {
      "voice_id": "EYBbN7OENxAX5QX56IiW",
      "name": "Catalina",
      "gender": "F",
      "description": "Una voz femenina joven, natural, cercana y conversacional en español latinoamericano.",
      "preview_url": "https://novu.isbry.com/api/v1/voices/EYBbN7OENxAX5QX56IiW/demo?v=2"
    }
  ]
}

Central telefónica

{
  "business_name": "Clínica Dental Sonrisa",
  "voice_id": "5z6tF6eAwkAluMyjDFJJ",
  "messages": [
    {
      "type": "greeting",
      "text": "Gracias por llamar a Clínica Dental Sonrisa."
    },
    {
      "type": "menu",
      "text": "Para agendar una cita, marque uno. Para hablar con recepción, marque dos."
    },
    {
      "type": "after-hours",
      "text": "Nuestro horario es de lunes a viernes, de ocho de la mañana a seis de la tarde."
    }
  ]
}

{
  "package_id": "ivr_8c1f4a2e9b7d4e6fa03c5b1d2e7f9a46QH4XN7KD2MZP5WT3RL6CVB2YJF",
  "status": "draft",
  "plan": "emprendedor",
  "message_count": 3,
  "price_cop": 132000,
  "next_step": "Call pay_for_ivr_package with the customer's email, and their promo code if they have one."
}

{
  "package_id": "ivr_8c1f4a2e9b7d4e6fa03c5b1d2e7f9a46QH4XN7KD2MZP5WT3RL6CVB2YJF",
  "email": "ana@ejemplo.com"
}

{
  "package_id": "ivr_8c1f4a2e9b7d4e6fa03c5b1d2e7f9a46QH4XN7KD2MZP5WT3RL6CVB2YJF",
  "status": "awaiting_payment",
  "plan": "emprendedor",
  "message_count": 3,
  "price_cop": 132000,
  "checkout_url": "https://novu.isbry.com/pagar?checkout=68eefce71d65…",
  "next_step": "Give the customer checkout_url to pay 132,000 COP. When they say they paid, call get_ivr_package. Once paid, novu produces the audio and emails them the download link, even if this conversation has ended."
}

{
  "package_id": "ivr_8c1f4a2e9b7d4e6fa03c5b1d2e7f9a46QH4XN7KD2MZP5WT3RL6CVB2YJF"
}

{
  "package_id": "ivr_8c1f4a2e9b7d4e6fa03c5b1d2e7f9a46QH4XN7KD2MZP5WT3RL6CVB2YJF",
  "status": "ready",
  "plan": "emprendedor",
  "message_count": 3,
  "price_cop": 132000,
  "download_url": "https://…",
  "download_expires_at": "2026-10-27T15:04:05Z",
  "next_step": "Give the customer download_url. It holds one audio file per message, a transcript and a README. novu also emailed the link to the customer."
}

Videos

{
  "voice_id": "EYBbN7OENxAX5QX56IiW",
  "script": "¿Sabías que la primera impresión de tu marca se forma en menos de siete segundos? En Café Altura tostamos cada grano en pequeños lotes, a mano, para que tu mañana empiece con el sabor de las montañas. Pide hoy y recibe tu café recién tostado en casa.",
  "intent": "Tranquila al inicio, emocionada al final"
}

{
  "package_id": "vid_2b7e5c9d1a4f4e8b9c3d6a0f1e2b4c57WM5RZ3KT7HQ2XN4PJ6LD2VC5YB",
  "status": "draft",
  "package": "video-corto",
  "title": "¿Sabías que la primera impresión de tu marca se forma en",
  "characters": 250,
  "max_characters": 1000,
  "price_cop": 60000,
  "next_step": "Call pay_for_video_package with the customer's email, and their promo code if they have one. A promo code for this package or a larger one pays for it, but a larger package's code is used up whole on this one, so tell the customer before you use one. The video-corto package covers scripts of up to 1,000 characters and this one has 250."
}

{
  "package_id": "vid_2b7e5c9d1a4f4e8b9c3d6a0f1e2b4c57WM5RZ3KT7HQ2XN4PJ6LD2VC5YB",
  "status": "ready",
  "package": "video-corto",
  "title": "¿Sabías que la primera impresión de tu marca se forma en",
  "characters": 250,
  "max_characters": 1000,
  "price_cop": 60000,
  "download_url": "https://…",
  "audio_url": "https://…",
  "duration_seconds": 15.8,
  "download_expires_at": "2026-10-27T15:04:05Z",
  "next_step": "Give the customer download_url: a ZIP with the voiceover as MP3 and as 48 kHz WAV, the script and a README. audio_url is the MP3 alone, to listen to right away. novu also emailed the download link to the customer."
}

Estados del paquete

Un paquete empieza en draft. Con un enlace de pago pasa a awaiting_payment. Con el pago o con un código promocional pasa a generating, y termina en ready o en failed.

Cada producto tiene su herramienta de pago y su herramienta de consulta. En la central telefónica son pay_for_ivr_package y get_ivr_package. En video son pay_for_video_package y get_video_package.

La llave del paquete

package_id es la única llave de un paquete. Novu no tiene cuentas. Quien tenga el package_id puede ver el paquete y descargar su audio. Guárdalo en privado.

• Los package_id de central telefónica empiezan con ivr_ y solo funcionan con sus herramientas. Los de video empiezan con vid_ y solo funcionan con las de video. La herramienta equivocada responde package_not_found y nombra las herramientas correctas.
• Si se pierde antes de pagar, crea un paquete nuevo. Novu no cobró nada por el anterior.
• Si se pierde después de pagar, la persona recibe el enlace de descarga por correo cuando el audio está listo. Para cualquier otro problema, escribe a hola@novu.io con el package_id.

Errores

Un error de herramienta llega como un resultado con isError: true. Su texto tiene la forma <código>: <mensaje>. El código identifica el error. El mensaje, en inglés, dice qué hacer después.

{
  "content": [
    {
      "type": "text",
      "text": "invalid_email: email must be a valid address like name@company.com."
    }
  ],
  "isError": true
}

Si los argumentos no cumplen el JSON Schema de la herramienta, por ejemplo 51 mensajes o un tipo de mensaje desconocido, el servidor los rechaza antes de ejecutar la herramienta. Ese resultado también trae isError: true, pero su texto empieza con validating "arguments" y no lleva código de Novu.

Límites

Por MCP no hay muestra gratis del guion de un video. Para escuchar antes de pagar, la persona usa las muestras preview_url de cada voz.

Qué debe decirle el agente a la persona

Durante la compra, el agente debe preguntarle o decirle esto a la persona:

• Los enlaces preview_url, para que escuche cada voz antes de elegir.
• Para la central telefónica, qué sistema reproduce el audio, para elegir audio_format: MP3, WAV 16 kHz o mu-law 8 kHz.
• Que confirme el texto exacto, porque la voz lo lee tal cual.
• El precio en pesos (price_cop) antes de pagar.
• El enlace checkout_url para pagar con tarjeta, o que usará su código promocional.
• Que Novu también le envía el enlace de descarga por correo y produce el audio aunque la conversación termine.
• Que el enlace de descarga dura 7 días y que el agente puede pedir uno nuevo.
• Que guarde el package_id en privado, porque es la llave de su audio.
• Que, si algo falla después de pagar, escriba a hola@novu.io con el package_id.

Para agentes y desarrolladores

Estos archivos describen el servidor para otros agentes y herramientas.

• /llms.txt Resumen del servidor para modelos de lenguaje, en inglés.
• /llms-full.txt Referencia completa de las herramientas, con sus JSON Schema.
• /mcp/server-card Tarjeta del servidor MCP.
• /.well-known/ai-catalog.json Catálogo que apunta a la tarjeta del servidor.

La tarjeta y el catálogo siguen un borrador de extensión de MCP (Server Cards, SEP-2127). Pueden cambiar.