grocery

Search 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).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Product name, brand, or UPC barcode to search for"
    },
    "brand": {
      "type": "string",
      "description": "Filter by brand name"
    },
    "category": {
      "type": "string",
      "description": "Filter by food category"
    },
    "source": {
      "type": "string",
      "enum": [
        "usda",
        "openfoodfacts",
        "kroger",
        "all"
      ],
      "default": "all",
      "description": "Which data source to search"
    },
    "limit": {
      "type": "number",
      "default": 20,
      "description": "Max results (default 20)"
    }
  },
  "required": [
    "query"
  ]
}

Get 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.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "number",
      "description": "Product ID from food_search results (products table)"
    },
    "upc": {
      "type": "string",
      "description": "UPC/barcode to look up directly"
    },
    "kroger_id": {
      "type": "string",
      "description": "Kroger product ID for direct Kroger lookup"
    }
  }
}

Compare nutrition facts between 2-5 food products side by side. Great for "which is healthier" questions. Shows per-serving and per-100g when available.

{
  "type": "object",
  "properties": {
    "product_ids": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Product IDs to compare (2-5)"
    },
    "nutrients": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specific nutrients to compare (default: all major)"
    }
  },
  "required": [
    "product_ids"
  ]
}

Search FDA food recalls by product, company, reason, or date range. Covers all US food recalls from 2004-present. Source: openFDA (public domain).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search product descriptions, company names, or recall reasons"
    },
    "classification": {
      "type": "string",
      "enum": [
        "Class I",
        "Class II",
        "Class III"
      ],
      "description": "Class I = dangerous/death, Class II = temporary health problems, Class III = unlikely harm"
    },
    "state": {
      "type": "string",
      "description": "2-letter state code to filter by recalling firm location"
    },
    "year": {
      "type": "number",
      "description": "Filter by year"
    },
    "limit": {
      "type": "number",
      "default": 20
    }
  }
}

Check if a specific food product or brand has any active or recent recalls. Critical for food safety awareness.

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "description": "Product name or brand to check"
    },
    "months": {
      "type": "number",
      "default": 12,
      "description": "Look back period in months (default 12)"
    }
  },
  "required": [
    "product"
  ]
}

Get commodity prices for agricultural products — produce, meat, dairy, grains. Source: USDA AMS Market News (100 years of free data) + BLS retail prices.

{
  "type": "object",
  "properties": {
    "commodity": {
      "type": "string",
      "description": "Commodity name: lettuce, ground_beef, whole_milk, eggs, wheat, corn, etc."
    },
    "category": {
      "type": "string",
      "enum": [
        "produce",
        "meat",
        "dairy",
        "grain",
        "all"
      ],
      "default": "all"
    },
    "market": {
      "type": "string",
      "enum": [
        "retail",
        "farm_gate",
        "terminal",
        "national",
        "all"
      ],
      "default": "all"
    },
    "weeks": {
      "type": "number",
      "default": 12,
      "description": "Number of recent data points"
    }
  }
}

Get average retail prices for common grocery items from BLS CPI data. ~70 food items tracked monthly. Shows price trends over time.

{
  "type": "object",
  "properties": {
    "item": {
      "type": "string",
      "description": "Food item to look up: eggs, milk, bread, ground beef, chicken, etc."
    },
    "months": {
      "type": "number",
      "default": 12,
      "description": "Number of recent months"
    }
  }
}

Look 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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Product name or brand to look up ingredients for"
    },
    "allergen": {
      "type": "string",
      "description": "Filter for specific allergen: gluten, dairy, nuts, soy, eggs, shellfish"
    },
    "limit": {
      "type": "number",
      "default": 10
    }
  },
  "required": [
    "query"
  ]
}

Show 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.

{
  "type": "object",
  "properties": {}
}

Find 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.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "default": 30,
      "description": "Look back period in days"
    },
    "source": {
      "type": "string",
      "enum": [
        "usda",
        "openfoodfacts",
        "all"
      ],
      "default": "all"
    },
    "limit": {
      "type": "number",
      "default": 25
    }
  }
}

View 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.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "number",
      "description": "Product ID to trace"
    },
    "product_name": {
      "type": "string",
      "description": "Or search by product name"
    }
  }
}

Get 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.

