# Zero-Waste Shopping Assistant AI Agent Connect

> Zero-Waste Shopping Assistant MCP handles the math for your sustainable lifestyle. It calculates exactly how much bulk product you need based on your current pantry stock, your container sizes, and your typical usage rates. Instead of guessing at the bulk aisle, your AI client provides precise measurements to ensure you buy exactly what fits in your jars.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_wWQL2L8E907eXjDwUUfhHkmLcN39850G5n8VMtXb/ai-agent-connect
- **Tags:** zero-waste, bulk-shopping, refill, inventory, sustainability

## Description

Transitioning to a zero-waste lifestyle usually involves a lot of guesswork. You find yourself standing in a bulk aisle wondering if that bag of lentils will actually fit in your favorite mason jar, or if you're buying too much or too little. This MCP removes that friction by turning your AI client into a precise inventory and shopping planner. 

You can give your agent your current pantry levels and your daily consumption rates to figure out exactly when you'll run out of essentials. It also accounts for product density, so you aren't just guessing by volume. If you have a specific set of reusable containers, the MCP checks if the weight of the product you intend to buy actually fits within the volume of those containers. It's about moving away from plastic packaging and toward a predictable, measured way of restocking your home without the waste.

## Tools

### generate_optimized_shopping_list
This tool builds a complete, organized plan for your next trip to the bulk store.

### get_product_refill_info
Use this to check if a specific item is available for refill and find its density.

### calculate_needed_quantity
This tool determines exactly how much to buy by looking at your current stock and how fast you use it.

### validate_container_fit
This tool confirms whether a specific weight of a product will actually fit inside your reusable jars.

## Prompt Examples

**Prompt:** 
```
I have 200g of lentils, I use 50g a day, and I'll shop in 4 days. How much should I buy for my 500ml jar?
```

**Response:** 
```
You need to buy 0g of lentils because your current stock of 200g is sufficient to cover the 200g needed for the next 4 days.
```

**Prompt:** 
```
Check if oats are available for refill and tell me their density.
```

**Response:** 
```
Yes, oats are available for refill. Their density is 0.45 g/ml.
```

**Prompt:** 
```
Will 500g of rice fit in a 600ml container?
```

**Response:** 
```
Yes, 500g of rice will fit in your 600ml container.
```

## Capabilities

### Inventory Math
Your agent calculates remaining stock based on daily usage rates.

### Volume Verification
The AI checks if product weight matches your container volume using density data.

### Refill Availability
Your client can verify if specific items are eligible for bulk refill.

### List Generation
The MCP creates a single, optimized list for your shopping trips.

## Use Cases

### Pre-trip Planning
Calculate your total needs before leaving the house to ensure you don't forget essentials.

### Container Matching
Verify that a specific amount of grain or powder will fit in your existing glass jars.

### Pantry Depletion Tracking
Determine exactly when you will run out of a staple item based on your daily consumption.

### Bulk Store Navigation
Use density information to translate weight requirements into volume measurements.

## Benefits

- Eliminates guesswork regarding container volume and product weight.
- Prevents overbuying by calculating usage against current stock.
- Reduces food waste by matching purchase amounts to actual needs.
- Saves time at the store with pre-calculated shopping lists.

## How It Works

Connect your AI client to Vinkius and start managing your refills.

1. Connect your preferred MCP-compatible client to the Vinkius platform.
2. Provide your current pantry inventory and container sizes to your agent.
3. Ask the agent to calculate quantities or check container fits.
4. Receive a precise shopping list or quantity recommendation.

## Frequently Asked Questions

**How does the MCP know if my food will fit in my jars?**
The MCP uses density information to compare the weight of the product you want to buy against the volume of your container.

**Can I use this with Claude or Cursor?**
Yes, you can connect this MCP to any MCP-compatible client like Claude, Cursor, or Windsurf.

**Does this help me avoid buying too much food?**
Yes, it calculates how much you actually need based on your current stock and how much you use every day.

**What do I need to provide to get an accurate shopping list?**
You should provide your current inventory levels, your daily usage rates, and the volume of your reusable containers.

**Is there a way to check if a product is available for bulk refill?**
Yes, you can use the tool to check product availability and density information.

**How does the tool know if an item is refillable?**
The `get_product_refill_info` tool checks the internal bulk availability catalog to verify if a product can be purchased in a refillable format.

**Can I check if my jar is big enough?**
Yes, use the `validate_container_fit` tool by providing the container volume and the target weight of the product.

**How do I generate a full list for my trip?**
You can use `generate_optimized_shopping_list` with a list of your desired items to get a complete plan including weights and fit status.
