# Household Wellness & Shopping List AI Agent Connect

> Household Wellness & Shopping List MCP connects your AI agent to your home inventory. It tracks how fast you use supplies during daily routines, predicts when you'll run out of essentials, and builds optimized shopping lists so you never realize you're out of something only when you actually need it.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_SE47MABBliBmu8L1yfq1qpW4ILG3RRbx1qMdWion/ai-agent-connect
- **Tags:** inventory, shopping, routines, household-management, automation

## Description

You can stop guessing if you have enough detergent or vitamins left. This MCP links your AI client directly to your household inventory system, turning your agent into a proactive home manager. It monitors how your supplies dwindle during recurring activities like cleaning or wellness routines. Instead of you checking the cabinet, your agent uses the data to see exactly what's happening. You can ask for a status update on a specific item or see a full list of your active household routines. When things get low, the agent calculates exactly when you'll hit zero and puts those items on a shopping list for you. It's about moving from reactive shopping to a system that stays ahead of your needs.

## Tools

### generate_shopping_list
This tool pulls together every item that needs to be replaced. It creates a single list of all supplies that have fallen below your required levels.

### get_supply_status
Use this to get a real-time update on a specific item. It provides a detailed look at how much of a particular supply you have left.

### list_routines
This tool shows you all the household routines currently being tracked. It lets your agent see the activities that drive your supply consumption.

### calculate_depletion_forecast
This tool predicts your future needs. It looks at your current usage rates to tell you exactly when a specific supply will run out.

## Prompt Examples

**Prompt:** 
```
What do I need to buy for my household right now?
```

**Response:** 
```
You need to purchase: 2 units of Liquid Soap (Critical) and 1 pack of Vitamin Pills (Standard). Total estimated cost is $15.50.
```

**Prompt:** 
```
How much laundry detergent do I have left?
```

**Response:** 
```
You currently have 500ml of laundry detergent in stock. This is enough for your next 2 cleaning routines.
```

**Prompt:** 
```
When will I run out of my skincare products?
```

**Response:** 
```
Based on your current usage, your facial cleanser is estimated to run out in 5 days.
```

## Capabilities

### Inventory Tracking
Your agent monitors supply levels through your household routines.

### Usage Forecasting
The agent calculates exactly when items will run out based on how you use them.

### Automated List Building
Your agent aggregates all low items into a single shopping list.

### Routine Monitoring
The agent tracks consumption patterns tied to specific household activities.

## Use Cases

### Preventing Skincare Shortages
Your agent predicts when your facial cleanser will run out so you can order it before it's gone.

### Cleaning Supply Management
The agent tracks detergent usage during laundry routines to keep your stock steady.

### Wellness Routine Automation
Monitor vitamin and supplement levels to ensure your daily wellness habits aren't interrupted.

### Weekly Grocery Planning
Generate a complete list of everything needed for the house in one go.

## Benefits

- Eliminates manual inventory checks by tracking usage through routines.
- Prevents emergency store runs with depletion forecasting.
- Reduces mental load by automating the creation of shopping lists.
- Provides real-time visibility into specific supply levels via your AI client.

## How It Works

Setting this up takes a few clicks to connect your agent to your home data.

1. Connect your preferred MCP-compatible client to Vinkius.
2. The agent accesses your household inventory and routine data.
3. Your agent monitors how supplies are used during your daily activities.
4. Ask your agent for a status update or a shopping list whenever you need it.

## Frequently Asked Questions

**How does the MCP know when I am running low on items?**
It tracks your consumption during defined household routines and uses that data to forecast when supplies will hit zero.

**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 replace my existing shopping list app?**
It acts as an intelligent layer that builds your list for you based on actual usage rather than manual entry.

**How accurate are the depletion forecasts?**
The accuracy depends on how consistently you follow your defined household routines, as the agent uses that usage data to calculate the forecast.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately after connection.

**How does the shopping list get updated?**
The list is updated by analyzing the current stock against the usage rates defined in your routines. When stock falls below the threshold needed for the next routine, it is added to the list.

**Can I see when my soap will run out?**
Yes, you can use `calculate_depletion_forecast` to predict exactly how many days of stock remain for any specific supply.

**What routines are tracked?**
The system tracks all routines defined in your catalog, such as wellness activities or maintenance tasks, which drive the consumption of your supplies.