{
  "type": "object",
  "properties": {
    "upc": {
      "type": "string",
      "description": "UPC barcode to look up"
    },
    "kroger_id": {
      "type": "string",
      "description": "Kroger product ID"
    },
    "query": {
      "type": "string",
      "description": "Search Kroger products by name"
    },
    "limit": {
      "type": "number",
      "default": 10
    }
  }
}

Compare 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.

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "description": "Product name: eggs, ground beef, lettuce, milk, chicken, bread, etc."
    }
  },
  "required": [
    "product"
  ]
}

Find 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.

{
  "type": "object",
  "properties": {
    "max_price": {
      "type": "number",
      "description": "Maximum price in dollars"
    },
    "min_protein": {
      "type": "number",
      "description": "Minimum protein grams per serving"
    },
    "max_calories": {
      "type": "number",
      "description": "Maximum calories per serving"
    },
    "max_fat": {
      "type": "number",
      "description": "Maximum total fat grams (great for post-gallbladder)"
    },
    "max_carbs": {
      "type": "number",
      "description": "Maximum carbs grams (great for keto/GLP-1)"
    },
    "max_sodium": {
      "type": "number",
      "description": "Maximum sodium mg"
    },
    "allergen_free": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Allergens to exclude: gluten, dairy, nuts, soy, eggs, shellfish, wheat, peanuts"
    },
    "snap_only": {
      "type": "boolean",
      "description": "Only SNAP-eligible products",
      "default": false
    },
    "organic_only": {
      "type": "boolean",
      "description": "Only certified organic products",
      "default": false
    },
    "in_stock": {
      "type": "boolean",
      "description": "Only products currently in stock",
      "default": true
    },
    "category": {
      "type": "string",
      "description": "Product category filter (Produce, Dairy, Meat & Seafood, etc.)"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "price",
        "protein",
        "calories",
        "protein_per_dollar",
        "rating"
      ],
      "default": "price"
    },
    "limit": {
      "type": "number",
      "default": 20
    }
  }
}

Find 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.

{
  "type": "object",
  "properties": {
    "members": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Person name"
          },
          "max_fat": {
            "type": "number"
          },
          "min_protein": {
            "type": "number"
          },
          "max_calories": {
            "type": "number"
          },
          "max_carbs": {
            "type": "number"
          },
          "max_sodium": {
            "type": "number"
          },
          "allergen_free": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "description": "Household members with individual dietary constraints"
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price per item"
    },
    "category": {
      "type": "string",
      "description": "Product category filter"
    },
    "limit": {
      "type": "number",
      "default": 15
    }
  },
  "required": [
    "members"
  ]
}

Given 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.

{
  "type": "object",
  "properties": {
    "upcs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of UPC barcodes from a receipt"
    }
  },
  "required": [
    "upcs"
  ]
}

Read 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.

{
  "type": "object",
  "properties": {
    "profile_hash": {
      "type": "string",
      "description": "Profile hash from the URL (e.g., \"8f3k9x2p\")"
    }
  },
  "required": [
    "profile_hash"
  ]
}

Recommend 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.

{
  "type": "object",
  "properties": {
    "profile_hash": {
      "type": "string",
      "description": "Bridge profile hash from /p/{hash}. If given, constraints are read from the user profile."
    },
    "agent_id": {
      "type": "string",
      "description": "Your agent id (claude/gpt/grok/gemini). With profile_hash, the recommendation is written into portable agent memory."
    },
    "diet": {
      "type": "string",
      "description": "Override diet: any | high-protein | keto | pescatarian | vegetarian | vegan"
    },
    "exclude_allergens": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Allergens to avoid, e.g. [\"dairy\",\"shellfish\"]"
    },
    "min_protein": {
      "type": "number",
      "description": "Minimum protein grams"
    },
    "max_sodium": {
      "type": "number",
      "description": "Maximum sodium mg"
    },
    "max_calories": {
      "type": "number",
      "description": "Maximum calories"
    },
    "ready_to_eat": {
      "type": "boolean",
      "description": "Only ready-to-eat (Factor) meals — no cooking"
    },
    "brand": {
      "type": "string",
      "description": "Filter to a brand: HelloFresh | Factor"
    },
    "limit": {
      "type": "number",
      "default": 5,
      "description": "Max recommendations"
    }
  }
}