# Heat Cycle Tracker MCP

> Heat Cycle Tracker predicts reproductive cycles and fertile periods for unspayed animals, using established breed data. It gives you specific dates for upcoming heat windows, estimates overall cycle length, and maps out every physiological phase—like Proestrus or Estrus—based on the animal's lineage.

## Overview
- **Category:** biology
- **Price:** Free
- **Tags:** animal-health, reproduction, fertile-window, breed-data, estrous-cycle

## Description

Managing breeding schedules requires precise timing. This MCP handles biological predictions by analyzing a female animal’s breed profile to estimate her estrous cycles. You can determine the exact date of the next fertile window, predict when she'll start her next heat cycle, and get a full timeline showing every physiological phase—Proestrus, Estrus, Diestrus, and Anestrus. It doesn't just guess; it maps out the entire expected biological sequence using breed-specific averages. If you connect your AI client through Vinkius, this MCP instantly makes that complex data available to your agent, letting you focus on care instead of calculating dates in spreadsheets.

## Tools

### get_breed_metadata
Retrieves average cycle duration and phase distribution data for any specific breed.

### segment_cycle_phases
Generates a complete, chronological breakdown of all expected biological phases for one full cycle.

### calculate_upcoming_heat
Predicts the estimated date and fertile window for an animal's next heat cycle.

## Prompt Examples

**Prompt:** 
```
Get the metadata for a Golden Retriever.
```

**Response:** 
```
The average cycle duration for a Golden Retriever is 120 days, with specific proportions for Proestrus, Estrus, Diestrus, and Anestrus.
```

**Prompt:** 
```
Predict the next heat date for a Siamese cat starting from 2023-01-01.
```

**Response:** 
```
The estimated next heat date is calculated based on the Siamese breed's biological baseline, providing a predicted fertile window.
```

**Prompt:** 
```
Show me the cycle phases for a Beagle starting on 2023-05-10.
```

**Response:** 
```
The timeline includes Proestrus, Estrus, Diestrus, and Anestrus phases with specific start and end dates derived from the Beagle's cycle length.
```

## Capabilities

### Predicting Future Heat Windows
The system calculates the estimated start date and duration of an animal's next fertile window.

### Mapping Cycle Phases Chronologically
It provides a detailed, step-by-step timeline showing all expected biological phases for a single cycle.

### Retrieving Breed Baselines
You can pull average cycle lengths and phase distributions specific to any given breed type.

## Use Cases

### Scheduling Breeding Groups
A farm manager needs to coordinate breeding for 15 ewes. Instead of tracking them manually, they run the MCP using `get_breed_metadata` and `calculate_upcoming_heat`. The agent quickly predicts the next three heat windows across all 15 animals, allowing the manager to schedule feed deliveries and vet visits efficiently.

### Advising on Timing
A client asks if their pet is ready for breeding. Instead of a general guess, the vet uses `segment_cycle_phases` with the breed data. The MCP returns a clear timeline showing exactly which phase (e.g., Proestrus) they are in and when the next window starts.

### Analyzing Historical Data Gaps
A vet is reviewing old records for an unusual cycle pattern. They use `get_breed_metadata` to establish the breed's standard baseline, then compare it against the historical data points, quickly identifying any significant deviations from the norm.

### Immediate Prediction
The owner calls with a question about when her cat will cycle. The agent runs `calculate_upcoming_heat` based on the breed and last observed date, providing an immediate, predicted fertile window to help plan for the next few weeks.

## Benefits

- Stop guessing. Instead of relying on generalized averages, the `get_breed_metadata` tool provides cycle duration and phase proportions tailored specifically to the animal’s breed.
- Save time planning. The `calculate_upcoming_heat` tool instantly predicts when the next fertile window starts, so you can schedule monitoring appointments weeks ahead of time.
- See the full picture. By running `segment_cycle_phases`, you get a complete timeline mapping out every phase—Proestrus through Anestrus—not just the 'hot' dates.
- Better record keeping. You can use this MCP to document precise, predicted cycle data for breeding records, making annual tracking simple and reliable.
- Quick context checks. Need a baseline? Just running `get_breed_metadata` gives you immediate access to average biological standards without deep research.

## How It Works

The bottom line is you get accurate, predictable dates and phases without manually calculating anything.

1. Supply the MCP with the animal's breed and a starting date.
2. The system uses that information to run calculations, pulling relevant biological baselines for the breed.
3. You receive a clear forecast: either a predicted next heat window or a complete phased timeline for the cycle.

## Frequently Asked Questions

**How does calculate_upcoming_heat work with my breed data?**
The `calculate_upcoming_heat` tool uses your specified breed to pull average baseline data, then predicts the next fertile window based on that biological standard.

**Can I find out the cycle phases for a specific dog breed using segment_cycle_phases?**
Yes. The `segment_cycle_phases` tool generates a complete chronological breakdown, listing all expected stages like Proestrus and Estrus with defined dates.

**What data does get_breed_metadata provide?**
This tool provides the essential biological context by retrieving average cycle duration and how those durations are distributed across all known phases for that breed.

**Is this MCP better than just using general veterinary guides?**
Yes. This MCP uses specialized data to perform calculations, giving you a dynamic prediction based on the animal's specific lineage rather than static textbook averages.

**If I use get_breed_metadata, what happens if I input an incomplete or ambiguous breed name?**
The MCP will return a specific error code detailing why the breed name is unusable. You must correct the formatting or provide a more precise common name to successfully retrieve the average cycle data.

**What should I do if calculate_upcoming_heat fails because the initial date was too far in the past?**
The system will return an error indicating that your starting date falls outside the calculation window. Adjust your input date to a more recent timeframe, and the MCP can recalculate the next predicted heat window.

**Are there rate limits if I need to run multiple cycles through segment_cycle_phases in one session?**
The platform supports high volume usage. However, executing more than ten detailed cycle breakdowns within a single minute may trigger a temporary limit. Wait a short period, or distribute your queries across different time segments.

**How does get_breed_metadata ensure the privacy of sensitive breed information I input?**
All data passed to this MCP is encrypted using standard protocols. Vinkius processes the metadata solely for calculation purposes, and results aren't permanently stored unless your connected client actively saves them.

**What information does `get_breed_metadata` provide?**
It returns the average cycle duration and the percentage of time spent in each phase (Proestrus, Estrus, Diestrus, and Anestrus) for a specific breed.

**How is the fertile window calculated in `calculate_upcoming_heat`?**
The tool uses the date of the last heat and the breed's specific Estrus phase proportion to estimate the start and end dates of the next fertile period.

**Can I see a full timeline of the cycle phases?**
Yes, using the `segment_cycle_phases` tool, you can get a chronological breakdown of all biological stages for a specific cycle start date.