# Mastery Progression Calculator MCP

> Mastery Progression Calculator simulates your advancement through skill mastery tiers—Bronze, Silver, Gold, and Platinum. Plug in your typical usage rate per hour to map out exactly how long you'll take to hit any rank. It lets you analyze streak bonuses and predict total cumulative rewards along the way.

## Overview
- **Category:** gaming
- **Price:** Free
- **Tags:** mastery, progression, gaming-stats, skill-leveling, efficiency

## Description

This MCP gives you a clear picture of skill progression. Instead of guessing when you’ll reach the next rank, it calculates your entire roadmap through mastery tiers. You just tell it how often you use your skills, and it handles the rest, giving you an accurate timeline from start to Platinum. Need to see how much time a single tier requires? It figures that out. Want to know what total rewards you’ll rack up by Gold? That data is available too. If you're tracking progression for a game or system, this MCP provides the predictive analytics you need. Vinkius makes connecting these deep analytical tools simple, letting your agent access complex gaming stats without needing specialized software.

## Tools

### get_cumulative_reward_value
Calculates the sum of all bonuses earned up to a specific mastery rank.

### get_total_progression_timeline
Maps out the complete schedule and hours needed to advance through every available mastery tier.

### calculate_streak_acceleration_factor
Analyzes how a continuous streak bonus increases or decreases your overall rate of progress.

### get_tier_duration
Outputs the precise number of hours required to move from one mastery rank to the next defined level.

## Prompt Examples

**Prompt:** 
```
How long will it take me to reach Platinum if I use my skills 50 times per hour?
```

**Response:** 
```
Based on a rate of 50 uses per hour, your total progression time to reach Platinum is 120 hours, with each tier breakdown provided in the timeline.
```

**Prompt:** 
```
What is the impact of a 1.5x streak multiplier on my base usage rate of 40 uses per hour?
```

**Response:** 
```
A 1.5x streak multiplier increases your progression speed by 50%, resulting in an effective usage rate of 60 uses per hour.
```

**Prompt:** 
```
How many total rewards will I have accumulated once I reach the Gold tier?
```

**Response:** 
```
Upon reaching the Gold tier, your total accumulated reward value is 150 units.
```

## Capabilities

### Model total advancement roadmap
Generates a complete schedule showing how many hours it will take to reach the final Platinum rank.

### Determine time for specific ranks
Calculates the precise number of hours required just to pass through one particular mastery tier.

### Analyze streak bonus impact
Assesses how a running streak multiplier changes your effective progression speed and efficiency.

### Track total accrued bonuses
Sums up all the rewards you'll collect from the start until you hit any specific tier level.

## Use Cases

### The new 'Gold' rank feels too fast.
A designer needs to slow down the Gold tier. Instead of guessing, they run get_tier_duration and find that increasing the required hours from 50 to 75 will provide the necessary difficulty boost without affecting other ranks.

### We need to know total rewards at Platinum.
A PM wants to ensure players feel rewarded enough to keep playing until they reach the highest rank. They use get_cumulative_reward_value to predict the maximum bonus value, which then informs marketing copy.

### How does a 2x streak affect my timeline?
A data analyst needs to test player retention with a new feature. They input their base usage rate and run calculate_streak_acceleration_factor to see the exact percentage increase in speed, making sure it doesn't accelerate progress too much.

### The whole progression feels undefined.
A team lead wants a single source of truth for player journey estimates. They use get_total_progression_timeline to generate one comprehensive chart showing the required hours from Bronze all the way through Platinum.

## Benefits

- Predicting Milestones: Use get_total_progression_timeline to immediately see the full roadmap, eliminating guesswork about when players hit Platinum.
- Tuning Difficulty: Running simulations with get_tier_duration allows you to balance game difficulty by setting precise time requirements for specific ranks.
- Balancing Rewards: By running get_cumulative_reward_value, you can ensure that rewards feel appropriate and motivating at every major achievement point.
- Modeling Efficiency: calculate_streak_acceleration_factor lets you test how heavily streak bonuses impact player speed before committing to the mechanic.
- Clear Data Outputs: All calculations provide hard numbers for hours or units, giving your team reliable metrics instead of vague estimates.

## How It Works

The bottom line is, it takes raw usage data and translates it into predictive timelines so you know exactly when to expect major milestones.

1. Tell your AI client how many times per hour you typically use your skills.
2. Run the calculation, specifying which mastery rank or metric you want to analyze (e.g., total time, specific tier duration, or cumulative rewards).
3. The MCP returns a concrete number, giving you the hours needed for that milestone.

## Frequently Asked Questions

**How does the Mastery Progression Calculator handle streak bonuses?**
It analyzes this with calculate_streak_acceleration_factor. This tool determines the exact multiplier effect of streaks, so you know if a bonus truly speeds up progression or just offers a minor boost.

**What is needed to find out how long I will reach Platinum?**
You need your average skill uses per hour. Then, use get_total_progression_timeline to generate the complete roadmap from start to finish.

**Can this MCP tell me what my total rewards are at Gold tier?**
Yes, you can run get_cumulative_reward_value. This tool sums up all bonuses earned through the ranks and gives you a concrete reward value upon hitting Gold.

**What if I want to know just how long one specific rank takes?**
Use the get_tier_duration tool. You simply input the start and end tiers, and it calculates the required hours for that precise segment of progress.