# GroceryStock

> Plan weekly grocery restocks

GroceryStock turns your staples into a restock plan: forecast when each item runs out, build a shopping list covering N weeks, quote the basket with typical US prices, compare budget/standard/premium store tiers, swap pricy lines to fit a budget, and compute your Sunday restock dates. Planning only - it never orders anything.

## Use from an AI assistant

- MCP endpoint (Streamable HTTP, JSON profile): POST https://grocery-stock.magicteams.ai/mcp
- Directories: ChatGPT Apps, Claude Connectors, Meta Muse (search "GroceryStock")
- Machine manifest: https://grocery-stock.magicteams.ai/.well-known/agent.json
- UCP discovery profile: https://grocery-stock.magicteams.ai/.well-known/ucp

## Tools

- forecast_runout: Forecast runout — Forecast when each staple runs out from on-hand amounts and weekly use: weeks left, runout date and ok/low/out status.
- build_restock_list: Build restock list — Build a restock shopping list covering N weeks ahead from on-hand amounts and weekly use.
- quote_basket: Quote basket — Price a basket of staples with typical US prices: per-item lines and a total. Prices are typical, not store quotes.
- compare_store_tiers: Compare store tiers — Compare what the same basket costs at budget, standard and premium store tiers, and name the cheapest.
- suggest_swaps: Suggest swaps — Fit a basket into a budget by swapping the priciest lines for cheaper staples, biggest savings first.
- restock_schedule: Restock schedule — Compute the next N weekly restock dates for a weekday on or after a start date.

All tools are free, compute per request, and store nothing.

## Operator

MagicTeams — support@magicteams.ai — https://grocery-stock.magicteams.ai/support