Nippy API Platform

Ejemplos de lo que puedes preguntarle a tu agente

“¿Cuánta gente se inscribió al curso de inducción este mes?”
“¿Quiénes van a la mitad del curso de seguridad? Muéstrame su progreso”
“¿Qué porcentaje de alumnos pasó el examen final?”
“Entrégale su certificado a la sesión de Laura Martínez”
“Crea un curso nuevo de atención al cliente, con examen y certificado”

Learning te deja manejar tu LMS desde el chat. Consultas quién está avanzando, cómo van los exámenes, y emites certificados sin entrar a la plataforma. Igual que en las demás verticales, las operaciones que escriben datos te muestran un preview antes de ejecutarse.

Tools de lectura

`learning_list_courses`

Lista los cursos de este negocio.

integer

predeterminado:"100"

Número máximo de cursos a retornar.

Respuesta incluye: _id, title, slug, description, published, isCertified, examApproveScore, created_at

{
  "name": "learning_list_courses",
  "arguments": {
    "limit": 20
  }
}

`learning_get_enrollment_stats`

Obtiene estadísticas de inscripciones: conteos por estado (in_progress, exam, completed, certified, failed).

string

ID del curso. Si se omite, retorna estadísticas de todos los cursos.

string

Fecha de inicio en ISO 8601 para filtrar por startedAt. Opcional.

string

Fecha de fin en ISO 8601 para filtrar por startedAt. Opcional.

Respuesta: total_enrollments, by_status (objeto con conteos por estado), completion_rate, certification_rate

{
  "name": "learning_get_enrollment_stats",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "date_from": "2026-01-01",
    "date_to": "2026-05-08"
  }
}

`learning_get_course_progress`

Obtiene el progreso por alumno para un curso específico.

string

predeterminado:"''"

ID del curso a consultar.

integer

predeterminado:"100"

Número máximo de registros de progreso a retornar.

Respuesta: por cada alumno: status, módulo actual, módulos completados, score, estado de examen, e identidad (fullName, email).

{
  "name": "learning_get_course_progress",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "limit": 50
  }
}

`learning_get_exam_results`

Obtiene tasas de aprobación/reprobación y puntajes promedio de exámenes.

string

ID del curso. Si se omite, retorna resultados de todos los cursos.

Respuesta: total_exams_started, total_exams_completed, pass_rate, average_score

{
  "name": "learning_get_exam_results",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d"
  }
}

`learning_get_certificates_issued`

Lista los certificados emitidos por este negocio en un rango de fechas.

string

Fecha de inicio en ISO 8601. Opcional.

string

Fecha de fin en ISO 8601. Opcional.

integer

predeterminado:"100"

Número máximo de certificados a retornar.

Respuesta incluye: session_id, info del usuario (fullName, email), info del curso (title, slug), detalles del certificado, y completedAt.

{
  "name": "learning_get_certificates_issued",
  "arguments": {
    "date_from": "2026-01-01",
    "date_to": "2026-05-08",
    "limit": 50
  }
}

Tools de escritura — Cursos

`learning_propose_create_course`

Genera un preview del borrador de curso. No escribe a la base de datos.

string

requerido

Título del curso.

string

requerido

Slug único del curso en kebab-case (e.g. "induccion-nippy-2026").

string

predeterminado:"''"

Descripción del curso.

float

Puntaje mínimo para aprobar el examen (e.g. 70.0). Opcional.

boolean

predeterminado:"false"

Si el curso otorga certificado al completarse.

{
  "name": "learning_propose_create_course",
  "arguments": {
    "title": "Inducción Nippy 2026",
    "slug": "induccion-nippy-2026",
    "description": "Curso de inducción para nuevos miembros de la plataforma Nippy. Cubre los fundamentos de operación, seguridad y uso de la consola.",
    "exam_approve_score": 70.0,
    "is_certified": true
  }
}

`learning_approve_create_course`

Crea el borrador del curso en la base de datos. Mismos parámetros que propose_create_course.

Solo llama esta tool después de mostrar al usuario el preview de propose_create_course y recibir confirmación explícita.

Respuesta: {"_id": "...", "title": "Inducción Nippy 2026", "status": "created"}

