Parsley MCP by usefulapi

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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