# Question Bank Analyzer MCP

> Question Bank Analyzer evaluates study performance metrics to pinpoint weak subjects. It compares your accuracy rates against specific exam board requirements, telling you exactly where your knowledge falls short of the necessary standard. Use it to build a targeted plan that maximizes review time.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** study-tracker, exam-prep, performance-metrics, learning-analytics, mock-exams

## Description

Stop guessing what you should study next. This MCP is designed for serious test prep: it analyzes raw performance data and turns it into a clear action list. Your agent connects directly to this tool, assessing your knowledge across multiple subjects by identifying any topics where your accuracy dips below 50%. It doesn't just tell you that Math is hard; it shows you why. You can align your focus with major exam boards, knowing which subjects they emphasize most. Then, the system cross-references your weak spots against the board's priorities to calculate high-priority gaps—the exact topics you need to nail down immediately. You also track how your performance changes across different mock tests over time, visualizing if your study efforts are actually working. Connecting this MCP via Vinkius means any compatible client can access this deep analytical power.

## Tools

### analyze_topic_performance
Calculates a subject's accuracy rate based on submitted question scores and data.

### calculate_priority_gaps
Identifies study weaknesses by matching poor performance with board-level importance factors.

### fetch_board_focus
Retrieves the official, predefined subject focus areas for a chosen exam board.

### track_mock_evolution
Generates visualizations showing how your overall performance changes across different mock tests over time.

## Prompt Examples

**Prompt:** 
```
Analyze my performance: I got 10 correct and 15 incorrect in Math, and 20 correct and 5 incorrect in History.
```

**Response:** 
```
In Math, your hit rate is 40%, which is a critical topic. In History, your hit rate is 80%, indicating stable knowledge.
```

**Prompt:** 
```
What are the main focus areas for the FGV exam board?
```

**Response:** 
```
The primary focus areas for FGV include Portuguese, Law, and Administrative Logic.
```

**Prompt:** 
```
Identify my priority study gaps for the College Board exam based on my critical topics: ['Algebra', 'Geometry'].
```

**Response:** 
```
Your high-priority study areas for the College Board are Algebra and Geometry.
```

## Capabilities

### Diagnose weak subjects
Runs reports on subject accuracy rates to find specific topics needing immediate attention.

### Map exam board requirements
Pulls predefined lists of core subjects and importance levels for major testing organizations.

### Determine study gaps
Cross-references low performance scores with high-importance topics to generate a focused list of study targets.

### Visualize progress trends
Creates graphs showing how your overall performance improves or declines across multiple mock exams.

## Use Cases

### Reviewing for the State Board Exam
A student uploads scores from three practice tests. They run track_mock_evolution to confirm they are improving steadily, then use analyze_topic_performance to find that their performance in 'Chemistry' is consistently below 50%. The agent flags this as a critical area needing immediate focus.

### Targeting an Industry-Specific Test
A candidate needs to pass the FGV exam. They first call fetch_board_focus for FGV, getting a list of mandatory subjects. Next, they use calculate_priority_gaps, feeding in their weak spots and the board focus, resulting in a hyper-focused study list.

### Assessing overall readiness
A parent wants to know if college prep is working. They run analyze_topic_performance across several subjects and then use track_mock_evolution. The visualization shows a plateau, indicating that simply taking more tests won't help; they need to adjust their study methods.

## Benefits

- Pinpoint weak subjects immediately: Use analyze_topic_performance to see exactly where your accuracy drops below the 50% threshold, so you stop wasting time on topics you already know.
- Focus your efforts with high precision: The tool combines your poor scores and board importance data using calculate_priority_gaps. You get a definitive list of gaps that matter most for your target exam.
- Stay aligned with the exam body: fetch_board_focus pulls official focus areas from major boards like FGV or CESPE, ensuring your study plan matches what graders actually look for.
- See if you're improving: track_mock_evolution visualizes performance over time. You can prove to yourself and your coach that your dedicated effort is actually translating into better scores.
- Get a single source of truth: Instead of juggling multiple spreadsheets, this MCP brings together raw metrics, board requirements, and personal weak spots in one workflow.

## How It Works

The bottom line is you get an immediate, data-driven study plan instead of vague suggestions.

1. Feed the MCP raw scores and results from multiple practice tests.
2. Specify the target exam board (e.g., FGV, CESPE) to scope the analysis.
3. The system runs calculations to cross-reference your poor performance against the board's focus areas, outputting a prioritized list of topics.

## Frequently Asked Questions

**How is a topic considered critical?**
A topic is marked as critical if your accuracy rate for that specific subject falls below 50%.

**Can I track my progress across different mock exams?**
Yes, the `track_mock_evolution` tool allows you to see the trend in your accuracy rates from one session to another.

**How does the priority gap identification work?**
The `calculate_priority_gaps` tool cross-references your critical topics with the high-frequency subjects of a specific exam board to highlight where you should focus your efforts.

**When using `fetch_board_focus`, what specific identifiers do I need to pass for my desired exam board?**
You must provide the official acronym of the examining body, such as FGV or CESPE. The MCP uses this identifier to pull predefined subject importance data relevant only to that institution.

**What is the required format when I call `analyze_topic_performance` with raw test results?**
The tool accepts a structured input detailing the number of correct and incorrect answers for each specific subject. This allows it to calculate an accurate hit rate across all tested topics.

**Does `calculate_priority_gaps` require me to manually define the 'critical' threshold, or is there a default?**
The tool uses internal logic to flag areas where performance consistently falls below a predetermined critical accuracy rate. This automatically focuses your study plan on weak spots.

**If I run `track_mock_evolution` and receive an error, what does it usually indicate?**
An error generally means the MCP cannot find historical data matching the time parameters you provided. Double-check your date ranges or ensure results were successfully saved to the system.

**Can I use `analyze_topic_performance` if my test scores are recorded as percentages instead of counts?**
Yes, it handles both formats. You can input raw question counts (correct/incorrect) or provide a percentage score for analysis. The MCP adjusts the calculation accordingly.