`learning_propose_update_course`

Genera un preview de los cambios a aplicar sobre un curso existente. No escribe a la base de datos. Solo los campos no-None se aplican.

string

requerido

ID del curso a actualizar.

string

Nuevo título del curso.

string

Nueva descripción del curso.

float

Nuevo puntaje mínimo de aprobación.

boolean

Si el curso otorga certificado.

boolean

Si el curso está publicado y visible para alumnos.

{
  "name": "learning_propose_update_course",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "published": true,
    "exam_approve_score": 80.0
  }
}

`learning_approve_update_course`

Aplica los cambios al curso. Mismos parámetros que propose_update_course.

Solo llama esta tool después de mostrar al usuario el preview de propose_update_course y recibir confirmación explícita.

Respuesta: {"course_id": "664f1a2b3c4d5e6f7a8b9c0d", "updated": true}

Tools de escritura — Certificados

`learning_propose_issue_certificate`

Genera un preview de la emisión de un certificado. No escribe a la base de datos. Verifica que la sesión exista, esté completada y pertenezca al negocio.

string

requerido

ID de la sesión de curso completada.

{
  "name": "learning_propose_issue_certificate",
  "arguments": {
    "session_id": "665a1b2c3d4e5f6a7b8c9d0e"
  }
}

`learning_approve_issue_certificate`

Fuerza la certificación de una sesión completada. Marca el estado de la sesión como "certified".

string

requerido

ID de la sesión de curso a certificar.

Solo llama esta tool después de mostrar al usuario el preview de propose_issue_certificate y recibir confirmación explícita. Esta tool no genera el PDF ni envía el email — eso lo maneja whatsapp-platform por separado.

{
  "name": "learning_approve_issue_certificate",
  "arguments": {
    "session_id": "665a1b2c3d4e5f6a7b8c9d0e"
  }
}

Detalles técnicos (avanzado)

Referencias de esquemas para el agente:

URI	Nombre	Descripción
`nippy://learning/schema/schemas`	`learning_schemas`	Campos de cursos, sesiones y perfiles
`nippy://learning/schema/glossary`	`learning_glossary`	Términos de negocio y mapeos
`nippy://learning/skill`	`learning_skill`	Instrucciones para el agente

Notas importantes

Los cursos deben tener published: true antes de que los alumnos puedan acceder a ellos. Usa propose_update_course y approve_update_course para publicarlos.
La emisión de certificados desde MCP solo actualiza el estado de la sesión a "certified". La generación del PDF y el envío por email los maneja whatsapp-platform.

Inicio

SDK

MCP

Learning

Ejemplos de lo que puedes preguntarle a tu agente

Tools de lectura

`learning_list_courses`

`learning_get_enrollment_stats`

`learning_get_course_progress`

`learning_get_exam_results`

`learning_get_certificates_issued`

Tools de escritura — Cursos

`learning_propose_create_course`

`learning_approve_create_course`

`learning_propose_update_course`

`learning_approve_update_course`

Tools de escritura — Certificados

`learning_propose_issue_certificate`

`learning_approve_issue_certificate`

Notas importantes

​Ejemplos de lo que puedes preguntarle a tu agente

​Tools de lectura

​learning_list_courses

​learning_get_enrollment_stats

​learning_get_course_progress

​learning_get_exam_results

​learning_get_certificates_issued

​Tools de escritura — Cursos

​learning_propose_create_course

​learning_approve_create_course

​learning_propose_update_course

​learning_approve_update_course

​Tools de escritura — Certificados

​learning_propose_issue_certificate

​learning_approve_issue_certificate

​Notas importantes

Ejemplos de lo que puedes preguntarle a tu agente

Tools de lectura

`learning_list_courses`

`learning_get_enrollment_stats`

`learning_get_course_progress`

`learning_get_exam_results`

`learning_get_certificates_issued`

Tools de escritura — Cursos

`learning_propose_create_course`

`learning_approve_create_course`

`learning_propose_update_course`

`learning_approve_update_course`

Tools de escritura — Certificados

`learning_propose_issue_certificate`

`learning_approve_issue_certificate`

Notas importantes