# Litter Size Estimator MCP

> Litter Size Estimator predicts puppy litter sizes using breed and physical size data. Input a dog's specific type (Small, Medium, or Large) and the breed name; the MCP returns the estimated average number of puppies, plus minimum and maximum expected ranges.

## Overview
- **Category:** biology
- **Price:** Free
- **Tags:** dogs, puppies, breeding, canine, estimation

## Description

Predicting litter size requires more than just general knowledge—it needs precise data. This connector handles biological estimates for canine litters. You input a dog's specific breed and its relative size (Small, Medium, or Large). The system calculates not only the average number of pups but also a reliable minimum and maximum range. If you need to know what breeds are available in the database, this tool helps with that index check. Need general data for a particular breed without running an estimate? That's covered too. All these functions run through Vinkius’s catalog, making sure your agent can access specialized biological tools right when you need them.

## Tools

### calculate_litter_estimate
Predicts how many puppies might be in a litter based on the dog's breed and size.

### list_supported_breeds
Returns a list of every single dog breed that is included in the database.

### lookup_breed_statistics
Retrieves general, non-estimated litter size data for an entire breed.

## Prompt Examples

**Prompt:** 
```
What is the expected litter size for a Golden Retriever that is Medium sized?
```

**Response:** 
```
For a Medium-sized Golden Retriever, the estimated average litter size is 6 puppies (Range: 4 - 8).
```

**Prompt:** 
```
Show me all breeds available in the estimator.
```

**Response:** 
```
The following breeds are supported: [List of breeds retrieved via `list_supported_breeds`].
```

**Prompt:** 
```
What are the general statistics for a Bulldog?
```

**Response:** 
```
The general litter size statistics for a Bulldog are: Average 5, Minimum 3, Maximum 7.
```

## Capabilities

### Predicting Litter Ranges
Calculates the estimated minimum, maximum, and average number of puppies for a given breed and size.

### Retrieving Breed Index
Generates an exhaustive list of all dog breeds supported by the estimation database.

### Getting General Statistics
Looks up general, historical litter size data for any specified breed.

## Use Cases

### Planning a Breeding Program
A breeder needs to know if they can safely plan for a large litter of Mastiffs. They ask their agent: 'What is the expected litter size for a Medium-sized Mastiff?' The agent uses `calculate_litter_estimate` and returns the average, min, and max range immediately.

### Identifying Unknown Breeds
A client calls about a dog breed they can't name. They ask their agent to run `list_supported_breeds`. The agent pulls up the full list so they can narrow down the exact type of canine.

### Cross-Checking Data Points
A vet needs quick data on Dachshunds. They first use `lookup_breed_statistics` to check historical averages, and then run `calculate_litter_estimate` to give the client a more precise prediction based on size.

## Benefits

- Stop guessing the litter count. Use `calculate_litter_estimate` to get a reliable average, minimum, and maximum range for any dog type.
- Need to confirm what breeds are available in the system? Call `list_supported_breeds` to pull up the full, current index instantly.
- Don't just want an estimate? Use `lookup_breed_statistics` to check general historical data for a breed without needing size inputs.
- It works fast. Your agent processes these biological calculations in seconds, letting you get back to your actual work instead of waiting on spreadsheets.
- The MCP handles the complexity. You just provide the breed and size, and you get accurate, actionable numbers.

## How It Works

The bottom line is you get reliable estimates and statistics without having to manually consult multiple veterinary guides.

1. Specify the target dog's breed and its physical size (Small, Medium, or Large).
2. The MCP executes the prediction model, cross-referencing known biological data for that specific combination.
3. Your agent returns a structured output detailing the average estimate along with the predicted safe range of puppies.

## Frequently Asked Questions

**How accurate are these estimates?**
Estimates are based on hardcoded population datasets representing biological trends in specific breeds and size classes.

**What dog sizes are supported?**
The tool supports three physical categories: Small, Medium, and Large.

**Can I see all available breeds?**
Yes, you can use the `list_supported_breeds` tool to retrieve a complete list of all supported breed names.

**When should I use `lookup_breed_statistics` instead of running a calculation?**
You use this tool when you need broad data points for a breed. It gives general ranges and averages, unlike the estimate which predicts a specific outcome based on your provided size.

**What happens if I run `calculate_litter_estimate` without providing a physical size?**
The system requires a defined size (Small, Medium, or Large) to calculate an estimate. If you omit the size parameter, the tool will return an input error telling you which field is missing.

**If I try to use `calculate_litter_estimate` with a breed name not in the database, what kind of error do I get?**
The MCP handles invalid inputs gracefully. It will return an error stating that the specified breed is unsupported and list the correct format needed for successful execution.

**Does this MCP require any special setup or API keys outside of connecting through Vinkius?**
No. Since this MCP runs entirely within the Vinkius ecosystem, you don't need to manage external keys or handle complex authentication protocols yourself.

**How complete is the list when I use `list_supported_breeds`?**
The tool provides a comprehensive list of all currently supported breeds in our database. This includes common and specialized breeds used for accurate canine biological predictions.