List grocery stores near a ZIP code that have an active weekly ad, with how many deals each is running. Start here.

Args: zip_code: 5-digit US ZIP code, e.g. "12345". Optional if the server has a GROCERY_ZIP default configured.

Search this week's ads across every local grocery store for a product.

Args: query: what you're looking for, e.g. "chicken breast", "greek yogurt". zip_code: 5-digit US ZIP code. Optional if GROCERY_ZIP is set. stores: optional store names to restrict to, e.g. ["Aldi", "Costco"]. max_price: only return items at or below this price. limit: max results (default 25).

Show everything in one store's current weekly ad.

Args: store: store name, e.g. "Giant Food", "Aldi", "Costco". zip_code: 5-digit US ZIP code. Optional if GROCERY_ZIP is set. limit: max items to return (default 150).

Turn a shopping list into a trip plan: which store to buy each item at.

Args: items: things you want to buy, e.g. ["chicken thighs", "blueberries"]. zip_code: 5-digit US ZIP code. Optional if GROCERY_ZIP is set. max_stores: how many stores you're willing to visit (default 2).

Judge whether a current price is actually good, using the price history this server accumulates. Gets more useful the longer it has been running.

Args: item: the product to evaluate, e.g. "boneless chicken breast". zip_code: 5-digit US ZIP code. Optional if GROCERY_ZIP is set.

Force a rebuild of the deal index from Flipp. Takes 10-20 seconds. Only needed mid-week; the index otherwise refreshes itself.

Args: zip_code: 5-digit US ZIP code. Optional if GROCERY_ZIP is set.

Exact SKU-level prices (regular and promo) from a Kroger-banner store via Kroger's official API — Kroger, Harris Teeter, Ralphs, Fred Meyer, King Soopers, QFC, Smith's. More precise than the circular. Requires Kroger API credentials; without them the other tools still work.

Args: query: product term, e.g. "greek yogurt". location_id: store ID from kroger_find_stores. Optional if KROGER_LOCATION_ID is set. limit: max products (default 15).

Find nearby Kroger-banner store IDs, needed once to use kroger_search.

Args: zip_code: 5-digit US ZIP code. Optional if GROCERY_ZIP is set. chain: optional banner filter, e.g. "Harris Teeter", "Kroger", "Ralphs". Matched against store name and chain code, so the everyday spelling works.