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"
}
}
}社区
证据