grocery
Signed US food & grocery data: Kroger prices, nutrition, allergens, recalls, diet filters.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"grocery": {
"url": "https://food.rootz.global/mcp"
}
}
}遠端端點
https://food.rootz.global/mcpstreamable-http它能做什麼
工具清單
工具（18）
🟢food_search(query, brand, category, source, limit)
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"
]
}🟢food_nutrition(product_id, upc, kroger_id)
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"
}
}
}⚪food_compare(product_ids, nutrients)
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"
]
}🟢food_recall_search(query, classification, state, year, limit)
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
}
}
}🟢food_recall_check(product, months)
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"
]
}🟢food_commodity_prices(commodity, category, market, weeks)
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"
}
}
}🟢food_retail_prices(item, months)
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"
}
}
}⚪food_ingredients_lookup(query, allergen, limit)
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"
]
}🟡food_data_sources
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": {}
}🟢food_new_products(days, source, limit)
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
}
}
}🟢food_supply_chain(product_id, product_name)
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"
}
}
}🟢food_kroger_product(upc, kroger_id, query, limit)
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
}
}
}⚪food_price_compare(product)
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"
]
}🟢food_diet_filter(max_price, min_protein, max_calories, max_fat, max_carbs, ...)
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
}
}
}🟢food_household_meal(members, max_price, category, limit)
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"
]
}🟢food_receipt_lookup(upcs)
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"
]
}🟢food_profile(profile_hash)
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"
]
}⚪food_meal_recommend(profile_hash, agent_id, diet, exclude_allergens, min_protein, ...)
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"
}
}
}社群
證據