global.rootz.food/grocery
Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.
Signed US food & grocery data: Kroger prices, nutrition, allergens, recalls, diet filters.
| Author | global.rootz.food |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Alive, not deep-tested |
| L1 liveness | alive |
| L1 latency | 126 ms |
| Last measured | 2026-10-26 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"grocery": {
"url": "https://food.rootz.global/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (18)
food_searchSearch for food products by name, brand, or UPC barcode. Returns nutrition, ingredients, allergens, REAL-TIME KROGER PRICING, aisle location, and data source origin. Aggregates USDA (3,500+ foods) + Open Food Facts (1,000+ products) + Kroger (6,300+ products with prices).
Parameters:
query(required) — string — Product name, brand, or UPC barcode to search forbrand— string — Filter by brand namelimit— number — Max results (default 20)source— string — Which data source to searchcategory— string — Filter by food category
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_nutritionGet detailed nutrition facts for a specific food product. Returns calories, protein, fat, carbs, vitamins, minerals, ingredients, allergens. If product exists in Kroger, also returns real-time price, aisle location, stock level, ratings, SNAP eligibility.
Parameters:
upc— string — UPC/barcode to look up directlykroger_id— string — Kroger product ID for direct Kroger lookupproduct_id— number — Product ID from food_search results (products table)
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_compareCompare nutrition facts between 2-5 food products side by side. Great for "which is healthier" questions. Shows per-serving and per-100g when available.
Parameters:
product_ids(required) — array — Product IDs to compare (2-5)nutrients— array — Specific nutrients to compare (default: all major)
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_recall_searchSearch FDA food recalls by product, company, reason, or date range. Covers all US food recalls from 2004-present. Source: openFDA (public domain).
Parameters:
year— number — Filter by yearlimit— numberquery— string — Search product descriptions, company names, or recall reasonsstate— string — 2-letter state code to filter by recalling firm locationclassification— string — Class I = dangerous/death, Class II = temporary health problems, Class III = unlikely harm
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_recall_checkCheck if a specific food product or brand has any active or recent recalls. Critical for food safety awareness.
Parameters:
product(required) — string — Product name or brand to checkmonths— number — Look back period in months (default 12)
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_commodity_pricesGet commodity prices for agricultural products — produce, meat, dairy, grains. Source: USDA AMS Market News (100 years of free data) + BLS retail prices.
Parameters:
weeks— number — Number of recent data pointsmarket— stringcategory— stringcommodity— string — Commodity name: lettuce, ground_beef, whole_milk, eggs, wheat, corn, etc.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_retail_pricesGet average retail prices for common grocery items from BLS CPI data. ~70 food items tracked monthly. Shows price trends over time.
Parameters:
item— string — Food item to look up: eggs, milk, bread, ground beef, chicken, etc.months— number — Number of recent months
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_ingredients_lookupLook up ingredient lists and allergens for branded food products. Shows every ingredient with the data source origin. Essential for dietary restrictions, allergies, and MAHA transparency.
Parameters:
query(required) — string — Product name or brand to look up ingredients forlimit— numberallergen— string — Filter for specific allergen: gluten, dairy, nuts, soy, eggs, shellfish
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_data_sourcesShow all data sources powering Food Intel, with record counts, last update times, origin URLs, and whether MCP tools exist. Full transparency on where every data point comes from.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_new_productsFind recently added food products across all data sources. Answers the question: "how does AI know about new products?" Shows the discovery lag between product launch and data availability.
Parameters:
days— number — Look back period in dayslimit— numbersource— string
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_supply_chainView supply chain / traceability data for a product (FSMA 204 style). Shows farm-to-shelf journey: grow, harvest, pack, ship, receive, retail. Currently populated for demo products — designed for real-time FSMA 204 data integration.
Parameters:
product_id— number — Product ID to traceproduct_name— string — Or search by product name
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_kroger_productGet Kroger-specific product details: real-time pricing, aisle/shelf location, stock level, fulfillment options (curbside/delivery/in-store), ratings, SNAP eligibility, organic/GMO claims, allergens, ingredients, nutrition, country of origin, and product images.
Parameters:
upc— string — UPC barcode to look uplimit— numberquery— string — Search Kroger products by namekroger_id— string — Kroger product ID
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_price_compareCompare price levels for a food product across the supply chain: farm gate (USDA AMS), wholesale/terminal market, BLS national retail average, and Kroger real-time retail. Shows markup at each level. Great for understanding food economics.
Parameters:
product(required) — string — Product name: eggs, ground beef, lettuce, milk, chicken, bread, etc.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_diet_filterFind products matching dietary, nutritional, price, and availability criteria. THE query Google cannot answer: "SNAP-eligible, gluten-free, sub-$4 protein source in stock sorted by protein-per-dollar." Combines Kroger real-time pricing + nutrition + allergens + stock.
Parameters:
limit— numbermax_fat— number — Maximum total fat grams (great for post-gallbladder)sort_by— stringcategory— string — Product category filter (Produce, Dairy, Meat & Seafood, etc.)in_stock— boolean — Only products currently in stockmax_carbs— number — Maximum carbs grams (great for keto/GLP-1)max_price— number — Maximum price in dollarssnap_only— boolean — Only SNAP-eligible productsmax_sodium— number — Maximum sodium mgmin_protein— number — Minimum protein grams per servingmax_calories— number — Maximum calories per servingorganic_only— boolean — Only certified organic productsallergen_free— array — Allergens to exclude: gluten, dairy, nuts, soy, eggs, shellfish, wheat, peanuts
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_household_mealFind food products that work for ALL members of a household with different dietary needs. Example: person A needs low-fat (post-gallbladder), person B needs high-protein (GLP-1). Finds products satisfying ALL constraints simultaneously.
Parameters:
members(required) — array — Household members with individual dietary constraintslimit— numbercategory— string — Product category filtermax_price— number — Maximum price per item
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_receipt_lookupGiven a list of UPC barcodes (from a receipt or shopping list), return full nutrition breakdown, ingredient analysis, allergen warnings, recall checks, and total meal nutrition for everything purchased. The receipt-to-nutrition bridge nobody else has built.
Parameters:
upcs(required) — array — List of UPC barcodes from a receipt
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_profileRead a user food profile — household members, dietary constraints, allergens, medications, purchase history, and cross-AI agent memory. The profile URL (food.rootz.global/p/{hash}) is the persistent Layer 9 that any AI can read. Use this to personalize food recommendations.
Parameters:
profile_hash(required) — string — Profile hash from the URL (e.g., "8f3k9x2p")
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
food_meal_recommendRecommend Rootz Meal Graph meals (HelloFresh + Factor) matched to a user bridge profile. Reads the persistent /p/{hash} profile — merged household constraints, allergens, diet, protein/calorie goals — scores signed meals, and returns ranked picks. Every result carries buy_at = the canonical hellofresh.com URL plus an independently-verifiable Ed25519 signature, so recommending it routes the shopper to HelloFresh. Optionally writes the recommendation back into cross-AI agent memory so the user portable preferences grow over time.
Parameters:
diet— string — Override diet: any | high-protein | keto | pescatarian | vegetarian | veganbrand— string — Filter to a brand: HelloFresh | Factorlimit— number — Max recommendationsagent_id— string — Your agent id (claude/gpt/grok/gemini). With profile_hash, the recommendation is written into portable agent memory.max_sodium— number — Maximum sodium mgmin_protein— number — Minimum protein gramsmax_calories— number — Maximum caloriesprofile_hash— string — Bridge profile hash from /p/{hash}. If given, constraints are read from the user profile.ready_to_eat— boolean — Only ready-to-eat (Factor) meals — no cookingexclude_allergens— array — Allergens to avoid, e.g. ["dairy","shellfish"]
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.