parsley_create_event

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.

Argument	Type	Description
date*	string	The day of the event, yyyy-mm-dd.
name*	string	Event name, e.g. 'Brunch'.
type*	string	Event type: standard, cafe-hot-bar, sale or forecast.
menu_id	integer	Parsley menu id the event uses (from parsley_list_menus).
private	boolean	Mark the event private.
end_time	string	Time of day, HH:mm (24 hour).
line_items*	array	The menu items and amounts to produce or sell (may be empty).
start_time	string	Time of day, HH:mm (24 hour).
description	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name",
    "type",
    "date",
    "line_items"
  ],
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "The day of the event, yyyy-mm-dd."
    },
    "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Event name, e.g. 'Brunch'."
    },
    "type": {
      "enum": [
        "standard",
        "cafe-hot-bar",
        "sale",
        "forecast"
      ],
      "type": "string",
      "description": "Event type: standard, cafe-hot-bar, sale or forecast."
    },
    "menu_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Parsley menu id the event uses (from parsley_list_menus).",
      "exclusiveMinimum": 0
    },
    "private": {
      "type": "boolean",
      "description": "Mark the event private."
    },
    "end_time": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Time of day, HH:mm (24 hour)."
    },
    "line_items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "amount",
          "uom"
        ],
        "properties": {
          "uom": {
            "type": "string",
            "maxLength": 20,
            "minLength": 1,
            "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')."
          },
          "amount": {
            "type": "integer",
            "maximum": 1000000000,
            "minimum": 0,
            "description": "Quantity (whole number)."
          },
          "item_id": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "The menu item's own item number (itemNumber). Give this OR menu_item."
          },
          "section": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Menu section name."
          },
          "station": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Serving station name."
          },
          "menu_item": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Parsley menu item id (from parsley_list_menu_items). Give this OR item_id.",
            "exclusiveMinimum": 0
          }
        }
      },
      "maxItems": 500,
      "description": "The menu items and amounts to produce or sell (may be empty)."
    },
    "start_time": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Time of day, HH:mm (24 hour)."
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

parsley_get_event

One event with its metadata and all line items (menu item, amount, unit, station, section). GET /events/{id}.

read-only

Argument	Type	Description
event_id*	integer	Parsley event id (from parsley_list_events).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id"
  ],
  "properties": {
    "event_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Parsley event id (from parsley_list_events).",
      "exclusiveMinimum": 0
    }
  }
}

parsley_get_ingredient

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

read-only

Argument	Type	Description
ingredient_id*	integer	Parsley ingredient id (from parsley_list_ingredients).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ingredient_id"
  ],
  "properties": {
    "ingredient_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Parsley ingredient id (from parsley_list_ingredients).",
      "exclusiveMinimum": 0
    }
  }
}

parsley_get_menu

One menu with its sections and the menu items in each section, and its serving stations. GET /menus/{id}.

read-only

Argument	Type	Description
menu_id*	integer	Parsley menu id (from parsley_list_menus).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "menu_id"
  ],
  "properties": {
    "menu_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Parsley menu id (from parsley_list_menus).",
      "exclusiveMinimum": 0
    }
  }
}

parsley_get_menu_item

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

read-only

Argument	Type	Description
menu_item_id*	integer	Parsley menu item id (from parsley_list_menu_items).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "menu_item_id"
  ],
  "properties": {
    "menu_item_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Parsley menu item id (from parsley_list_menu_items).",
      "exclusiveMinimum": 0
    }
  }
}

parsley_list_chef_tags

List the chef tags (id, name) that recipes are attributed to. Only meaningful for accounts with Chef IDs enabled. GET /tags/chefs.

read-only

Argument	Type	Description
limit	integer	Results to return, 1-500 (default 100).
offset	integer	Skip this many results (default 0). Pass the previous reply's next_offset.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "description": "Results to return, 1-500 (default 100).",
      "exclusiveMinimum": 0
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Skip this many results (default 0). Pass the previous reply's next_offset."
    }
  }
}

parsley_list_chef_users

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.

read-only

Argument	Type	Description
limit	integer	Results to return, 1-500 (default 100).
offset	integer	Skip this many results (default 0). Pass the previous reply's next_offset.
search	string	Only chef users (matched on email or chef name) whose name contains this text (case-insensitive).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "description": "Results to return, 1-500 (default 100).",
      "exclusiveMinimum": 0
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Skip this many results (default 0). Pass the previous reply's next_offset."
    },
    "search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only chef users (matched on email or chef name) whose name contains this text (case-insensitive)."
    }
  }
}

parsley_list_events

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.

read-only

Argument	Type	Description
end*	string	Window end (inclusive): yyyy-mm-dd (to the end of that day) or an ISO 8601 date-time.
type	string	Only this event type.
limit	integer	Results to return, 1-500 (default 100).
start*	string	Window start (inclusive): yyyy-mm-dd or an ISO 8601 date-time. Without a timezone the account timezone applies.
offset	integer	Skip this many results (default 0). Pass the previous reply's next_offset.
search	string	Only events whose name contains this text (case-insensitive).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "start",
    "end"
  ],
  "properties": {
    "end": {
      "type": "string",
      "description": "Window end (inclusive): yyyy-mm-dd (to the end of that day) or an ISO 8601 date-time."
    },
    "type": {
      "enum": [
        "standard",
        "cafe-hot-bar",
        "sale",
        "forecast"
      ],
      "type": "string",
      "description": "Only this event type."
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "description": "Results to return, 1-500 (default 100).",
      "exclusiveMinimum": 0
    },
    "start": {
      "type": "string",
      "description": "Window start (inclusive): yyyy-mm-dd or an ISO 8601 date-time. Without a timezone the account timezone applies."
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Skip this many results (default 0). Pass the previous reply's next_offset."
    },
    "search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only events whose name contains this text (case-insensitive)."
    }
  }
}

