Parsley MCP by usefulapi
Read Parsley menu items, nutrition, allergens, ingredients and events; record event sales and waste.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"parsley": {
"url": "https://parsley.usefulapi.io/mcp"
}
}
}远程端点
https://parsley.usefulapi.io/mcpstreamable-http它能做什么
工具清单
工具（15）
🟢parsley_list_menu_items(search, type, tag, limit, offset)
List the recipes, sub-recipes and ingredients in the Parsley account that can be used on events: id, name, item number, price, tags, active flag, chef and last-modified time. Use the ids with parsley_get_menu_item for nutrition, allergens and ingredients, and on events. The API returns the whole list at once; search/limit/offset slice it here. GET /menu_items.
输入模式
{
"type": "object",
"properties": {
"search": {
"description": "Only menu items whose name contains this text (case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"type": {
"description": "Only this kind of item.",
"type": "string",
"enum": [
"recipe",
"subrecipe",
"ingredient"
]
},
"tag": {
"description": "Only items carrying this tag (exact, case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"limit": {
"description": "Results to return, 1-500 (default 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
},
"offset": {
"description": "Skip this many results (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢parsley_get_menu_item(menu_item_id)
One menu item in full: names, description, price, cost, shelf life, serving size, nutrition facts (nutrients), the allergen flags and allergen text, dietary characteristics (meat, pork, corn, poultry) and the ingredient list. The photo link is returned without its access token. GET /menu_items/{id}.
输入模式
{
"type": "object",
"properties": {
"menu_item_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Parsley menu item id (from parsley_list_menu_items)."
}
},
"required": [
"menu_item_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢parsley_list_menus(search, limit, offset)
List the menus (menu plans) in the account: id, name and last-modified time. Use the id with parsley_get_menu or when creating an event. GET /menus.
输入模式
{
"type": "object",
"properties": {
"search": {
"description": "Only menus whose name contains this text (case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"limit": {
"description": "Results to return, 1-500 (default 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
},
"offset": {
"description": "Skip this many results (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢parsley_get_menu(menu_id)
One menu with its sections and the menu items in each section, and its serving stations. GET /menus/{id}.
输入模式
{
"type": "object",
"properties": {
"menu_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Parsley menu id (from parsley_list_menus)."
}
},
"required": [
"menu_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢parsley_list_ingredients(search, used_by_recipe, limit, offset)
List the ingredients that can be used in recipes: id, parent id, name, label name, item number, supported units, and whether a recipe uses it. The API returns the whole list at once; search/limit/offset slice it here. GET /ingredients.
输入模式
{
"type": "object",
"properties": {
"search": {
"description": "Only ingredients whose name contains this text (case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"used_by_recipe": {
"description": "true: only ingredients used by a recipe; false: only unused ones.",
"type": "boolean"
},
"limit": {
"description": "Results to return, 1-500 (default 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
},
"offset": {
"description": "Skip this many results (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢parsley_get_ingredient(ingredient_id)
One ingredient in full: unit conversions, supported units, tags, the supply options (supplier, SKU, pack size, cost) used for costing and the preparations with yield. Parsley limits this call to 1 request every 3 seconds, so fetch ingredients one at a time. GET /ingredients/{id}.
输入模式
{
"type": "object",
"properties": {
"ingredient_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Parsley ingredient id (from parsley_list_ingredients)."
}
},
"required": [
"ingredient_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢parsley_list_events(start, end, search, type, limit, ...)
List events (a workday, shift, service or catering event) that fall in a date window: id, name, type (standard, cafe-hot-bar, sale, forecast), date, start and end time, menu id. A bare date means the whole day in the account timezone. GET /events.
输入模式
{
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "Window start (inclusive): yyyy-mm-dd or an ISO 8601 date-time. Without a timezone the account timezone applies."
},
"end": {
"type": "string",
"description": "Window end (inclusive): yyyy-mm-dd (to the end of that day) or an ISO 8601 date-time."
},
"search": {
"description": "Only events whose name contains this text (case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"type": {
"description": "Only this event type.",
"type": "string",
"enum": [
"standard",
"cafe-hot-bar",
"sale",
"forecast"
]
},
"limit": {
"description": "Results to return, 1-500 (default 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
},
"offset": {
"description": "Skip this many results (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"start",
"end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢parsley_get_event(event_id)
One event with its metadata and all line items (menu item, amount, unit, station, section). GET /events/{id}.
输入模式
{
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Parsley event id (from parsley_list_events)."
}
},
"required": [
"event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢parsley_list_serving_stations(limit, offset)
List the serving stations (id, name) that menu items and event line items can be assigned to. GET /tags/serving_stations.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Results to return, 1-500 (default 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
},
"offset": {
"description": "Skip this many results (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢parsley_list_chef_tags(limit, offset)
List the chef tags (id, name) that recipes are attributed to. Only meaningful for accounts with Chef IDs enabled. GET /tags/chefs.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Results to return, 1-500 (default 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
},
"offset": {
"description": "Skip this many results (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢parsley_list_chef_users(search, limit, offset)
List the chef users of the account: id, email, join date, active flag, permission level and the chef tag they are tied to. Only meaningful for accounts with Chef IDs enabled. GET /users/chefs.
输入模式
{
"type": "object",
"properties": {
"search": {
"description": "Only chef users (matched on email or chef name) whose name contains this text (case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"limit": {
"description": "Results to return, 1-500 (default 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
},
"offset": {
"description": "Skip this many results (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡parsley_create_event(name, type, date, start_time, end_time, ...)
WRITE: create an event (a workday, shift, service or catering event) in Parsley with its menu items. This changes the account's production plan and is NOT idempotent: calling it twice creates two events. Returns the new event id. Use parsley_list_events first to avoid duplicates. POST /events.
输入模式
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Event name, e.g. 'Brunch'."
},
"type": {
"type": "string",
"enum": [
"standard",
"cafe-hot-bar",
"sale",
"forecast"
],
"description": "Event type: standard, cafe-hot-bar, sale or forecast."
},
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "The day of the event, yyyy-mm-dd."
},
"start_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Time of day, HH:mm (24 hour)."
},
"end_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Time of day, HH:mm (24 hour)."
},
"menu_id": {
"description": "Parsley menu id the event uses (from parsley_list_menus).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": {
"type": "string",
"maxLength": 2000
},
"private": {
"description": "Mark the event private.",
"type": "boolean"
},
"line_items": {
"maxItems": 500,
"type": "array",
"items": {
"type": "object",
"properties": {
"menu_item": {
"description": "Parsley menu item id (from parsley_list_menu_items). Give this OR item_id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"item_id": {
"description": "The menu item's own item number (itemNumber). Give this OR menu_item.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"amount": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000,
"description": "Quantity (whole number)."
},
"uom": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Unit of measure as Parsley expects it: kg, lb, gr, oz, ml, cup, qt, pt, tsp, Tbsp, fl oz, liter, gal, ea, ea2 (Parsley's own examples also use 'portions')."
},
"station": {
"description": "Serving station name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"section": {
"description": "Menu section name.",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"amount",
"uom"
]
},
"description": "The menu items and amounts to produce or sell (may be empty)."
}
},
"required": [
"name",
"type",
"date",
"line_items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴parsley_update_event_covers(event_id, forecast_covers, actual_covers)
WRITE: set the forecast and/or actual number of covers (guests served) on an event. Only the fields you pass change. actual_covers works only on cafe/hot bar events. Setting the same values again has no further effect. PATCH /events/{id}.
输入模式
{
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Parsley event id."
},
"forecast_covers": {
"description": "Predicted number of covers.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
},
"actual_covers": {
"description": "Real number of covers (cafe/hot bar events only).",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"required": [
"event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴parsley_record_event_sales(event_id, sales)
WRITE: push sold quantities per menu item to a cafe/hot bar event, which feeds Parsley's cost and usage reports. Other event types are refused by Parsley, as is a menu item with no made quantity on the event. Sending the same quantities again overwrites rather than adds. PUT /events/{id}/sales.
输入模式
{
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Parsley event id of a cafe/hot bar event."
},
"sales": {
"minItems": 1,
"maxItems": 500,
"type": "array",
"items": {
"type": "object",
"properties": {
"menu_item": {
"description": "Parsley menu item id (from parsley_list_menu_items). Give this OR item_id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"item_id": {
"description": "The menu item's own item number (itemNumber). Give this OR menu_item.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"amount": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000,
"description": "Quantity (whole number)."
},
"uom": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Unit of measure as Parsley expects it: kg, lb, gr, oz, ml, cup, qt, pt, tsp, Tbsp, fl oz, liter, gal, ea, ea2 (Parsley's own examples also use 'portions')."
},
"station": {
"description": "Serving station name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"section": {
"description": "Menu section name.",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"amount",
"uom"
]
},
"description": "Sold amount per menu item."
}
},
"required": [
"event_id",
"sales"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴parsley_record_waste_leftover(event_id, items)
WRITE: push waste and/or leftover quantities per menu item to a cafe/hot bar event. If no sold quantity exists, Parsley derives it as made minus waste minus leftover. Parsley refuses amounts above what was made minus sold. Sending the same quantities again overwrites rather than adds. PUT /events/{id}/waste_leftover.
输入模式
{
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Parsley event id of a cafe/hot bar event."
},
"items": {
"minItems": 1,
"maxItems": 500,
"type": "array",
"items": {
"type": "object",
"properties": {
"menu_item": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Parsley menu item id."
},
"waste_amount": {
"description": "Wasted quantity.",
"type": "integer",
"minimum": 0,
"maximum": 1000000000
},
"waste_uom": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Unit of measure as Parsley expects it: kg, lb, gr, oz, ml, cup, qt, pt, tsp, Tbsp, fl oz, liter, gal, ea, ea2 (Parsley's own examples also use 'portions')."
},
"leftover_amount": {
"description": "Leftover quantity.",
"type": "integer",
"minimum": 0,
"maximum": 1000000000
},
"leftover_uom": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Unit of measure as Parsley expects it: kg, lb, gr, oz, ml, cup, qt, pt, tsp, Tbsp, fl oz, liter, gal, ea, ea2 (Parsley's own examples also use 'portions')."
},
"station": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"menu_item"
]
}
}
},
"required": [
"event_id",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社区
证据