# Quiz Average Analytics MCP for educators. AI Agent Connect

> Quiz Average Analytics MCP gives your AI client the math skills to process student test results. Instead of you manually calculating means or checking thresholds, your agent handles the arithmetic, identifies score ranges, and classifies student performance tiers instantly.

## Overview
- **Category:** education
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_qtZMKQt1E4xDT0CSGzzqljrCqlqNnlAAuhUlFLZd/ai-agent-connect
- **Tags:** quiz, scores, student, performance, averages

## Description

You shouldn't have to spend your time running basic math on spreadsheets. This MCP lets your AI client act as a grading assistant that understands student performance metrics. When you feed a list of quiz scores into your agent, it can immediately tell you the mean, the spread between the highest and lowest performers, and whether a student actually passed based on your specific requirements. It also handles qualitative grouping, so you can quickly see how many students fall into specific performance tiers. It's built to take the manual labor out of analyzing classroom data, letting you focus on teaching rather than calculating averages.

## Tools

### get_average_score
Calculates the mean value from a list of quiz results you provide.

### get_performance_spread
Finds the range and distribution of scores to show how much results vary.

### get_tier_classification
Maps a score to a specific qualitative category like high or low performance.

### evaluate_passing_status
Checks if a specific score or average meets your required passing threshold.

## Prompt Examples

**Prompt:** 
```
What is the average of these quiz scores: 85, 90, 78, 92, 88?
```

**Response:** 
```
The average score is 86.6.
```

**Prompt:** 
```
If the passing threshold is 70, did a score of 65 pass?
```

**Response:** 
```
No, a score of 65 is below the threshold of 70.
```

**Prompt:** 
```
What is the score range for 50, 60, 70, 80, 90?
```

**Response:** 
```
The score range is 40 (from a minimum of 50 to a maximum of 90).
```

## Capabilities

### Mean Calculation
Your agent uses this to find the average score of a group.

### Range Detection
The AI identifies the gap between the highest and lowest scores.

### Threshold Checking
Your client determines if a student met a specific passing grade.

### Tier Assignment
The agent categorizes scores into qualitative performance levels.

## Use Cases

### Grading Summaries
Paste a list of scores and have your agent calculate the class average immediately.

### Passing Audits
Check a large batch of scores against a set passing requirement.

### Performance Tracking
Use tier classification to see how many students are performing at a high level.

### Gap Analysis
Determine the spread of scores to see if a test was too easy or too hard.

## Benefits

- Eliminates manual arithmetic for quiz score sets.
- Provides instant passing status based on custom thresholds.
- Categorizes student performance into readable tiers.
- Identifies score distribution through range calculations.

## How It Works

Connecting this MCP to your AI client gives it immediate access to grading math tools.

1. Connect your client to Vinkius.
2. Select the Quiz Average Analytics MCP.
3. Provide your list of quiz scores to your AI client.
4. Ask your agent to calculate averages, spreads, or passing status.

## Frequently Asked Questions

**What AI clients can use this MCP?**
You can use this with any MCP-compatible client like Claude, Cursor, Windsurf, or VS Code.

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

**Can I set my own passing grade?**
Yes, the evaluate_passing_status tool allows your agent to check scores against any threshold you define.

**How does it handle score ranges?**
The get_performance_spread tool calculates the difference between the minimum and maximum scores in your list.

**Is this for individual students or whole classes?**
It works for both. You can check a single score or a large list of scores to find class averages.

**How do I calculate the mean score?**
You can use the `get_average_score` tool by providing a list of numeric scores.

**Can I check if a student passed a quiz?**
Yes, use `evaluate_passing_status` with the average score and the required threshold.

**How is performance categorized?**
The `get_tier_classification` tool maps scores to qualitative tiers like Mastery or Needs Improvement.