# Heart Rate Zones Calculator MCP

> Heart Rate Zones Calculator uses the scientifically validated Karvonen formula to pinpoint precise aerobic training zones for any client. You input age and resting heart rate, and this MCP instantly computes your Heart Rate Reserve (HRR) and provides specific BPM boundaries for all five intensity levels. It's essential for coaches who need accurate data for metabolic targeting, like maximizing fat oxidation or pushing the anaerobic threshold.

## Overview
- **Category:** health
- **Price:** Free
- **Tags:** heart-rate, training-zones, karvonen, fitness-tracking, cardio

## Description

Designing a workout plan shouldn't involve pulling up multiple charts and running complex math equations by hand. This MCP handles the entire physiological calculation suite instantly. You tell your AI client your starting metrics—like age and resting heart rate—and it runs the necessary calculations to establish your Heart Rate Reserve (HRR). From there, it calculates specific BPM boundaries for every training zone, giving you actionable ranges instead of vague guidelines. It also pulls up standard definitions so you know exactly what 'moderate' or 'hard' means physiologically. This makes planning targeted workouts simple and reliable. By connecting this MCP through the Vinkius catalog, your agent gets immediate access to a full suite of specialized tools without needing dozens of external integrations.

## Tools

### estimate_max_hr
Estimate maximum heart rate based on age and gender

### calculate_karvonen_zones
Calculate training zones using the Karvonen (HRR) method

### calculate_simple_zones
Calculate training zones using simple percentage of MaxHR

## Prompt Examples

**Prompt:** 
```
I am a 30-year-old male. What is my estimated max heart rate?
```

**Response:** 
```
Based on the Tanaka model for a 30-year-old male, your estimated maximum heart rate is 191 BPM.
```

**Prompt:** 
```
My max HR is 180 and my resting HR is 60. What are my training zones using the Karvonen method?
```

**Response:** 
```
Using the Karvonen method, your training zones are: Zone 1 (90-108 BPM), Zone 2 (108-126 BPM), Zone 3 (126-144 BPM), Zone 4 (144-162 BPM), and Zone 5 (162-180 BPM).
```

**Prompt:** 
```
Calculate my simple training zones if my max HR is 190.
```

**Response:** 
```
Based on a maximum heart rate of 190 BPM, your simple intensity zones are: Zone 1 (95-114 BPM), Zone 2 (114-133 BPM), Zone 3 (133-152 BPM), Zone 4 (152-171 BPM), and Zone 5 (171-190 BPM).
```

## Capabilities

### Determine Heart Rate Reserve
Calculate a client's baseline Heart Rate Reserve (HRR) using age and resting heart rate.

### Establish Full Zone Boundaries
Compute the exact BPM range for all five recognized training zones based on your calculated HRR.

### Define Training Intensity Levels
Retrieve standard, percentage-based descriptions for heart rate zones (e.g., 'light' or 'hard').

## Use Cases

### Designing a Fat Oxidation Block
A coach needs to build a 4-week plan focused on fat burning. Instead of guessing, they ask their agent to calculate the low end zone using `calculate_zone_ranges`, ensuring every workout stays within the optimal metabolic range.

### Post-Injury Return Plan
A physical therapist needs a safe starting point for an athlete who just recovered. They use `calculate_heart_rate_reserve` to get the baseline HRR, then immediately run the zone ranges to set conservative but effective targets.

### Comparing Training Regimens
A sports scientist needs to compare two different workout methods. They ask their agent to use `get_zone_definitions` first for reference, and then calculate zones using the full suite of tools to give measurable data.

### Quick Client Check-in
A coach is reviewing a client's metrics. They simply ask their agent to 'Calculate my heart rate zones,' triggering multiple tool calls and delivering a comprehensive, ready-to-read plan instantly.

## Benefits

- Get precise boundaries instantly. Instead of guesswork, use `calculate_zone_ranges` to get specific BPM ranges for every zone (Zone 1 through Zone 5).
- Establish a strong baseline first. You can start by running `calculate_heart_rate_reserve`, giving you the fundamental HRR needed for all subsequent calculations.
- Understand the effort level. Run `get_zone_definitions` to confirm what 'moderate' or 'hard' means in percentage terms, adding clarity to your plans.
- Target specific goals. Need to train closer to the anaerobic threshold? The calculated zones guide you directly without needing multiple formulas.
- Save time on math. Your agent handles all the complex physiological math—no more manual lookups or spreadsheet errors.

## How It Works

The bottom line is you get a precise, calculated workout plan ready to send directly from your agent.

1. First, provide your age and resting heart rate to calculate the Heart Rate Reserve using `calculate_heart_rate_reserve`.
2. Next, use that reserve value to compute specific BPM boundaries for all five training zones with `calculate_zone_ranges`.
3. Finally, run `get_zone_definitions` to confirm what those numbers mean in terms of general physiological effort.

## Frequently Asked Questions

**How do I use `calculate_heart_rate_reserve` for my client?**
You provide the agent with your client's age and their current resting heart rate. The tool then returns their specific Heart Rate Reserve (HRR), which is the critical first number needed for all other calculations.

**What is the purpose of `get_zone_definitions`?**
It retrieves the standard meanings behind the zones. If you need to explain to a client that 'Zone 2' means light effort (60-70% of HRR), this tool provides those definitions.

**Does `calculate_zone_ranges` use my RHR?**
Yes, it relies on the Heart Rate Reserve that you calculated first. It uses that specific baseline to ensure all five zone boundaries are accurate for your client.

**Can I calculate zones without using this MCP?**
You can use general online calculators, but they often miss critical steps or don't provide the full suite of definitions. This MCP ensures you get the most scientifically rigorous and complete data set.

**What specific data points does `calculate_heart_rate_reserve` need to run?**
It requires three inputs: your age, your resting heart rate (RHR), and an estimate of your maximum heart rate. Your agent will prompt you for these values to correctly apply the Karvonen formula.

**What happens if I pass invalid data when calling `calculate_zone_ranges`?**
The tool returns a specific validation error message pointing out which input is incorrect. Always double-check that your provided BPM boundaries make physiological sense before running the function.

**Do I need to configure anything in my AI client before using `get_zone_definitions`?**
No setup is needed beyond connecting your agent to Vinkius. Once connected, you simply invoke the function name; the tool handles retrieving and listing the standard zone descriptions.

**How accurate are the results from `calculate_heart_rate_reserve`?**
The formulas used are scientifically recognized, but the output depends entirely on the accuracy of your inputs. Use the calculation as a strong guide for training, not as absolute medical fact.

**What is the difference between the Simple and Karvonen methods?**
The Simple method uses a fixed percentage of your maximum heart rate. The Karvonen method uses your Heart Rate Reserve (Max HR minus Resting HR), making it more personalized to your current fitness level.

**How accurate are the maximum heart rate predictions?**
The tool uses scientifically validated models like Tanaka and Gulati. While highly accurate for general populations, clinical testing remains the gold standard.

**Can I use this to plan my interval training?**
Yes, by using `calculate_karvonen_zones`, you can identify the exact BPM ranges for Zone 4 (Anaerobic) and Zone 5 (Maximum Effort) to structure your intervals.