# Knorish MCP

> Knorish MCP lets your agent manage the full lifecycle of an online school or course platform. Use it to list courses, track student progress, monitor enrollments, and analyze sales data—all from a natural conversation with your AI client. It handles everything from user creation via `create_user` to comprehensive revenue reporting, making sure you always know exactly where every enrolled student stands.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** online-courses, lms, student-tracking, enrollment-management, certificate-management, digital-products

## Description

Running an online school means juggling content management, payments, and student progress reports. This MCP connects your entire course business into a single conversational interface. You can ask your AI agent to list all available courses or check the curriculum of 'Python for Beginners' instantly. It monitors revenue streams, lets you view sales analytics, and tracks who needs their certificate issued. If you ever needed to pull enrollment data alongside your existing tools in the Vinkius catalog, this MCP makes it happen. Your agent can also identify high-value students by checking progress records or spot potential drop-offs by reviewing recent enrollments.

## Tools

### create_user
Adds a new user profile into the Knorish system.

### create_webhook
Sets up a new webhook endpoint for external notifications.

### enroll_user
Adds an existing user to a specific course.

### get_account_info
Retrieves high-level details about the main academy account setup.

### get_course
Fetches complete details for a specific course, including its structure and lessons.

### get_student_progress
Pulls the current completion status and activity metrics for an enrolled student.

### get_user
Retrieves specific profile information about any individual user ID.

### list_bundles
Gets a list of all packaged course offerings available for sale.

### list_courses
Returns a comprehensive list of every single course offered on the platform.

### list_users
Generates a full directory listing of all registered users in the system.

### list_webhooks
Provides an overview and status list of all active webhooks.

### unenroll_user
Removes a user's connection from a specific course.

## Prompt Examples

**Prompt:** 
```
Show all courses with enrollment numbers and the top-performing course.
```

**Response:** 
```
Courses: 6. 'Digital Marketing Masterclass' (1.2K students, $89, 4.8★ ⭐ top). 'Python for Beginners' (890, $49, 4.6★). 'Business Strategy' (456, $149, 4.7★). 'UX Design Fundamentals' (678, $79, 4.5★). 'Data Analytics' (234, $129, 4.4★). 'Leadership Skills' (123, $69, 4.3★). Total: 3,581 students. Revenue: $287K.
```

**Prompt:** 
```
Show student progress for the Digital Marketing course and recent enrollments.
```

**Response:** 
```
Digital Marketing: 1,200 students. Completion: 42% average. Completed: 504 (42%). In Progress: 480 (40%). Not Started: 216 (18%). Top students: Sarah Chen (100%, certificate issued), Mike Torres (95%), Lisa Park (88%). Recent enrollments (7 days): 28. Daily avg: 4. Drop-off rate: 12%.
```

**Prompt:** 
```
Show the curriculum of the Python course and sales for this month.
```

**Response:** 
```
Python for Beginners: 8 modules. 1) 'Introduction' (3 lessons, 45 min). 2) 'Variables & Types' (4 lessons, 60 min). 3) 'Control Flow' (5 lessons, 75 min). 4) 'Functions' (4 lessons, 60 min). 5) 'Data Structures' (6 lessons, 90 min). 6) 'OOP' (5 lessons, 80 min). 7) 'Projects' (3 lessons, 120 min). 8) 'Final Exam'. Total: 30 lessons, 8.5 hours. This month's sales: 42 orders, $2,058. Refunds: 2 ($98).
```

## Capabilities

### Manage Student Accounts
Create new user profiles and track their specific details within the academy system.

### Track Course Details
Get detailed information about any course, including its full curriculum and module breakdown.

### Monitor Student Progress
View an individual student's progress status across various courses to see who is completing work and who isn't.

### Handle Enrollments
Enroll a user into a course or unenroll them if they decide to quit the program.

### List Core Data Sets
Retrieve lists of all courses, users, and available content bundles for reporting purposes.

## Use Cases

