# Grocery Shopping - Kroger ## Links - Product page URL: https://www.agentpmt.com/marketplace/grocery-shopping-kroger - Product markdown URL: https://www.agentpmt.com/marketplace/grocery-shopping-kroger?format=agent-md - Product JSON URL: https://www.agentpmt.com/marketplace/grocery-shopping-kroger?format=agent-json ## Overview - Product ID: 699544248a76bb5318ba60b7 - Vendor: Apoth3osis - Type: physical - Unit type: request - Price: 500 credits - Categories: Automation, Geocoding & Location Services, Places & Business Search, E-commerce & Product Catalog, Shipping & Delivery, Reservations & Ordering, Recipe & Nutrition - Generated at: 2026-04-15T18:35:34.417Z ### Page Description Search products, find stores, and add items to your cart across 2700+ Kroger family stores including Kroger, Ralphs, Fred Meyer, King Soopers, and more. Features batch search (pass an array of items to search all at once), allergen filtering (gluten, dairy, egg, peanut, tree nut, soy, fish, shellfish, sesame, corn, mustard, celery, lupine, sulfite), nutrition filters (max calories, fat, sugar, sodium, cholesterol, carbs; min protein, fiber), SNAP/EBT eligibility filter, and full product details including nutrition panels, allergen data, and ratings. ### Agent Description Search grocery products with advanced dietary filtering across 2700+ Kroger family stores. Filter by 17 allergen types (gluten, wheat, dairy, milk, lactose, egg, peanut, tree_nut, soy, fish, shellfish, sesame, corn, mustard, celery, lupine, sulfite), set per-serving nutrition limits (max_calories, max_total_fat_g, max_sugar_g, max_sodium_mg, max_cholesterol_mg, max_carbohydrate_g, min_protein_g, min_fiber_g), and filter for SNAP/EBT eligible products. Returns full nutrition panels, ingredients, allergen data, ratings, pricing, and availability. Also supports store lookup by zip code, product detail retrieval, and cart management for pickup/delivery orders. ## Details Tab ### Details Search products, find stores, and add items to your cart across 2700+ Kroger family stores including Kroger, Ralphs, Fred Meyer, King Soopers, and more. Features batch search (pass an array of items to search all at once), allergen filtering (gluten, dairy, egg, peanut, tree nut, soy, fish, shellfish, sesame, corn, mustard, celery, lupine, sulfite), nutrition filters (max calories, fat, sugar, sodium, cholesterol, carbs; min protein, fiber), SNAP/EBT eligibility filter, and full product details including nutrition panels, allergen data, and ratings. ### Actions - `search_products` (5 credits): Search the Kroger product catalog. You MUST call find_stores first to get a location_id. Supports batch search with pipe-separated queries, allergen filtering, nutrition filters, and SNAP eligibility. - `get_product_details` (5 credits): Get detailed product information including full nutrition, allergens, ratings, images, and aisle locations. - `find_stores` (5 credits): Find nearby Kroger-family stores. User location (zip code) is injected automatically. - `add_to_cart` (5 credits): Add items to the user's Kroger online cart. Requires user Kroger account connection. ### Use Cases Search grocery products by name or brand, Filter products by allergens like gluten dairy egg peanut soy, Find low-calorie or low-sugar groceries with nutrition filters, Search for high-protein or high-fiber foods, Find SNAP/EBT eligible grocery items, Get full nutrition facts and ingredients for any product, Find nearby Kroger family stores by zip code, Check product pricing and availability at specific stores, Add items to Kroger cart for pickup or delivery, Compare prices across store locations, Plan meals with dietary restriction support, Build grocery lists for specialized diets ### Workflows Using This Tool #### Gluten-Free Dinner Recipes to Kroger Cart Generates 5 gluten-free dinner recipes, saves all recipes with full instructions to a Google Doc, extracts and deduplicates the combined ingredient list, then searches Kroger for all ingredients in a single batch using the gluten-free allergen filter and adds everything to your cart. Notifies you when complete with a link to the Google Doc and confirmation that your cart is ready. - Page URL: https://www.agentpmt.com/agent-workflow-skills/gluten-free-dinner-recipes-to-kroger-cart - Markdown URL: https://www.agentpmt.com/agent-workflow-skills/gluten-free-dinner-recipes-to-kroger-cart?format=agent-md - Published: 2026-03-04T00:10:45.589Z #### Kroger Grocery Order From Google Sheet Reads your grocery list from a Google Sheet, searches Kroger for each item to find the best-priced match, adds them to your Kroger cart, then sends you a notification that your order is ready for checkout. - Page URL: https://www.agentpmt.com/agent-workflow-skills/kroger-grocery-order-from-google-sheet - Markdown URL: https://www.agentpmt.com/agent-workflow-skills/kroger-grocery-order-from-google-sheet?format=agent-md - Published: 2026-02-23T02:41:28.633Z #### Kroger Grocery Order From List Photo Upload a photo of your handwritten or printed grocery list, and the agent will extract the items using OCR, search Kroger for each item to find the best-priced match, add them to your Kroger cart, then send you a notification that your order is ready for checkout. - Page URL: https://www.agentpmt.com/agent-workflow-skills/kroger-grocery-order-from-list-photo - Markdown URL: https://www.agentpmt.com/agent-workflow-skills/kroger-grocery-order-from-list-photo?format=agent-md - Published: 2026-02-23T02:38:10.625Z #### Kroger Grocery Auto-Order from Google Doc Reads your Google Doc named grocery list, searches Kroger for each item to find the best-priced match, adds them to your Kroger cart, checks off completed items in the Google Doc, then sends you a notification that your order is ready. - Page URL: https://www.agentpmt.com/agent-workflow-skills/kroger-grocery-auto-order-from-google-doc - Markdown URL: https://www.agentpmt.com/agent-workflow-skills/kroger-grocery-auto-order-from-google-doc?format=agent-md - Published: 2026-02-23T02:15:24.258Z ### Related Content #### Claude Transcript - Allergen Friendly Grocery Shopping With AI - Type: video - Page URL: https://www.agentpmt.com/videos/claude-transcript-allergen-friendly-grocery-shopping-with-ai - Markdown URL: Not available for this content type Full Claude Code transcript showing an AI agent executing the Gluten-Free Dinner Recipes to Kroger Cart workflow -- generating recipes, saving to Google Docs, searching Kroger, and adding 41 items to the cart. #### AI Grocery Shopping is HERE -- Gluten-Free Recipes to Kroger Cart in Minutes - Type: video - Page URL: https://www.agentpmt.com/videos/ai-grocery-shopping-is-here-gluten-free-recipes-to-kroger-cart-in-minutes - Markdown URL: Not available for this content type Watch an AI agent generate 5 gluten-free dinner recipes, save them to Google Docs, search Kroger for all ingredients, and add 41 items to a Kroger cart -- all autonomously using AgentPMT workflow skills. ## Advanced Tab ### DynamicMCP - Setup page URL: https://www.agentpmt.com/dynamic-mcp - Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos - ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos - Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos - Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to `https://api.agentpmt.com/mcp`. All tool execution happens in the cloud and the server cannot edit any files on your computer. ```bash npm install -g @agentpmt/mcp-router agentpmt-setup ``` ### REST API The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials. - Purchase endpoint: https://api.agentpmt.com/products/purchase - Authorization format: `Bearer ` ```bash curl -X POST "https://api.agentpmt.com/products/purchase" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \ -d '{ "product_id": "699544248a76bb5318ba60b7", "parameters": { "action": "search_products", "query": "example_query", "location_id": "example_location_id" } }' ``` ### Autonomous Agents Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead. - External Agent API page URL: https://www.agentpmt.com/external-agent-api - External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md ### Schema #### Credentials These runtime credentials should be provided under `parameters._credentials` when required. - Kroger Account (`kroger_oauth`, oauth_token, required) Connection ID: 699544408a76bb5318ba60bd - User ZIP Code (`user_zip_code`, custom, required) Help: Enter your 5-digit ZIP code for store lookup. Connection ID: 699544408a76bb5318ba60bd #### Parameters - Schema type: actions ```json { "actions": { "search_products": { "description": "Search the Kroger product catalog. You MUST call find_stores first to get a location_id. Supports batch search with pipe-separated queries, allergen filtering, nutrition filters, and SNAP eligibility.", "properties": { "query": { "type": "string", "description": "Product search term. For a single item: \"chicken thighs\". For multiple items, separate with | (pipe): \"chicken thighs | olive oil | garlic\". Max 25 items per batch.", "required": true }, "location_id": { "type": "string", "description": "Store location ID from find_stores. REQUIRED for pricing and availability.", "required": true }, "brand": { "type": "string", "description": "Filter by brand name", "required": false }, "limit": { "type": "integer", "description": "Results per page (default 10, max 50)", "required": false, "minimum": 1, "maximum": 50 }, "start": { "type": "integer", "description": "Pagination offset", "required": false, "minimum": 1 }, "allergen_free": { "type": "array", "description": "Filter to products free from these allergens", "required": false, "items": { "type": "string", "enum": [ "gluten", "wheat", "dairy", "milk", "lactose", "egg", "peanut", "tree_nut", "soy", "fish", "shellfish", "sesame", "corn", "mustard", "celery", "lupine", "sulfite" ] } }, "max_calories": { "type": "number", "description": "Max calories per serving", "required": false, "minimum": 0 }, "max_total_fat_g": { "type": "number", "description": "Max total fat grams per serving", "required": false, "minimum": 0 }, "max_sugar_g": { "type": "number", "description": "Max sugar grams per serving", "required": false, "minimum": 0 }, "max_sodium_mg": { "type": "number", "description": "Max sodium mg per serving", "required": false, "minimum": 0 }, "max_cholesterol_mg": { "type": "number", "description": "Max cholesterol mg per serving", "required": false, "minimum": 0 }, "max_carbohydrate_g": { "type": "number", "description": "Max total carbohydrate grams per serving", "required": false, "minimum": 0 }, "min_protein_g": { "type": "number", "description": "Min protein grams per serving", "required": false, "minimum": 0 }, "min_fiber_g": { "type": "number", "description": "Min dietary fiber grams per serving", "required": false, "minimum": 0 }, "snap_eligible_only": { "type": "boolean", "description": "Only return SNAP/EBT eligible products", "required": false } } }, "get_product_details": { "description": "Get detailed product information including full nutrition, allergens, ratings, images, and aisle locations.", "properties": { "product_id": { "type": "string", "description": "Kroger product ID", "required": true }, "location_id": { "type": "string", "description": "Store location ID for local pricing and aisle info", "required": false } } }, "find_stores": { "description": "Find nearby Kroger-family stores. User location (zip code) is injected automatically.", "properties": { "radius_miles": { "type": "integer", "description": "Search radius in miles (default 10)", "required": false, "minimum": 1, "maximum": 100 }, "limit": { "type": "integer", "description": "Maximum number of stores to return (default 10, max 50)", "required": false, "minimum": 1, "maximum": 50 }, "chain": { "type": "string", "description": "Filter by chain name (Kroger, Ralphs, Fred Meyer, King Soopers, Harris Teeter, etc.)", "required": false } } }, "add_to_cart": { "description": "Add items to the user's Kroger online cart. Requires user Kroger account connection.", "properties": { "items": { "type": "array", "description": "Items to add to cart", "required": true, "items": { "type": "object", "properties": { "upc": { "type": "string", "description": "Product UPC code from search or product detail results", "required": true }, "quantity": { "type": "integer", "description": "Quantity to add", "minimum": 1, "required": true }, "modality": { "type": "string", "description": "Fulfillment method (defaults to user's Kroger account preference)", "enum": [ "PICKUP", "DELIVERY" ], "required": false } } } } } } } } ``` ### Usage Instructions # Kroger Grocery Search products, find stores, and add items to your cart across 2700+ Kroger-family stores including Kroger, Ralphs, Fred Meyer, King Soopers, Harris Teeter, and more. ## Overview This tool connects to the Kroger API to search their product catalog, find nearby stores, get detailed product information with nutrition and allergen data, and add items to a user's Kroger cart. It supports batch product searches (up to 25 items at once), dietary and allergen filtering, nutrition threshold filtering, and SNAP/EBT eligibility filtering. Products are filtered to only show items available both in-store and for delivery. ## Actions ### find_stores Find nearby Kroger-family stores. The user's location (zip code) is injected automatically by the platform. **Required parameters:** None (zip code is injected automatically) **Optional parameters:** - `radius_miles` (integer, 1-100, default 10) -- search radius in miles - `limit` (integer, 1-50, default 10) -- maximum number of stores to return - `chain` (string) -- filter by chain name (e.g. `Kroger`, `Ralphs`, `Fred Meyer`, `King Soopers`, `Harris Teeter`) **Example -- find nearest stores:** ```json {"action":"find_stores"} ``` **Example -- find Ralphs stores within 25 miles:** ```json {"action":"find_stores","chain":"Ralphs","radius_miles":25} ``` Returns: `stores[]` (with `location_id`, `chain`, `name`, `phone`, `address` {`line1`, `city`, `state`, `zip_code`}, `latitude`, `longitude`, `open_24h`, `timezone`, `departments[]`), `total` --- ### search_products Search the Kroger product catalog. You MUST call `find_stores` first to get a `location_id`, then pass it to every search. Without a `location_id`, products will have no pricing or availability and results will be empty. **Required parameters:** - `query` (string) -- search term. For a single item: `"chicken thighs"`. To search multiple items at once, separate with `|` (pipe): `"chicken thighs | olive oil | garlic | spinach"`. Max 25 items per batch. - `location_id` (string) -- store location ID from `find_stores` **Optional parameters:** - `brand` (string) -- filter by brand name - `limit` (integer, 1-50, default 10) -- results per query - `start` (integer) -- pagination offset - `allergen_free` (array of strings) -- filter to products free from specified allergens. Values: `gluten`, `wheat`, `dairy`, `milk`, `lactose`, `egg`, `peanut`, `tree_nut`, `soy`, `fish`, `shellfish`, `sesame`, `corn`, `mustard`, `celery`, `lupine`, `sulfite` - `max_calories` (number) -- max calories per serving - `max_total_fat_g` (number) -- max total fat grams per serving - `max_sugar_g` (number) -- max sugar grams per serving - `max_sodium_mg` (number) -- max sodium mg per serving - `max_cholesterol_mg` (number) -- max cholesterol mg per serving - `max_carbohydrate_g` (number) -- max total carbohydrate grams per serving - `min_protein_g` (number) -- min protein grams per serving - `min_fiber_g` (number) -- min dietary fiber grams per serving - `snap_eligible_only` (boolean) -- only return SNAP/EBT eligible products **Example -- basic search:** ```json {"action":"search_products","query":"organic milk","location_id":"01400441"} ``` **Example -- batch search for multiple items:** ```json {"action":"search_products","query":"chicken thighs | olive oil | garlic | spinach","location_id":"01400441"} ``` **Example -- filtered search (gluten-free, low calorie):** ```json {"action":"search_products","query":"crackers","location_id":"01400441","allergen_free":["gluten"],"max_calories":150} ``` **Example -- high protein, low sugar:** ```json {"action":"search_products","query":"protein bars","location_id":"01400441","min_protein_g":15,"max_sugar_g":5} ``` **Example -- SNAP eligible only:** ```json {"action":"search_products","query":"fresh bananas","location_id":"01400441","snap_eligible_only":true,"limit":5} ``` **Search tips for fresh produce:** Use specific terms like `"fresh zucchini"`, `"fresh limes"`, `"fresh avocado"` rather than generic single words. Generic terms like `"lime"` may return unrelated products (e.g. "Lemon Lime" soda). Single-query response: `query`, `products[]`, `total`, `limit`, optional `filter_summary` Batch response: `batch` (true), `queries_submitted`, `results[]` (each with `query`, `products[]`, `total`), `limit_per_query` Each product includes: `product_id`, `upc`, `brand`, `description`, `categories[]`, `country_origin`, `snap_eligible`, `organic`, `non_gmo`, `image_url`, `price_regular`, `price_promo`, `size`, `fulfillment` {`delivery`, `pickup`, `in_store`, `ship`}, and optionally `nutrition_summary` {`serving_size`, `calories`, `protein_g`, `total_carbohydrate_g`, `total_fat_g`, `sugar_g`, `dietary_fiber_g`} When filters are active, a `filter_summary` is included with `products_scanned`, `products_excluded`, and `products_returned` counts. --- ### get_product_details Get detailed information for a specific product including full nutrition, allergens, ratings, images, and aisle locations. **Required parameters:** - `product_id` (string) -- Kroger product ID **Optional parameters:** - `location_id` (string) -- include for local pricing, availability, and aisle information **Example:** ```json {"action":"get_product_details","product_id":"0011110838001","location_id":"01400441"} ``` Returns: `product` with `product_id`, `upc`, `brand`, `description`, `categories[]`, `country_origin`, `snap_eligible`, `organic`, `non_gmo`, `temperature`, `allergens[]` (with `name` and `level`), `allergens_description`, `ratings` {`average_rating`, `total_reviews`}, `item_information` {`depth`, `height`, `width`, `gross_weight`, `net_weight`, `average_weight`}, `images[]` (with `perspective`, `size`, `url`), `items[]` (with `item_id`, `size`, `sold_by`, `price_regular`, `price_promo`, `fulfillment`), `aisle_locations[]`, `nutrition` {`ingredient_statement`, `serving_size`, `nutritional_rating`, `nutrients[]` (with `name`, `quantity`, `unit`, `percent_daily_value`)} If the product is not available for both in-store and delivery at the selected location, an `availability_warning` is included. --- ### add_to_cart Add items to the user's Kroger online cart. Requires the user to have a connected Kroger account. **Required parameters:** - `items` (array of objects) -- items to add, each with: - `upc` (string, required) -- product UPC code from search or product detail results - `quantity` (integer, required, minimum 1) -- quantity to add - `modality` (string, optional) -- `PICKUP` or `DELIVERY` (defaults to user's Kroger account preference) **Example:** ```json {"action":"add_to_cart","items":[{"upc":"0011110838001","quantity":2},{"upc":"0001111042010","quantity":1}]} ``` **Example -- specify fulfillment method:** ```json {"action":"add_to_cart","items":[{"upc":"0011110838001","quantity":1,"modality":"PICKUP"}]} ``` Returns: `success` (boolean), `items_added` (count), `items[]` --- ## Workflows ### Grocery Shopping Workflow 1. **Always start with `find_stores`** to get a `location_id` (user location is detected automatically) 2. `search_products` with `query` + `location_id` -- location_id is required for every search 3. Optionally use `get_product_details` for full info on specific products (nutrition, allergens, aisle location) 4. `add_to_cart` with UPCs and quantities (requires user Kroger account connection) ### Dietary-Restricted Shopping 1. `find_stores` to get a `location_id` 2. `search_products` with allergen and/or nutrition filters (e.g. `allergen_free: ["gluten", "dairy"]`, `max_calories: 200`) 3. Review `filter_summary` to see how many products were scanned vs. excluded 4. `get_product_details` to verify allergen labels and full ingredient statements 5. `add_to_cart` with confirmed products ### Meal Prep Batch Search 1. `find_stores` to get a `location_id` 2. `search_products` with pipe-separated ingredients: `"chicken breast | brown rice | broccoli | olive oil | garlic"` 3. Results are grouped by query with concurrent API calls for faster results 4. `add_to_cart` with selected items from each result group ## Notes - Only products available for both in-store shopping and delivery are returned in search results - Allergen filtering uses Kroger's allergen labels with an ingredient-statement fallback for products that lack allergen declarations - Fresh whole foods (produce, raw meat, seafood) without allergen labels are allowed through the filter unless the product itself IS the allergen (e.g. fresh walnuts filtered for tree nuts) - Nutrition filtering excludes products that lack the relevant nutrient data (to be safe) - Batch searches run with limited concurrency (2 concurrent queries) with automatic retry on API errors - The `query` parameter accepts both a plain string and a pipe-delimited multi-query string; both formats are supported - `add_to_cart` requires the user to have connected their Kroger account through the platform ### About The Developer - Vendor name: Apoth3osis - Website: apoth3osis.io We build tools that enable AI agents to excel in the mathematical realm. Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation. ### Frequently Asked Questions No linked FAQs are currently available. ### Dependencies This product has no public dependency products.