# iSpring Learn MCP MCP

> iSpring Learn MCP connects your corporate training platform to your agent, letting you manage employee learning records through natural conversation. Check compliance status, track who's enrolled in specific mandatory courses, and generate detailed reports on certification progress for entire departments—all without leaving your chat window.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** lms, course-management, compliance-training, certification, learner-tracking, scorm

## Description

Managing workforce training shouldn't feel like juggling five different dashboards. This MCP connects directly to your iSpring Learn instance, giving your agent the ability to pull real-time data about employee education. You can ask it things like, 'Show me all employees in Marketing who haven't finished their GDPR module.' It handles the complex querying and organizes the results right where you are working. If you're already using Vinkius for other integrations, adding this MCP gives you a single place to manage compliance data and learner performance history. You simply talk to your agent, and it pulls records on course catalogs, individual user profiles, enrollment lists, and scores from completed quizzes. It keeps the focus entirely on the people and the reports that matter.

## Tools

### create_new_learner
Adds a new employee or user profile directly into the iSpring Learn system.

### get_course_details
Retrieves specific information about any single course, including its description and learning objectives.

### get_learning_report
Generates a comprehensive report summarizing overall training completion metrics and performance outcomes.

### list_learning_courses
Lists all available courses within the LMS and provides their general metadata.

### list_course_enrollments
Shows which specific users are currently signed up for any given course or set of courses.

### list_user_groups
Retrieves a list of organizational groups or departments to help segment user data for targeted reporting.

### list_learners
Pulls a list of all registered users in the iSpring Learn system, providing basic profile information.

## Prompt Examples

**Prompt:** 
```
Show all courses with completion rates and learners falling behind.
```

**Response:** 
```
Courses: 8 active. 'Cybersecurity Essentials' (45 enrolled, 78% complete). 'Onboarding 2025' (12 enrolled, 92%). 'GDPR Compliance' (60 enrolled, 65% ⚠️). 'Sales Training' (20 enrolled, 85%). Falling behind (< 30% in required courses): 5 learners in GDPR, 2 in Cybersecurity. Deadline: May 1.
```

**Prompt:** 
```
Show quiz results for the Cybersecurity course and the top performers.
```

**Response:** 
```
Cybersecurity quiz: 38 attempts. Pass rate: 82%. Average score: 78/100. Top: Sarah Chen (98/100), Mike Torres (95/100), Lisa Park (92/100). Failed: 7 learners (avg 45/100). Most missed question: 'Phishing identification' (34% correct). Would you like to see individual learner details?
```

**Prompt:** 
```
List all departments and their training completion status.
```

**Response:** 
```
Departments: 6. Engineering (12 people, 89% complete). Product (4, 95%). Design (3, 100% ✅). Marketing (5, 72% ⚠️). Sales (8, 81%). HR (3, 100% ✅). Overall: 35 employees, 85% average completion. Marketing needs attention: 2 learners haven't started GDPR.
```

## Capabilities

### Review all available courses
See a list of every training module you offer, along with how many employees are enrolled and what their completion rates are.

### Track individual user progress
Look up specific employee profiles to track their history, current status, and overall learning achievements.

### List all department structures
View the organizational groups within your company to target training efforts at specific teams or departments.

### Monitor who is signed up for a course
Get an accurate count of every user enrolled in a particular class, regardless of their department.

### Generate compliance reports
Create detailed training reports that summarize overall completion metrics and identify employees who are falling behind on required courses.

## Use Cases

### Audit Prep: Need proof of compliance for GDPR.
A Compliance Officer asks their agent, 'Generate a learning report for all employees on GDPR.' The MCP runs the query and delivers a summary showing completion rates and listing every person who still needs to take the module. No spreadsheets needed.

### Onboarding New Teams: Getting everyone set up.
An HR Manager tells their agent, 'Add five new learners from the Product department.' The MCP uses `create_new_learner` for each person and automatically enrolls them in the core 'Product Training' module.

### Departmental Review: Checking for training gaps.
An L&D Specialist asks, 'Which department has the lowest completion rate for Cybersecurity?' The agent first uses `list_user_groups` to isolate the departments and then uses `list_course_enrollments` to give a quick status update.

### Performance Review: Checking quiz scores.
A Training Coordinator asks, 'Show me the average score for the Cybersecurity course.' The agent pulls all assessment data and gives you the pass rate immediately, helping determine if the training needs revising.

## Benefits

- Compliance tracking is immediate. Instead of waiting for manual data exports, running `get_learning_report` gives you an instant overview of who completed what, making audits much faster.
- Targeted communication becomes simple. By using `list_user_groups`, your agent can help you identify specific departments that need mandatory refresher training before a deadline.
- New hires are easy to track. You can use the `create_new_learner` tool to onboard staff and instantly enroll them in required courses, keeping records clean from day one.
- Pinpoint gaps fast. Combining `list_user_groups` with `list_course_enrollments` lets you see exactly which department is under-enrolled for a critical certification course.
- Understand the curriculum. The `get_course_details` tool means you never have to guess what a module covers; you get all the official objectives right in your chat.

## How It Works

The bottom line is you never have to click through a complex LMS dashboard again; your agent does the work for you.

1. Subscribe to this MCP and provide your iSpring Learn account URL and API Key.
2. Connect the MCP to your preferred AI client (Claude, Cursor, etc.) using the Vinkius catalog.
3. Use natural language prompts in your agent chat window to ask for reports or data specific to employee training needs.

## Frequently Asked Questions

**How do I use the list_user_groups tool with iSpring Learn MCP?**
The `list_user_groups` tool lets you see your organization's official structure. You can run this first to identify department names, which you then need when asking the agent to filter reports for specific teams.

**Can I add a new employee using the create_new_learner tool?**
Yes. `create_new_learner` registers a brand-new user profile within iSpring Learn. This is useful for onboarding staff who haven't been added to the platform yet.

**What information does get_learning_report provide?**
It gives you a high-level, detailed summary of training progress across your user base. It tracks overall completion metrics and can flag individual learners who are falling behind on required courses.

**Does list_course_enrollments only show active users?**
No, `list_course_enrollments` shows every person signed up for a course. This is helpful when you need to check historical enrollment records or find out who was registered even if they haven't finished the module yet.

**When I use the list_learners tool, can I filter results by department or status?**
Yes. You can specify filters when calling list_learners to narrow down user lists. This lets you quickly pull all learners from a specific department or those whose accounts are marked inactive.

**If I run the list_course_enrollments tool on thousands of records, how does it handle pagination?**
The MCP manages large data sets by implementing standard pagination. When you query course enrollments, your agent handles fetching results page-by-page until all available records are retrieved.

**What specific metadata fields can I retrieve using the get_course_details tool?**
get_course_details returns comprehensive data points for any course, including its assigned author, required prerequisites, and official completion date ranges. This depth of detail is key for compliance checks.

**If I try to create a new learner with missing information using the create_new_learner tool, what error codes should I expect?**
The MCP returns specific HTTP status codes and detailed JSON error messages. These messages pinpoint exactly which mandatory field is missing or improperly formatted for successful account creation.

**Can I track learner progress across courses?**
Yes. List learners and inspect individual progress including course completion percentages, quiz scores, and time spent. Track enrollments across all courses.

**Does iSpring Learn require a custom instance URL?**
Yes. Each iSpring Learn account has a unique URL (e.g., `https://your-company.ispringlearn.com`). Provide this along with the API Key. Bearer token against `{url}/api/v1`.

**Can I review quiz results and assessment scores?**
Yes. Browse quiz results with pass/fail status, scores, and attempt details for any course or learner.