# Lunchbox Portion Calculator AI Agent Connect

> Lunchbox Portion Calculator MCP handles the math for school meal logistics. It translates student attendance schedules into precise food portion counts, helping you manage daily peaks and weekly totals without manual spreadsheets.

## Overview
- **Category:** education
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_LkXmYoHlCrwcpZdgnAmVfkdtacgt9nbQaQLMMWIr/ai-agent-connect
- **Tags:** school, meal-planning, portions, attendance, logistics

## Description

Managing school meals is a logistics puzzle where being off by even a few portions causes waste or shortages. This MCP solves that by connecting your AI client directly to your attendance data. Instead of manually counting how many kids are in on Tuesday versus Friday, you just give your agent the schedule. It calculates exactly how many portions you need to prepare to cover everyone. You can figure out total weekly needs for a whole group or drill down into what a specific child requires based on their individual attendance pattern. It also identifies peak demand days so you don't over-prepare on slow days or run out during high-attendance periods. It's a direct way to turn attendance lists into actionable kitchen prep lists.

## Tools

### get_capacity_planning
This tool calculates how many children you can feed if you have a set number of portions and a specific school schedule.

### get_child_specific_requirements
This tool determines the exact number of portions a single child needs based on their personal attendance.

### get_schedule_overlap_impact
This tool identifies the peak portion requirement for a single day by looking at the group schedule.

### get_weekly_portion_total
This tool calculates the total food portions required for all children over a standard school week.

## Prompt Examples

**Prompt:** 
```
How many portions do I need for 10 children attending school 5 days a week with a 10% buffer?
```

**Response:** 
```
You will need 55 portions in total (50 base portions plus 5 buffer portions).
```

**Prompt:** 
```
If I have 20 portions available and each child attends 4 days a week, how many children can I feed?
```

**Response:** 
```
You can fully support 5 children.
```

**Prompt:** 
```
What is the peak requirement for an attendance schedule of [5, 8, 3, 2, 4]?
```

**Response:** 
```
The peak requirement is 8 portions, and the total weekly requirement is 22 portions.
```

## Capabilities

### Weekly Totals
Your agent calculates the full week's food needs in one step.

### Peak Demand Detection
The AI identifies which specific days will require the most food based on attendance.

### Capacity Checks
You can check if your current food supply is enough to cover a specific group of students.

### Individual Tracking
The tool handles specific portion counts for individual students with unique schedules.

## Use Cases

### Weekly Prep Planning
Calculate the total number of meals to prepare for the entire school week.

### Budget Management
Determine how many students can be fed with a fixed amount of food to manage costs.

### Daily Staffing
Use peak requirement data to decide how many staff members are needed in the kitchen on high-attendance days.

### Individual Student Needs
Calculate specific portion needs for students with irregular attendance patterns.

## Benefits

- Reduces food waste by matching portions to actual attendance.
- Eliminates manual math for complex weekly schedules.
- Prevents meal shortages by identifying peak daily requirements.
- Provides instant capacity checks for limited food supplies.

## How It Works

Connect your AI client to the Vinkius-hosted MCP and start asking questions about your meal requirements.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Provide your student attendance data or schedules to your AI agent.
3. Ask the agent to calculate totals, peaks, or capacity.
4. The agent uses the specific tools to run the math.
5. Receive precise portion counts for your meal planning.

## Frequently Asked Questions

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

**Do I need to host the MCP myself?**
No, Vinkius hosts and manages the MCP for you. You just connect and use it.

**Can I calculate portions for just one student?**
Yes, the tool includes a specific function to determine requirements for an individual child based on their attendance.

**How does it handle peak days?**
The tool analyzes the group schedule to find the day with the highest number of students, helping you prepare for peak demand.

**Can I check if I have enough food for a group?**
Yes, you can use the capacity planning tool to see how many children your current portions will cover.

**How do I calculate the total portions for a whole week?**
You can use the `get_weekly_portion_total` tool by providing the number of children, the days they attend, and an optional buffer percentage.

**Can I plan for peak daily demand?**
Yes, the `get_schedule_overlap_impact` tool allows you to input a daily attendance list to find the maximum portions needed on any single day.

**How many children can I feed with a limited supply?**
Use the `get_capacity_planning` tool to determine the maximum number of children supported by your available portions.
