# Innform MCP

> Innform MCP connects your AI agent directly to corporate training data. It lets you manage learners, track course completion rates, and audit learning results from a single prompt. Ideal for automating HR processes and building internal employee development dashboards.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** lms, employee-training, course-management, learner-tracking, skill-development, hospitality-training

## Description

Managing employee training used to mean jumping between the LMS dashboard, pulling reports into spreadsheets, and manually cross-referencing who finished what. This MCP changes that. Your agent connects directly to your Innform platform via Vinkius, giving it full visibility across all your learning content.

Instead of writing complex API calls, you just ask: 'Who in the Marketing department needs refresher training on GDPR?' The agent handles listing departments and then cross-references active employees against available modules. You get a clean list of people who need attention, along with their current status. It’s all about letting your AI client handle the data plumbing so you can focus on the curriculum itself.

## Tools

### get_learner
Retrieves all personal details for a single specified user record.

### get_me
Provides basic profile information about the authenticated user making the request.

### list_courses
Pulls down a full list of every course title available in the system.

### list_departments
Lists all defined organizational departments within your company structure.

### list_learners
Generates a roster of every active employee or learner account in Innform.

### list_locations
Shows all physical or virtual locations used by the organization for training purposes.

### list_modules
Presents a list of individual, granular training components that make up courses.

### list_pathways
Retrieves the defined sequences or roadmaps for structured learning progression.

### list_results
Lists assessment scores and completion data for specific courses taken by learners.

### list_tags
Displays all organizational tags, useful for grouping employees or content types.

## Prompt Examples

**Prompt:** 
```
List all active learners in my Innform account.
```

**Response:** 
```
I'll fetch the list of your active learners.
```

**Prompt:** 
```
Show me the results for 'Cybersecurity Awareness' course.
```

**Response:** 
```
I'll retrieve the learner results for that specific course.
```

**Prompt:** 
```
Check for any new learning pathways.
```

**Response:** 
```
I'll look up the list of available learning pathways in Innform.
```

## Capabilities

### Accessing Learner Roster Data
Retrieve detailed records for any specific employee or list every active learner in the system.

### Cataloging Learning Assets
See all available training courses, modules, and structured learning pathways defined in your platform.

### Auditing Performance Metrics
Get a comprehensive list of assessment scores and course completion results for cohorts or individuals.

### Mapping Organizational Structure
View the internal departments, geographical locations, and organizational tags used by your company.

## Use Cases

### Annual Compliance Audit
The HR manager needs to know who in the Finance department missed the annual data security module. They ask their agent, and the system combines `list_departments` with `list_learners`, then filters that list using `get_learner` details to show only those employees who lack a matching record in `list_results` for the required course.

### New Employee Onboarding
A new employee starts and needs immediate access to all mandatory training. The agent uses `list_pathways` to find the correct onboarding track, then uses `list_modules` to present the required sequence of courses directly to the manager.

### Departmental Skill Gap Analysis
The department head wants to see which teams are weak in 'Cybersecurity.' They ask their agent, and it pulls a list of all learners (`list_learners`), filters by department tag (`list_tags`), and then uses `list_results` to generate an average score report for that specific skill.

## Benefits

- Stop manually compiling reports. You can use `list_results` to instantly check assessment scores for a given course, telling you exactly who passed or failed.
- Map out entire training curricula by listing all available modules and courses. This helps L&D teams plan new educational pathways using `list_modules` and `list_courses` together.
- Filter your user base with precision. You can combine `list_departments` to narrow down the group, then use `get_learner` to pull specific details for only those people.
- Understand learner progression by checking defined learning pathways. The agent handles this complex data flow using `list_pathways`, giving you a clear roadmap view.
- Identify compliance gaps quickly. By running `list_learners` and then cross-referencing them with results from `list_results`, you immediately spot every employee needing mandatory training.

## How It Works

The bottom line is your agent gets all that dispersed training data in one place without you writing a single query or dealing with multiple logins.

1. Tell your AI client exactly what data you need—for instance, 'Show me all users in the Finance department who haven't completed Module X.'
2. The MCP agent translates that request into specific calls to Innform, pulling together learner records, departmental lists, and module status.
3. You receive a single, structured output containing only the relevant data: the names of the employees, their current completion status, and any associated scores.

## Frequently Asked Questions

**How do I find out what courses are available using `list_courses`?**
The agent uses `list_courses` to pull a complete list of every course title. If you want more detail, you can then use `list_modules` on the resulting list to see what individual components make up those courses.

**Can I check assessment scores for multiple learners using `list_results`?**
Yes. You provide the course ID and the relevant learner IDs, and `list_results` returns a combined view of all their assessments and completion status in one go.

**What is the difference between `list_learners` and `get_learner`?**
Use `list_learners` when you need to see everyone on the roster. Use `get_learner` only when you already know who you want details for, and you need their full record.

**Does Innform MCP help me map out new training programs using `list_pathways`?**
Yes, it retrieves the current pathways. You can then combine this with `list_modules` to see exactly what components are needed to build a completely new learning road map.

**What information can I get about my credentials using `get_me`?**
The tool confirms your current identity and access scope. It provides necessary details, like user IDs and roles, confirming what data your agent is authorized to view or modify.

**Does running `list_departments` help me structure a query for learner data?**
Yes. This function retrieves all organizational departments. Your agent uses this list to understand the company's hierarchy, allowing it to accurately scope searches across different teams.

**What is the difference between what `list_courses` and `list_modules` show?**
`list_courses` shows entire learning programs. By contrast, `list_modules` provides a list of smaller, specific content chunks that make up those larger courses.

**Before I try to filter results, how can I confirm available classifications using `list_tags`?**
You must call `list_tags` first. This returns a definitive list of all defined tags in the system, preventing your agent from trying to process non-existent or misspelled criteria.

**How do I get Innform API credentials?**
You can generate an API key in your Innform account under Account Settings > API. Ensure you have the necessary permissions.

**Can I see learner results?**
Yes, the list_results tool provides access to assessment and course completion data for your learners.

**Are learning pathways supported?**
Yes, you can list all defined learning pathways using the list_pathways tool.