# Harvest Preservation Jar Plan AI Agent Connect

> Harvest Preservation Jar Plan MCP handles the math for your canning season. It converts your total crop weight into specific counts for jars and lids, while also organizing your processing batches. Instead of guessing how many supplies you need, your AI client calculates everything including headspace loss and safety reserves.

## Overview
- **Category:** agriculture
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_duBdP1CPVSK29yehfvNhB4mehEjo2bBuEGiQYlHJ/ai-agent-connect
- **Tags:** harvest, preservation, canning, agriculture, supply-chain

## Description

Managing a large harvest means you can't afford to run out of jars halfway through a processing day. This MCP takes the guesswork out of agricultural preservation by turning raw weight data into a concrete supply list and schedule. You provide the harvest weight, recipe yield, and jar size, and your agent does the rest. It accounts for the volume lost to headspace and adds safety reserves so you aren't left short. You can use it to check if your current recipe is actually practical for the amount of produce you have on hand, or to map out exactly how many batches you'll need to run through your equipment. It's a way to move from a pile of produce to a finished, organized preservation plan without manual calculations.

## Tools

### validate_recipe_efficiency
Checks if your chosen recipe yield and jar sizes actually make sense for the total harvest volume.

### calculate_jar_requirements
Determines the exact number of jars and lids you need to buy for a specific harvest.

### estimate_batch_schedule
Calculates how many separate processing batches you'll need to run based on your equipment capacity.

### summary_report_generator
Produces a single, readable plan that lists all your required supplies and processing steps.

## Prompt Examples

**Prompt:** 
```
I have 50kg of tomatoes. My recipe yields 0.8kg of sauce per kg of tomato. I am using 500ml jars with 20ml of headspace. I want a 10% reserve. How many jars and lids do I need?
```

**Response:** 
```
You will need 88 jars and 88 lids.
```

**Prompt:** 
```
I need to process 100 jars. My equipment can handle 25 jars per batch. How many batches will I need?
```

**Response:** 
```
You will need 4 batches.
```

**Prompt:** 
```
Generate a summary report for a harvest of 100kg with a yield of 0.5, using 500ml jars (10ml headspace) and a 10% reserve, with a batch capacity of 20 jars.
```

**Response:** 
```
Your preservation plan requires 110 jars and 110 lids. You will process these in 6 batches: 5 batches of 20 jars and 1 final batch of 10 jars.
```

## Capabilities

### Supply Calculation
Your agent calculates the total number of jars and lids required for your specific crop weight.

### Batch Scheduling
The MCP determines how many processing cycles you need to run based on your equipment limits.

### Recipe Validation
Your AI client checks if your recipe yield is practical for the amount of produce you harvested.

### Plan Consolidation
The tool generates a single report containing all supply needs and processing steps.

### Safety Buffering
Your agent adds reserve percentages to your jar counts to prevent running out of supplies.

## Use Cases

### Seasonal Canning Prep
Calculate exactly how many jars to buy before the tomato or peach harvest begins.

### Equipment Capacity Planning
Determine how many hours or days of processing you'll need based on your pot or pressure canner size.

### Inventory Management
Compare your calculated jar requirements against your current pantry stock.

### Workflow Organization
Create a step by step summary of all batches needed to process a large crop.

## Benefits

- Prevents supply shortages by calculating jar and lid counts with safety reserves.
- Reduces manual math by converting raw weight into processing batches.
- Organizes processing workflows by mapping out equipment capacity requirements.
- Ensures recipe practicality by checking yields against total harvest volume.

## How It Works

Connect your AI client to Vinkius and start planning your preservation work immediately.

1. Connect your preferred MCP-compatible client to the Vinkius catalog.
2. Provide your harvest weight and recipe details to your AI agent.
3. The agent uses the MCP tools to calculate jars, lids, and batches.
4. Review the final summary report to prepare your supplies and equipment.

## Frequently Asked Questions

**How does this MCP handle jar headspace?**
The tool accounts for headspace loss during its calculations to ensure you have enough jar volume for the actual product.

**Can I add a safety margin to my supply list?**
Yes, you can tell your agent to include a specific percentage for reserves, such as a 10% buffer for extra jars.

**What AI clients can I use with this MCP?**
You can use this MCP with any compatible client like Claude, Cursor, Windsurf, or VS Code.

**Does it help with equipment limitations?**
Yes, the estimate_batch_schedule tool uses your equipment's capacity to tell you how many processing cycles you'll need.

**Will it tell me if my recipe is efficient?**
Yes, the validate_recipe_efficiency tool checks if your recipe yield and jar selection are practical for your harvest size.

**How do I calculate the number of jars I need?**
You can use the `calculate_jar_requirements` tool. Provide the total harvest weight, the recipe yield, the jar volume, and the required headspace loss.

**Can I plan my processing batches?**
Yes, after calculating your jar requirements, use `estimate_batch_schedule` to determine how many processing cycles are needed based on your equipment capacity.

**What is headspace loss?**
Headspace loss is the volume of space left at the top of a jar to allow for expansion during the preservation process. This must be subtracted from the total jar volume to find the effective volume.
