# course-progress MCP for educational tracking. AI Agent Connect

> course-progress MCP gives your AI client direct access to course completion data and lesson status. It handles the math for completion percentages, tracks remaining lessons, and identifies upcoming milestones. You can use it to monitor student progress or audit course data integrity through any MCP-compatible client like Claude or Cursor.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_QW8mgsdtOyO4FkVZqMegYzjG4xll6sd7RoojNdm5/ai-agent-connect
- **Tags:** learning, progress, course, metrics, education-tech

## Description

You can use this MCP to give your AI agent a clear view of how learners are moving through your educational content. Instead of manually checking spreadsheets or databases, you just ask your AI client for the numbers. It can calculate exact completion percentages, count how many lessons are left, and pinpoint exactly where a student stands in their journey. If you need to ensure your course data is accurate, the MCP can run integrity checks to make sure the math holds up. It's a direct way to turn raw course data into actionable progress reports without leaving your chat interface.

## Tools

### get_completion_milestones
This tool pulls upcoming progress milestones for a specific course. Use it to see what percentage marks a learner is approaching next.

### get_course_completion
This tool calculates the exact percentage of a course that has been finished. It's the fastest way to get a completion score for any course ID.

### get_lesson_progress_details
This tool provides a full breakdown of lesson status. It shows you exactly how many lessons are completed and how many remain.

### verify_course_integrity
This tool checks the underlying course data for errors. It ensures that progress calculations remain accurate and reliable.

## Prompt Examples

**Prompt:** 
```
What is the completion percentage for course ID 'math-101'?
```

**Response:** 
```
The completion percentage for 'math-101' is 75%.
```

**Prompt:** 
```
How many lessons are remaining in the 'history-basics' course?
```

**Response:** 
```
There are 3 lessons remaining in the 'history-basics' course.
```

**Prompt:** 
```
Show me the progress milestones for course 'science-01' at 20% intervals.
```

**Response:** 
```
The milestones for 'science-01' are 20%, 40%, and 60%.
```

## Capabilities

### Percentage Calculation
Your agent uses this to report exactly how much of a course a student has finished.

### Lesson Auditing
The AI uses this to count completed versus remaining lessons in a curriculum.

### Milestone Tracking
Your agent identifies specific progress markers to help users see their upcoming goals.

### Data Validation
The MCP runs integrity checks to confirm course data is correct before reporting numbers.

## Use Cases

### Student Progress Reporting
Ask your AI client to summarize how much of a specific course a user has completed.

### Curriculum Auditing
Use the tool to check if the number of completed lessons matches the expected course progress.

### Goal Setting
Have your agent show a student their next milestone to keep them motivated.

### Data Integrity Checks
Run a verification to make sure course progress data hasn't become corrupted or inconsistent.

## Benefits

- Eliminates manual math for course completion percentages.
- Provides instant lesson-level breakdowns through natural language.
- Ensures data accuracy with built-in integrity verification.
- Identifies upcoming learner milestones automatically.

## How It Works

Connecting this MCP to your workflow takes seconds and works through your existing AI tools.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Provide the specific course ID to your AI agent.
3. The agent calls the necessary tool to fetch progress or milestone data.
4. Your agent delivers the calculated results or lesson counts directly in the chat.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect to the MCP through the Vinkius platform. Once connected, Claude can immediately use the tools to check course progress.

**Can this MCP calculate specific lesson counts?**
Yes. The get_lesson_progress_details tool provides a full breakdown of completed and remaining lessons.

**Does it work with Cursor or VS Code?**
Yes, this MCP is compatible with any MCP-compatible client, including Cursor and VS Code.

**What happens if the course data is wrong?**
The verify_course_integrity tool is designed to check the data and ensure calculations are accurate.

**Do I need to host this myself?**
No. Vinkius hosts and manages the MCP for you, so it is ready to use immediately after connection.

**How is the completion percentage calculated?**
The percentage is calculated by dividing the number of completed lessons by the total number of lessons in the course, then multiplying by one hundred.

**Can I see how many lessons are left in a course?**
Yes, you can use the `get_lesson_progress_details` tool to see the total, completed, and remaining lessons.

**What happens if a course has no lessons?**
If a course contains zero total lessons, the tool will return an error as progress cannot be calculated.