# Weekly Grocery Plan AI Agent Connect > Weekly Grocery Plan MCP connects your AI client to your kitchen management. It compares what you want to cook against what you already have in your pantry to figure out exactly what needs to be bought. It handles the math for ingredient quantities, adjusts for real-world package sizes, and keeps you under budget by suggesting cheaper alternatives when needed. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_n2wuVGsQEsBjd6EHpJyHTPsBUgc2DzDUs6YSjMjJ/ai-agent-connect - **Tags:** grocery, meal-planning, budgeting, pantry, shopping-list ## Description Stop guessing what's in your pantry or overbuying at the store. This MCP acts as the logic layer between your meal ideas and your actual kitchen stock. When you tell your AI client what you want to eat for the week, it doesn't just give you a recipe. It looks at your current inventory and calculates the net amount of ingredients you actually need to purchase. It accounts for the fact that you can't buy half a bag of flour or a single egg, so it rounds requirements to realistic package sizes. If a specific ingredient is driving your total cost too high, your agent can suggest cheaper substitutes to keep you on track. You can use this with Claude, Cursor, Windsurf, or VS Code through Vinkius to turn a simple meal plan into a functional, cost-effective shopping trip. ## Tools ### calculate_net_requirements This tool finds the exact amount of ingredients you need to buy by subtracting your current pantry stock from your total recipe needs. ### get_meal_details Use this to pull the full list of ingredients required for a specific meal. ### optimize_grocery_list This tool turns raw ingredient counts into a practical shopping list that respects package sizes and your set budget. ### suggest_substitutions This tool provides alternative ingredients if your primary choice is too expensive or out of stock. ## Prompt Examples **Prompt:** ``` I want to plan meals for 4 people. I have 200g of flour in my pantry. What do I need to buy for a pasta meal? ``` **Response:** ``` To serve 4 people, you need 500g of flour. After accounting for your 200g pantry stock, you need to buy one 500g bag of flour. ``` **Prompt:** ``` My budget is $20. Can you optimize my grocery list for these meals? ``` **Response:** ``` Your optimized list totals $18.50, leaving $1.50 remaining in your budget. ``` **Prompt:** ``` What are some alternatives for salmon if it is too expensive? ``` **Response:** ``` Good alternatives for salmon include trout or arctic char, which may be more budget-friendly. ``` ## Capabilities ### Pantry Reconciliation Your agent subtracts what you already own from your recipe requirements. ### Budget Management The MCP keeps your shopping list within a specific dollar amount. ### Package Size Logic It converts raw weights into actual items you can find on a store shelf. ### Cost-Saving Substitutions Your agent finds cheaper ingredient options when prices spike. ### Meal Breakdown It extracts specific ingredient lists from any meal you plan. ## Use Cases ### Weekly Meal Planning Input your weekly menu and let the MCP generate a single, optimized list for the store. ### Budget Tightening Use the substitution tool to swap expensive proteins for cheaper alternatives when funds are low. ### Inventory Management Check what you need to buy by comparing your planned meals against your current pantry levels. ### Smart Shopping Get a list that reflects real-world items like bags, cartons, and jars rather than just raw grams. ## Benefits - Reduces food waste by only buying what you don't already have. - Prevents overspending by enforcing budget constraints during list generation. - Simplifies shopping by rounding ingredients to standard package sizes. - Saves time by automating the math between recipes and inventory. ## How It Works Connect the MCP to your preferred AI client and start planning. 1. Connect the MCP to Claude, Cursor, or Windsurf via Vinkius. 2. Tell your AI client what meals you want to cook. 3. Provide your current pantry stock levels to the agent. 4. The MCP calculates the net ingredients and optimizes the list for your budget. 5. Receive a ready-to-use shopping list. ## Frequently Asked Questions **How does this MCP help me save money?** It optimizes your list based on a specific budget and suggests cheaper ingredient substitutions if your primary choices are too expensive. **Which AI tools can I use with this MCP?** You can use this with any MCP-compatible client including Claude, Cursor, Windsurf, and VS Code. **Does it account for what I already have in my kitchen?** Yes, it uses the calculate_net_requirements tool to subtract your existing pantry stock from the total ingredients needed. **Will the shopping list be realistic?** Yes, the optimize_grocery_list tool converts raw ingredient amounts into realistic items based on standard package sizes. **Can I use this to find cheaper ingredients?** Yes, the suggest_substitutions tool provides culinary alternatives when certain items are too pricey or unavailable. **How does the tool handle my existing food?** The `calculate_net_requirements` tool subtracts your current pantry stock from the total ingredients needed for your meals, ensuring you only buy what you actually lack. **What happens if my grocery list exceeds my budget?** The `optimize_grocery_list` tool attempts to stay within your budget. If it cannot, it identifies shortages and you can use `suggest_substitutions` to find cheaper alternatives. **Does it suggest specific package sizes?** Yes, the `optimize_grocery_list` tool uses a package catalog to suggest buying full packages (like a 500g bag) rather than just raw weights.