# Training Load Calculator MCP

> The Training Load Calculator MCP quantifies physiological stress in athletic training. It determines a session’s total physical load and checks current weekly patterns against baseline metrics. Use this to spot overtraining risk early, then generate specific recovery plans so athletes can adapt without risking injury.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** training-load, rpe, overtraining, deload, fitness-tracking

## Description

Managing an athlete's training is about more than just hitting milestones; it's about managing stress. This MCP provides the tools coaches need to quantify that stress and predict fatigue before it hits. You first calculate a single session’s total physical burden, understanding exactly what kind of work was done. Next, you compare that load against historical data to see if your athlete is trending toward overreaching or burnout. If the numbers suggest a slowdown, you don't just guess; you generate precise deload targets for volume and intensity reduction. Connecting this tool via Vinkius means your agent can pull these metrics into whatever client you use—be it Claude, Cursor, or Windsurf—making adaptation planning faster than ever.

## Tools

### generate_deload_strategy
Calculates specific training targets for an upcoming recovery week, giving precise goals for volume and intensity reduction.

### analyze_overtraining_risk
Evaluates current training patterns against a baseline to give a clear status on whether the athlete is at high risk of overtraining.

### calculate_session_load
Determines the total physiological stress for one completed training session by combining volume and perceived intensity.

## Prompt Examples

**Prompt:** 
```
Calculate the load for a session with 5000kg volume and an RPE of 8.
```

**Response:** 
```
The `calculate_session_load` tool would return a session load of 40000.
```

**Prompt:** 
```
Check my overtraining risk with a weekly load of 50000 and a baseline of 40000.
```

**Response:** 
```
The `analyze_overtraining_risk` tool would evaluate the increase in load and provide your current risk status and level.
```

**Prompt:** 
```
Generate a deload strategy for 3000kg volume and intensity 7, reducing by 25%.
```

**Response:** 
```
The `generate_deload_strategy` tool will calculate the new target volume of 2250kg and a reduced intensity level.
```

## Capabilities

### Assess session stress
Calculates the total physical strain from a single training day using volume and perceived effort.

### Check for fatigue risk
Compares current weekly load to a baseline to determine if the athlete is at high risk of overtraining.

### Plan recovery targets
Creates specific, measurable goals for reducing volume and intensity during a planned rest week.

## Use Cases

### Athlete shows sudden fatigue after a peak week
The coach inputs the last two weeks' worth of activity into the system. The agent runs analyze_overtraining_risk, which flags a high risk score due to insufficient recovery time. The coach then uses generate_deload_strategy to immediately plan a 4-day reduction phase.

### Designing a new strength circuit
A PT needs to know if the current session is too taxing for an injured client. They use calculate_session_load, inputting the weight and effort levels, and receive a stress score that tells them exactly where they can reduce volume without sacrificing therapeutic benefit.

### Managing a whole team's pre-competition phase
The performance director feeds all players’ weekly loads into the system. The agent analyzes overtraining risk for every athlete and generates an averaged deload strategy that can be applied across the entire group, keeping everyone safe.

## Benefits

- Spotting Danger Early: Instead of waiting for an injury, you use analyze_overtraining_risk to see if the athlete's current load pattern is heading toward burnout.
- Precise Recovery Planning: You get specific numbers—not vague advice. generate_deload_strategy tells you exactly what volume and intensity levels to hit during a rest week.
- Instant Session Grading: Calculate the total physiological stress for any single session using calculate_session_load, giving immediate feedback on the quality of the work done.
- Better Periodization: You move beyond simple percentages. By tracking load and risk over time, you can build smarter training cycles that promote adaptation without burnout.
- Time Savings: Your agent handles the math. Instead of manually cross-referencing ACWR data across multiple sheets, your client runs the numbers instantly.

## How It Works

The bottom line is that you move from raw data points to actionable, scientifically backed training adjustments in a few clicks.

1. Input the athlete's data—for example, total weight lifted (volume) and their perceived effort score (RPE)—to calculate the initial session load.
2. Feed that calculated load into a risk analysis tool. It compares this new number against long-term trends to flag potential overtraining issues.
3. Based on the high or low risk assessment, run the recovery generator to get specific targets for volume and intensity reduction.

## Frequently Asked Questions

**How do I find out my athlete’s risk using analyze_overtraining_risk?**
You run this tool after you have calculated a sufficient number of weekly loads. It compares your current load pattern against the established baseline and gives you a clear status: low, medium, or high risk.

**What data do I need for calculate_session_load?**
You only need two inputs: the total volume (weight x reps) and the perceived intensity score (RPE). The tool handles the rest of the calculation for you.

**Can I use generate_deload_strategy without running analyze_overtraining_risk first?**
You can, but it's not ideal. Running the risk analysis first ensures your deload plan is based on an objective warning signal rather than just a general feeling.

**Does Training Load Calculator handle multiple athletes?**
Yes. Because these tools operate on quantifiable data points, you can run the assessment for every athlete in your group sequentially to manage their loads individually.

**If I use calculate_session_load with mismatched units, how does it handle the error?**
The tool returns a specific error code identifying which input failed. You must ensure your volume and intensity measurements are in consistent units before running the calculation.

**Does analyze_overtraining_risk function reliably with all my AI clients?**
Yes, because this is an MCP hosted on Vinkius, any compatible client, like Cursor or Claude, can invoke the tool. You just connect your agent to the catalog.

**When I run generate_deload_strategy, does it remember previous load data?**
No, the tool processes each request independently for maximum security. Always provide the necessary baseline metrics in the prompt so the strategy calculation is accurate.

**Are there rate limits when I frequently check my risk using analyze_overtraining_risk?**
Vinkius manages overall usage, and you will see any specific throttling or rate limit details directly in the API response. Keep an eye on those status codes.

**How is training load calculated?**
The session load is calculated by multiplying the total volume of work (e.g., kilograms or kilometers) by the Rate of Perceived Exertion (RPE).

**What does overtraining risk analysis involve?**
The tool compares your current weekly training load against a stable baseline load to determine if you are in maintenance, accumulation, or at risk of overtraining.

**How can I use the deload strategy tool?**
Provide your most recent training volume and intensity, and optionally a reduction percentage. The tool will then generate specific targets for your recovery week.