Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nippy.la/llms.txt

Use this file to discover all available pages before exploring further.

​
Examples of what you can ask your agent

  • “How many people enrolled in the onboarding course this month?”
  • “Who’s halfway through the safety course? Show me their progress”
  • “What percentage of students passed the final exam?”
  • “Issue Laura Martínez’s certificate for her completed session”
  • “Create a new customer service course, with an exam and certificate”
Learning lets you manage your LMS from chat. Check who’s progressing, how exams are going, and issue certificates without logging into the platform. As with the other verticals, write operations show a preview before executing.

​
Read tools

​
learning_list_courses

Lists the courses for this business.
​
limit
integer
default:"100"
Maximum number of courses to return.
Response includes: _id, title, slug, description, published, isCertified, examApproveScore, created_at 
{
  "name": "learning_list_courses",
  "arguments": {
    "limit": 20
  }
}

​
learning_get_enrollment_stats

Gets enrollment statistics: counts by status (in_progress, exam, completed, certified, failed).
​
course_id
string
Course ID. If omitted, returns statistics for all courses.
​
date_from
string
Start date in ISO 8601 to filter by startedAt. Optional.
​
date_to
string
End date in ISO 8601 to filter by startedAt. Optional.
Response: total_enrollments, by_status (object with counts per status), 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

Gets progress per student for a specific course.
​
course_id
string
default:"''"
Course ID to query.
​
limit
integer
default:"100"
Maximum number of progress records to return.
Response: per student: status, current module, completed modules, score, exam status, and identity (fullName, email). 
{
  "name": "learning_get_course_progress",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "limit": 50
  }
}

​
learning_get_exam_results

Gets pass/fail rates and average exam scores.
​
course_id
string
Course ID. If omitted, returns results for all courses.
Response: total_exams_started, total_exams_completed, pass_rate, average_score 
{
  "name": "learning_get_exam_results",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d"
  }
}

​
learning_get_certificates_issued

Lists certificates issued by this business within a date range.
​
date_from
string
Start date in ISO 8601. Optional.
​
date_to
string
End date in ISO 8601. Optional.
​
limit
integer
default:"100"
Maximum number of certificates to return.
Response includes: session_id, user info (fullName, email), course info (title, slug), certificate details, and completedAt. 
{
  "name": "learning_get_certificates_issued",
  "arguments": {
    "date_from": "2026-01-01",
    "date_to": "2026-05-08",
    "limit": 50
  }
}

​
Write tools — Courses

​
learning_propose_create_course

Generates a preview of the course draft. Does not write to the database.
​
title
string
required
Course title.
​
slug
string
required
Unique course slug in kebab-case (e.g. "nippy-onboarding-2026").
​
description
string
default:"''"
Course description.
​
exam_approve_score
float
Minimum score to pass the exam (e.g. 70.0). Optional.
​
is_certified
boolean
default:"false"
Whether the course grants a certificate upon completion.
{
  "name": "learning_propose_create_course",
  "arguments": {
    "title": "Nippy Onboarding 2026",
    "slug": "nippy-onboarding-2026",
    "description": "Onboarding course for new members of the Nippy platform. Covers operational fundamentals, security, and console usage.",
    "exam_approve_score": 70.0,
    "is_certified": true
  }
}

​
learning_approve_create_course

Creates the course draft in the database. Same parameters as propose_create_course.
Only call this tool after showing the user the propose_create_course preview and receiving explicit confirmation.
Response: {"_id": "...", "title": "Nippy Onboarding 2026", "status": "created"}

​
learning_propose_update_course

Generates a preview of changes to apply to an existing course. Does not write to the database. Only non-None fields are applied.
​
course_id
string
required
Course ID to update.
​
title
string
New course title.
​
description
string
New course description.
​
exam_approve_score
float
New minimum passing score.
​
is_certified
boolean
Whether the course grants a certificate.
​
published
boolean
Whether the course is published and visible to students.
{
  "name": "learning_propose_update_course",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "published": true,
    "exam_approve_score": 80.0
  }
}

​
learning_approve_update_course

Applies changes to the course. Same parameters as propose_update_course.
Only call this tool after showing the user the propose_update_course preview and receiving explicit confirmation.
Response: {"course_id": "664f1a2b3c4d5e6f7a8b9c0d", "updated": true}

​
Write tools — Certificates

​
learning_propose_issue_certificate

Generates a preview of issuing a certificate. Does not write to the database. Verifies the session exists, is completed, and belongs to the business.
​
session_id
string
required
ID of the completed course session.
{
  "name": "learning_propose_issue_certificate",
  "arguments": {
    "session_id": "665a1b2c3d4e5f6a7b8c9d0e"
  }
}

​
learning_approve_issue_certificate

Forces certification of a completed session. Marks the session status as "certified".
​
session_id
string
required
ID of the course session to certify.
Only call this tool after showing the user the propose_issue_certificate preview and receiving explicit confirmation. This tool does not generate the PDF or send the email — that is handled by whatsapp-platform separately.
{
  "name": "learning_approve_issue_certificate",
  "arguments": {
    "session_id": "665a1b2c3d4e5f6a7b8c9d0e"
  }
}
Schema references for the agent:
URINameDescription
nippy://learning/schema/schemaslearning_schemasCourse, session, and profile fields
nippy://learning/schema/glossarylearning_glossaryBusiness terms and mappings
nippy://learning/skilllearning_skillAgent instructions

​
Important notes

  • Courses must have published: true before students can access them. Use propose_update_course and approve_update_course to publish.
  • Issuing certificates from MCP only updates the session status to "certified". PDF generation and email delivery are handled by whatsapp-platform.