# Punch-Down & Pump-Over Scheduler AI Agent Connect

> Punch-Down & Pump-Over Scheduler MCP handles the math and logistics of fermentation cap management. It calculates extraction timing, checks tank limits, and adjusts schedules based on your staff availability and temperature needs. You can connect it to your AI client to turn fermentation goals into actionable work plans.

## Overview
- **Category:** agriculture
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_598o871YTHCfMLvGQR7QVQVONFDInjwrOFD4uAqi/ai-agent-connect
- **Tags:** winemaking, fermentation, scheduling, labor-management, extraction

## Description

You can stop manually calculating extraction windows and labor shifts. This MCP gives your AI agent the specific tools needed to manage fermentation in a winery. Instead of guessing when to perform a pump-over, you can use the MCP to determine the best timing based on your specific fermentation stage and temperature targets. It doesn't just stop at timing; it looks at your actual constraints. It checks if a tank can physically handle the planned operations and ensures you aren't scheduling more work than your crew can actually handle. If your fermentation temperature spikes, the MCP can adjust the schedule to prioritize cooling through cap management. It turns your fermentation goals into a coordinated plan that respects your equipment limits and your people.

## Tools

### calculate_extraction_schedule
This tool determines the best timing and method for managing your fermentation cap. It uses current fermentation data to set an extraction plan.

### get_tank_capacity_constraints
This tool pulls the physical operational limits for a specific tank. It ensures your scheduled punch-downs and pump-overs stay within safe capacity.

### integrate_temperature_control
This tool modifies your cap management timing to help cool the fermentation vessel. It uses the schedule to assist in temperature regulation.

### optimize_labor_allocation
This tool adjusts your extraction schedule to match your staff availability. It prevents the AI from scheduling more tasks than your workers can perform.

## Prompt Examples

**Prompt:** 
```
Calculate an extraction schedule for a 500L tank in the log stage with an intense extraction goal at 22 degrees.
```

**Response:** 
```
The optimal schedule for your 500L tank includes three pump-overs: one at 14:00, one at 20:00, and one at 02:00 to meet the intense extraction goal.
```

**Prompt:** 
```
I have 2 workers available. Adjust my current schedule to fit this labor limit.
```

**Response:** 
```
The schedule has been adjusted. Two overlapping pump-overs were moved to 08:00 and 16:00 to ensure only 2 workers are required at any time.
```

**Prompt:** 
```
The temperature is 25 degrees, but I want it at 20 degrees. How should I adjust my cap management?
```

**Response:** 
```
To reach the target of 20 degrees, the schedule now prioritizes pump-over operations at 12:00 and 18:00 to maximize the cooling effect of the cap.
```

## Capabilities

### Extraction Planning
Your agent uses this to set the timing for cap management based on fermentation needs.

### Labor Management
The AI adjusts task timing so you don't exceed your available staff count.

### Temperature Regulation
Your agent modifies the schedule to help cool the tank when temperatures rise.

### Tank Constraint Checking
The AI verifies that all scheduled operations stay within the physical limits of your tanks.

## Use Cases

### Managing Temperature Spikes
When fermentation gets too hot, the AI adjusts the pump-over schedule to help cool the vessel.

### Staffing Shortages
If you are short-handed, the AI reshuffles tasks so you don't have too many overlapping operations.

### Intense Extraction
Set a specific extraction goal for a tank, and the AI will build a schedule to meet it.

### Tank Capacity Safety
The AI checks tank limits before finalizing a schedule to prevent operational errors.

## Benefits

- Prevents over-scheduling staff by matching tasks to available workers.
- Maintains fermentation temperature through timed cap management.
- Ensures all operations stay within the physical capacity of your tanks.
- Automates the math behind extraction timing.

## How It Works

You connect the MCP to your preferred AI client and start giving it fermentation parameters.

1. Connect your AI client to the Vinkius hosted MCP.
2. Provide your fermentation goals, tank size, or staff availability to your agent.
3. The agent uses the specific tools to calculate or adjust the schedule.
4. Review the resulting plan in your chat interface.

## Frequently Asked Questions

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

**How does the MCP handle staff shortages?**
The optimize_labor_allocation tool adjusts the timing of tasks to ensure you never have more work scheduled than you have people to do it.

**Can it help with cooling the wine?**
Yes. The integrate_temperature_control tool adjusts the timing of cap management to help regulate the temperature of the fermentation vessel.

**Does it account for tank size?**
Yes. The get_tank_capacity_constraints tool checks the physical limits of your specific tank to make sure the schedule is possible.

**Do I need to host this myself?**
No. Vinkius hosts and manages the MCP for you. You just connect your client and start using the tools.