parsley_list_ingredients

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.

read-only

Argument	Type	Description
limit	integer	Results to return, 1-500 (default 100).
offset	integer	Skip this many results (default 0). Pass the previous reply's next_offset.
search	string	Only ingredients whose name contains this text (case-insensitive).
used_by_recipe	boolean	true: only ingredients used by a recipe; false: only unused ones.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "description": "Results to return, 1-500 (default 100).",
      "exclusiveMinimum": 0
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Skip this many results (default 0). Pass the previous reply's next_offset."
    },
    "search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only ingredients whose name contains this text (case-insensitive)."
    },
    "used_by_recipe": {
      "type": "boolean",
      "description": "true: only ingredients used by a recipe; false: only unused ones."
    }
  }
}

parsley_list_menu_items

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.

read-only

Argument	Type	Description
tag	string	Only items carrying this tag (exact, case-insensitive).
type	string	Only this kind of item.
limit	integer	Results to return, 1-500 (default 100).
offset	integer	Skip this many results (default 0). Pass the previous reply's next_offset.
search	string	Only menu items whose name contains this text (case-insensitive).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "tag": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only items carrying this tag (exact, case-insensitive)."
    },
    "type": {
      "enum": [
        "recipe",
        "subrecipe",
        "ingredient"
      ],
      "type": "string",
      "description": "Only this kind of item."
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "description": "Results to return, 1-500 (default 100).",
      "exclusiveMinimum": 0
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Skip this many results (default 0). Pass the previous reply's next_offset."
    },
    "search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only menu items whose name contains this text (case-insensitive)."
    }
  }
}

parsley_list_menus

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.

read-only

Argument	Type	Description
limit	integer	Results to return, 1-500 (default 100).
offset	integer	Skip this many results (default 0). Pass the previous reply's next_offset.
search	string	Only menus whose name contains this text (case-insensitive).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "description": "Results to return, 1-500 (default 100).",
      "exclusiveMinimum": 0
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Skip this many results (default 0). Pass the previous reply's next_offset."
    },
    "search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only menus whose name contains this text (case-insensitive)."
    }
  }
}

parsley_list_serving_stations

List the serving stations (id, name) that menu items and event line items can be assigned to. GET /tags/serving_stations.

read-only

Argument	Type	Description
limit	integer	Results to return, 1-500 (default 100).
offset	integer	Skip this many results (default 0). Pass the previous reply's next_offset.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "description": "Results to return, 1-500 (default 100).",
      "exclusiveMinimum": 0
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Skip this many results (default 0). Pass the previous reply's next_offset."
    }
  }
}

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

destructive

Argument	Type	Description
sales*	array	Sold amount per menu item.
event_id*	integer	Parsley event id of a cafe/hot bar event.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id",
    "sales"
  ],
  "properties": {
    "sales": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "amount",
          "uom"
        ],
        "properties": {
          "uom": {
            "type": "string",
            "maxLength": 20,
            "minLength": 1,
            "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')."
          },
          "amount": {
            "type": "integer",
            "maximum": 1000000000,
            "minimum": 0,
            "description": "Quantity (whole number)."
          },
          "item_id": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "The menu item's own item number (itemNumber). Give this OR menu_item."
          },
          "section": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Menu section name."
          },
          "station": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Serving station name."
          },
          "menu_item": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Parsley menu item id (from parsley_list_menu_items). Give this OR item_id.",
            "exclusiveMinimum": 0
          }
        }
      },
      "maxItems": 500,
      "minItems": 1,
      "description": "Sold amount per menu item."
    },
    "event_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Parsley event id of a cafe/hot bar event.",
      "exclusiveMinimum": 0
    }
  }
}

parsley_record_waste_leftover

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.

destructive

Argument	Type	Description
items*	array
event_id*	integer	Parsley event id of a cafe/hot bar event.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "menu_item"
        ],
        "properties": {
          "section": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1
          },
          "station": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1
          },
          "menu_item": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Parsley menu item id.",
            "exclusiveMinimum": 0
          },
          "waste_uom": {
            "type": "string",
            "maxLength": 20,
            "minLength": 1,
            "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_uom": {
            "type": "string",
            "maxLength": 20,
            "minLength": 1,
            "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')."
          },
          "waste_amount": {
            "type": "integer",
            "maximum": 1000000000,
            "minimum": 0,
            "description": "Wasted quantity."
          },
          "leftover_amount": {
            "type": "integer",
            "maximum": 1000000000,
            "minimum": 0,
            "description": "Leftover quantity."
          }
        }
      },
      "maxItems": 500,
      "minItems": 1
    },
    "event_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Parsley event id of a cafe/hot bar event.",
      "exclusiveMinimum": 0
    }
  }
}

parsley_update_event_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}.

destructive

Argument	Type	Description
event_id*	integer	Parsley event id.
actual_covers	integer	Real number of covers (cafe/hot bar events only).
forecast_covers	integer	Predicted number of covers.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id"
  ],
  "properties": {
    "event_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Parsley event id.",
      "exclusiveMinimum": 0
    },
    "actual_covers": {
      "type": "integer",
      "maximum": 10000000,
      "minimum": 0,
      "description": "Real number of covers (cafe/hot bar events only)."
    },
    "forecast_covers": {
      "type": "integer",
      "maximum": 10000000,
      "minimum": 0,
      "description": "Predicted number of covers."
    }
  }
}

Parsley MCP by usefulapi

Try it

parsley_create_event

Parsley MCP by usefulapi

Try it

parsley_create_event

Tools (15)