# Food Donation Allocation AI Agent Connect > Food Donation Allocation MCP acts as a logistics engine for food rescue operations. It connects your AI client to surplus food inventories and recipient organizations, allowing your agent to identify available supplies, find groups with matching dietary needs, and build distribution plans that respect transport limits and food expiry. ## Overview - **Category:** supply-chain - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_9AEaYEJZNHbXIDbkUOn0S0Vm9AHMh8RwLb0J2x05/ai-agent-connect - **Tags:** food-waste, logistics, optimization, donation, dietary-matching ## Description You can use this MCP to turn surplus food inventories into actionable donation plans. Instead of manually checking what's in the fridge and who needs it, you let your AI client handle the heavy lifting of logistics. It bridges the gap between food waste and hungry communities by managing the complex math of dietary requirements and transport constraints. Your agent can look at what food is sitting in storage and immediately find recipient groups that can actually use it. It doesn't just suggest where food goes; it calculates routes and quantities that fit within your vehicle capacities and prioritize items that are about to expire. You get a system that ensures food reaches the right hands before it spoils, keeping the logistics of food rescue organized and efficient. ## Tools ### calculate_optimal_allocation This tool generates a distribution plan based on your specific constraints. It builds a suggestion that balances recipient priority with transport limits and food expiry. ### find_eligible_recipients This tool identifies specific groups capable of receiving certain types of food. It filters recipient organizations based on their ability to handle the food you have available. ### query_available_surplus This tool pulls a list of all currently available food supplies. It identifies items that have not yet been assigned to a recipient. ### validate_allocation_feasibility This tool checks if a proposed distribution plan is actually possible. It verifies that the plan respects both physical transport limits and specific dietary constraints. ## Prompt Examples **Prompt:** ``` What surplus food is currently available that is vegan? ``` **Response:** ``` The available vegan surplus includes 50 portions of organic lentils and 30 portions of quinoa. ``` **Prompt:** ``` Find recipient groups that can accept gluten-free food. ``` **Response:** ``` The eligible recipient groups are Community Kitchen Alpha and the City Food Bank. ``` **Prompt:** ``` Create an allocation plan for these food IDs: food_1, food_2 with a transport limit of 100 portions. ``` **Response:** ``` The optimal allocation plan distributes 60 portions of food_1 to Recipient_A and 40 portions of food_2 to Recipient_B, utilizing the full 100 portion transport capacity. ``` ## Capabilities ### Inventory Tracking Your agent identifies unallocated food supplies in real time. ### Dietary Matching The AI finds recipient groups that meet specific nutritional or dietary requirements. ### Logistics Planning Your agent builds distribution plans that stay within vehicle and transport limits. ### Feasibility Checking The system verifies that a proposed plan is physically and dietarily possible before you execute it. ### Waste Reduction The AI prioritizes food items based on expiry to minimize spoilage. ## Use Cases ### Daily Surplus Distribution A food rescue organization uses the AI to quickly match daily grocery surpluses with local shelters. ### Dietary Requirement Compliance An agent identifies which food donations can safely go to groups with specific allergy or dietary restrictions. ### Transport Optimization A logistics team uses the tool to plan deliveries that maximize the use of available truck space. ### Expiry Management The AI prioritizes the distribution of perishable goods to ensure they are consumed before they spoil. ## Benefits - Reduces food waste by prioritizing items nearing expiry. - Matches food types to recipient dietary needs automatically. - Prevents over-allocation by respecting transport capacity limits. - Validates plans to ensure they are physically possible to execute. ## How It Works Setting up this MCP is a single-step process that connects your agent to your logistics data. 1. Connect your preferred MCP-compatible client to Vinkius. 2. Your agent queries the available food surplus via the MCP. 3. The AI identifies eligible recipient groups based on dietary needs. 4. The agent calculates an optimal allocation plan considering transport limits. 5. The system validates the plan for feasibility before finalization. ## Frequently Asked Questions **How does this MCP help reduce food waste?** It uses expiry priority to ensure food that is about to spoil is allocated to recipients first. **Can I use this with my existing AI client?** Yes, you can connect this MCP to any MCP-compatible client like Claude, Cursor, or Windsurf. **Does it handle dietary restrictions?** Yes, the tool finds recipient groups that meet specific dietary requirements to ensure safe food distribution. **How are transport limits managed?** The calculate_optimal_allocation tool generates plans that respect the specific transport limits you provide. **Do I need to host the MCP myself?** No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately after connection. **How does the tool handle food expiration?** The `calculate_optimal_allocation` tool prioritizes items with the earliest expiration dates to ensure food is distributed before it spoils. **Can I filter food by dietary requirements?** Yes, you can use `query_available_surplus` with a dietary filter or use `find_eligible_recipients` to find groups that match specific dietary tags. **How are transport constraints managed?** The `transportLimit` parameter in `calculate_optimal_allocation` ensures that the total portions allocated do not exceed the available transport capacity.