# Harvest Loss Calculator MCP

> Harvest Loss Calculator quantifies physical and financial grain losses during harvest time. Use this MCP to accurately estimate yield performance across various crops, compare your results against industry benchmarks, and calculate total financial impact from harvesting inefficiencies.

## Overview
- **Category:** agriculture
- **Price:** Free
- **Tags:** harvesting, yield-loss, grain, efficiency, agronomy

## Description

You don't need to guess about your final revenue. This MCP gives you precision tools for estimating exactly how much physical or financial grain loss you incurred throughout the harvest cycle. Instead of relying on rough estimates or outdated field guides, you can instantly quantify losses in bags per hectare and calculate the dollar impact. The system lets you check industry standard maximum allowable loss for specific crops, giving you immediate context. You can also evaluate your entire harvest performance against those accepted limits. When everything is running smoothly, it shows exactly where your yield stands. We've packaged these calculations into a single catalog entry at Vinkius so you connect once and get access to this crucial agricultural data.

## Tools

### retrieve_crop_benchmark
Looks up the accepted industry maximum loss rate for a specific crop type.

### calculate_harvest_impact
Calculates total physical and financial grain losses based on harvesting inefficiencies across a field's acreage.

### assess_harvest_efficiency
Compares your actual yield losses to established industry limits, telling you if performance is acceptable or critical.

## Prompt Examples

**Prompt:** 
```
Calculate the impact of a harvest where I expect 60 bags/ha in a 100-hectare field, with 2% pre-harvest loss, 3% platform loss, and 2% threshing loss, at $25 per bag.
```

**Response:** 
```
The total loss is 7% (7 bags/ha). Across 100 hectares, you lost 700 bags, resulting in a financial loss of $17,500.
```

**Prompt:** 
```
What is the maximum acceptable loss for Soybeans?
```

**Response:** 
```
The industry standard maximum allowable loss for Soybeans is 2%.
```

**Prompt:** 
```
Is a 5% total loss in Corn considered efficient?
```

**Response:** 
```
No, a 5% loss for Corn is currently rated as 'Critical' because it exceeds the industry benchmark.
```

## Capabilities

### Calculate total loss impact
Determines the overall physical and financial revenue loss resulting from various harvesting inefficiencies.

### Check crop benchmarks
Pulls up the industry standard maximum acceptable loss rate for any specified grain type.

### Evaluate harvest efficiency
Compares your actual measured losses to established industry performance limits, flagging potential issues immediately.

## Use Cases

### A field's yield was disappointing; I need to know if it’s salvageable.
The farm manager runs the MCP and uses `assess_harvest_efficiency`. The agent returns a 'Critical' rating, showing that the total losses exceed the accepted industry limit. This immediately flags operational issues that need attention before next year.

### I sold 100 hectares of corn, but I can’t prove my loss numbers are accurate.
The consultant runs `calculate_harvest_impact` with all the field data and market prices. The agent calculates a definitive financial loss figure—say, $17,500—which is used to secure better pricing negotiations with the buyer.

### I need to know if my specialty grain (Sorghum) has stricter loss limits than Corn.
The user asks for the benchmark. The MCP calls `retrieve_crop_benchmark` and returns a specific, low percentage requirement for Sorghum, allowing the farmer to adjust machinery or techniques immediately.

### My previous harvest report was vague about *why* we lost grain.
The agent runs a full assessment using `calculate_harvest_impact`. The output breaks down losses by category (pre-harvest vs. threshing), providing concrete data that pinpoints exactly which phase caused the most significant financial damage.

## Benefits

- Stop guessing about yield loss. By running `retrieve_crop_benchmark`, you get the hard, industry-standard maximum allowable loss for any crop instantly, eliminating guesswork from your reports.
- Calculate true financial damage with `calculate_harvest_impact`. You move past just knowing how many bags are lost; you know the exact dollar amount of that shortfall across hundreds of hectares.
- Quickly rate a harvest's overall health. Use `assess_harvest_efficiency` to see if your total losses fall within acceptable limits, giving you a clear pass/fail grade for the entire season’s effort.
- Compare different fields against one standard. You can run multiple loss calculations and benchmark checks without having to manually cross-reference separate industry guides or spreadsheets.
- Improve operational reports by structuring data around real metrics. Instead of qualitative statements, you provide precise figures showing total bags lost per hectare.

## How It Works

The bottom line is that you get an actionable number showing your true profit margin after accounting for every inefficiency on the farm.

1. Identify the specific crop and input variables like expected yield, current loss percentages (e.g., pre-harvest, platform), field area, and market price.
2. Run the analysis to determine if your measured losses exceed accepted industry norms and calculate the total physical deficit across the specified acreage.
3. Receive a quantified report showing the total bags lost, the percentage of overall yield loss, and the resulting financial dollar amount.

## Frequently Asked Questions

**How does the Harvest Loss Calculator MCP work?**
This MCP calculates total physical and financial grain losses by accepting input on field area, crop type, and various loss percentages. It then compares that result against industry standards to give you a definitive performance grade.

**What kind of data does retrieve_crop_benchmark use?**
It uses established agricultural metrics to pull the maximum acceptable percentage of yield loss for specific grains, ensuring your assessment is based on current industry best practices.

**Can I calculate losses for multiple crops using Harvest Loss Calculator MCP?**
Yes. You can run separate assessments for different crops by simply changing the crop type and running `retrieve_crop_benchmark` for each one before calculating its impact.

**Does assess_harvest_efficiency only look at yield percentage?**
No, it evaluates performance against acceptable industry limits. It flags issues when your measured loss exceeds the benchmark, telling you if the efficiency is 'Critical' or within tolerance.

**Do I need to know my market price for calculate_harvest_impact?**
Yes, the financial impact calculation requires the current market price per bag so it can convert physical losses (bags) into a measurable dollar amount ($).

**How can I calculate the total financial loss from my harvest?**
Use the `calculate_harvest_impact` tool. Provide your expected yield per hectare, field area, various loss percentages (pre-harvest, platform, and threshing), and the current market price per bag.

**How do I know if my harvest efficiency is acceptable?**
You can use the `assess_harvest_efficiency` tool by providing your crop type and the actual total loss percentage you calculated. It will compare your results against industry benchmarks.

**Where can I find the standard allowable loss for a specific crop?**
Use the `retrieve_crop_benchmark` tool and specify the crop type (e.g., Wheat, Corn, or Soybeans) to get the maximum allowable loss percentage.