### Investigating Low Engagement
A Student Success Manager notices that the 'Data Analytics' course has low engagement. They prompt their agent, asking to check student progress and recent enrollments. The agent runs `get_student_progress` for multiple users, identifies a pattern of drop-off at Module 3, and flags the issue instantly.

### Auditing User Access
An administrator needs to verify which users are active. Instead of running reports across three different tables, they ask their agent to run `list_users`, get a count, and then check specific details using `get_user` for verification.

### Updating Course Offerings
A founder decides to combine two successful courses. They prompt the agent to use `list_courses` to gather data on both existing programs, then call `list_bundles` to create a new, combined package and check its current sales potential.

### Onboarding New Clients
A team needs to onboard five clients. They prompt the agent, which then uses `create_user` for each client, followed by running `enroll_user` on all of them simultaneously, ensuring immediate and accurate access.

## Benefits

- See who's actually learning. Instead of manually checking dashboards, ask your agent to run `get_student_progress` and immediately spot students whose completion rates are dropping.
- Keep track of every sale. You can pull sales analytics and monitor orders in one query, helping you understand which course bundles (`list_bundles`) drive the most revenue.
- Never lose an account detail again. Use `get_user` to quickly retrieve any user's profile details when they call in with a question about their account status.
- Manage student lifecycle events easily. If a user completes a program, your agent can handle both generating and tracking the certificate record while you simultaneously run `list_courses` for new content ideas.
- Keep data clean by managing connections. Need to remove a student? Use `unenroll_user` instead of manually changing status flags across multiple tables.

## How It Works

The bottom line is that your AI client talks directly to Knorish and reports back only the data you asked for.

1. Subscribe to this MCP in your Vinkius account and enter the Knorish App ID and App Key.
2. Connect your AI agent (like Claude or Cursor) to the Vinkius platform, granting it access to this specific connector.
3. Tell your agent what you need—for example, 'Show me student progress for Digital Marketing'—and it executes the necessary calls.

## Frequently Asked Questions

**How do I check student progress using get_student_progress?**
You ask your agent for the specific course name and the user's ID. The agent then runs `get_student_progress`, returning their current completion percentage, total lessons completed, and activity status.

**Can I list all courses using list_courses?**
Yes, running `list_courses` gives you a full directory of every course title. This is useful if you need to know exactly which program IDs to reference when enrolling users or checking curriculum details.

**What's the difference between list_users and get_user?**
`list_users` gives a summary directory of every user registered. `get_user`, however, drills down into one specific person's record using their unique ID to pull detailed profile data.

**How do I track sales and revenue?**
You monitor revenue by requesting the 'sales analytics.' This tool pulls together order totals and conversion metrics, letting you see exactly how much money is tied to specific course bundles or single courses.

**How do I check if my Knorish account connection is correct using get_account_info?**
Yes, this tool retrieves your core academy details. It confirms your active subscription status and main credentials without you needing to manually verify anything else about the overall setup.

**What commands should I use to change a student’s enrollment status, like using enroll_user or unenroll_user?**
You manage the student lifecycle directly. Use `enroll_user` to add someone to a course, or `unenroll_user` if they drop out. This handles all necessary record updates immediately and accurately.

**How do I set up automated notifications using the create_webhook tool?**
The `create_webhook` function lets you tell Knorish to notify other systems when a specific event happens. You just specify the endpoint URL and trigger, making your data flow automatically.

**Where can I find grouped course offerings using list_bundles?**
This tool lists all available course bundles, allowing you to view packages instead of individual courses. It gives a quick overview of bundled content and associated pricing tiers for easy comparison.

**Can I track student progress and completion rates?**
Yes. Browse all students with course progress percentages, lesson completion, time spent, and engagement metrics. Track completion certificates.

**Does Knorish require two credentials?**
Yes. Knorish requires an **App ID** and **App Key** pair for authentication against `api.knorish.com/v1`.

**Can I monitor sales and enrollment analytics?**
Yes. Track total revenue, order counts, conversion rates, enrollment trends, and refund rates across all courses.