{
  "source": "Kitchen Studio MCP exported TOOLS",
  "reviewed": "2026-10-15",
  "tools": [
    {
      "name": "prepare_equipment",
      "title": "Review equipment details",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "description": "Validate up to 50 equipment rows extracted by your agent or supplied by the user. No writes and no AI service call. Returns missing fields, unknown utilities, exact catalogue matches with conflicts, and custom payloads for add_items. Omit prices, customer details and instructions from documents. Never infer dimensions, mounting or utilities. Quantity is returned separately; each add_items entry places one unit. Custom records remain unverified.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "equipment": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "brand": {
                  "type": "string"
                },
                "model": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "category": {
                  "type": "string"
                },
                "width_mm": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "depth_mm": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "height_mm": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "mount": {
                  "enum": [
                    "floor",
                    "top",
                    null
                  ]
                },
                "power": {
                  "enum": [
                    "electric",
                    "gas",
                    "charcoal",
                    "none",
                    null
                  ]
                },
                "kw": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "electrical": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "water": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "drain": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "spec_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "region": {
                  "type": "string"
                },
                "variant": {
                  "type": "string"
                },
                "quantity": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "minimum": 1,
                  "maximum": 100
                }
              },
              "required": [],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "equipment"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "search_equipment",
      "title": "Search the equipment catalogue",
      "annotations": {
        "readOnlyHint": true
      },
      "description": "Search Kitchen Studio's catalogue of real commercial kitchen equipment (published dimensions, power, kW, water/drain). Returns catalogue keys to use with add_items.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Words to match, e.g. 'rational 6-1/1', 'undercounter dishwasher', 'oven stand'."
          },
          "category": {
            "type": "string"
          },
          "limit": {
            "type": "number"
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "list_fabricated_types",
      "title": "List fabricated (stainless and refrigerated) types",
      "annotations": {
        "readOnlyHint": true
      },
      "description": "Stainless items made to size (tables, sinks, shelves, hoods, pass shelves) and fabricated refrigeration (counter chillers, lowboys, saladettes), with default sizes and options.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": [],
        "additionalProperties": false
      }
    },
    {
      "name": "list_kitchens",
      "title": "List my kitchens",
      "annotations": {
        "readOnlyHint": true
      },
      "description": "Kitchens saved in the user's Kitchen Studio account.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": [],
        "additionalProperties": false
      }
    },
    {
      "name": "get_kitchen",
      "title": "Open a kitchen",
      "annotations": {
        "readOnlyHint": true
      },
      "description": "Room size, every item with its number (as in the app), id, position, size, what it sits on, loads, openings, and layout checks.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "kitchen_id": {
            "type": "string"
          }
        },
        "required": [
          "kitchen_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "create_kitchen",
      "title": "Create a kitchen",
      "description": "New empty kitchen in the user's account (rectangular room).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "width_mm": {
            "type": "number",
            "description": "West to east, inside."
          },
          "depth_mm": {
            "type": "number",
            "description": "North to south, inside."
          },
          "ceiling_mm": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "width_mm",
          "depth_mm"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "update_kitchen",
      "title": "Rename or resize a kitchen",
      "description": "Change the name or the room size.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "kitchen_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "width_mm": {
            "type": "number"
          },
          "depth_mm": {
            "type": "number"
          },
          "ceiling_mm": {
            "type": "number"
          }
        },
        "required": [
          "kitchen_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "add_items",
      "title": "Add equipment",
      "description": "Add catalogue equipment, fabricated stainless/refrigeration, custom equipment, or doors/columns/service points. Returns the new ids and the layout checks.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "kitchen_id": {
            "type": "string"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Exactly one of catalogue / fabricated / custom / opening, plus where it goes.",
              "properties": {
                "catalogue": {
                  "type": "string",
                  "description": "Catalogue key 'Brand|Model' from search_equipment."
                },
                "fabricated": {
                  "type": "string",
                  "description": "Fabricated type key from list_fabricated_types (stainless or refrigerated)."
                },
                "width_mm": {
                  "type": "number"
                },
                "depth_mm": {
                  "type": "number"
                },
                "height_mm": {
                  "type": "number"
                },
                "z_mm": {
                  "type": "number",
                  "description": "Wall-hung items: underside height."
                },
                "options": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "material": {
                  "type": "string",
                  "enum": [
                    "AISI 304, 1.2 mm",
                    "AISI 304, 1.5 mm",
                    "AISI 316, 1.5 mm",
                    "AISI 430, 1.0 mm"
                  ]
                },
                "kw": {
                  "type": "number",
                  "description": "Required for refrigerated fabricated types and custom electric/gas equipment."
                },
                "custom": {
                  "type": "object",
                  "properties": {
                    "brand": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "category": {
                      "type": "string"
                    },
                    "width_mm": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "depth_mm": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "height_mm": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "mount": {
                      "enum": [
                        "floor",
                        "top",
                        null
                      ]
                    },
                    "power": {
                      "enum": [
                        "electric",
                        "gas",
                        "charcoal",
                        "none",
                        null
                      ]
                    },
                    "kw": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "electrical": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "water": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    },
                    "drain": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    },
                    "spec_url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "region": {
                      "type": "string"
                    },
                    "variant": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "brand",
                    "model",
                    "width_mm",
                    "depth_mm",
                    "height_mm",
                    "mount"
                  ],
                  "additionalProperties": false,
                  "description": "User-supplied equipment. Use prepare_equipment first. Unknown utilities stay null. Never invent specifications or label custom items verified."
                },
                "opening": {
                  "type": "string",
                  "enum": [
                    "door",
                    "door2",
                    "window",
                    "column",
                    "drain",
                    "gas",
                    "water",
                    "power"
                  ],
                  "description": "Doors and windows go on a wall; columns and service points by x/y or wall."
                },
                "wall": {
                  "type": "string",
                  "enum": [
                    "north",
                    "south",
                    "east",
                    "west"
                  ],
                  "description": "Put the item's back against this wall."
                },
                "offset_mm": {
                  "type": "number",
                  "description": "With wall: distance from the wall's start (north/south walls measure from the west end, east/west walls from the north end). With on_top_of: distance from the base's start. Omit with wall to take the first free spot."
                },
                "x_mm": {
                  "type": "number"
                },
                "y_mm": {
                  "type": "number"
                },
                "rot": {
                  "type": "number",
                  "enum": [
                    0,
                    90,
                    180,
                    270
                  ]
                },
                "on_top_of": {
                  "type": "string",
                  "description": "Id of a floor item (table, chef base, counter fridge, oven stand) to sit this countertop item on."
                }
              }
            },
            "maxItems": 40
          }
        },
        "required": [
          "kitchen_id",
          "items"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "update_items",
      "title": "Move or change equipment",
      "description": "Move items (wall/offset, x/y/rot, on_top_of), change size/height/z/kw/options of fabricated and custom items, or rename them. Catalogue models keep their spec-sheet size.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "kitchen_id": {
            "type": "string"
          },
          "changes": {
            "type": "array",
            "maxItems": 40,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "wall": {
                  "type": "string",
                  "enum": [
                    "north",
                    "south",
                    "east",
                    "west"
                  ],
                  "description": "Put the item's back against this wall."
                },
                "offset_mm": {
                  "type": "number",
                  "description": "With wall: distance from the wall's start (north/south walls measure from the west end, east/west walls from the north end). With on_top_of: distance from the base's start. Omit with wall to take the first free spot."
                },
                "x_mm": {
                  "type": "number"
                },
                "y_mm": {
                  "type": "number"
                },
                "rot": {
                  "type": "number",
                  "enum": [
                    0,
                    90,
                    180,
                    270
                  ]
                },
                "on_top_of": {
                  "type": "string",
                  "description": "Id of a floor item (table, chef base, counter fridge, oven stand) to sit this countertop item on."
                },
                "width_mm": {
                  "type": "number"
                },
                "depth_mm": {
                  "type": "number"
                },
                "height_mm": {
                  "type": "number"
                },
                "z_mm": {
                  "type": "number"
                },
                "kw": {
                  "type": "number"
                },
                "options": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "name": {
                  "type": "string"
                },
                "fabrication_details": {
                  "type": "object",
                  "description": "Fabricated items only: details for the fabricator's drawing sheet, e.g. {\"upstand\":\"150 mm\",\"drainer\":\"Left\",\"bowl\":\"500 × 400 × 300\",\"notes\":\"...\"}. Keys and allowed values are in get_kitchen (fabrication_details) and fabrication_fields."
                }
              },
              "required": [
                "id"
              ]
            }
          }
        },
        "required": [
          "kitchen_id",
          "changes"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "remove_items",
      "title": "Remove equipment",
      "annotations": {
        "destructiveHint": true
      },
      "description": "Remove items from a kitchen by id.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "kitchen_id": {
            "type": "string"
          },
          "item_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 40
          }
        },
        "required": [
          "kitchen_id",
          "item_ids"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "check_layout",
      "title": "Check the layout",
      "annotations": {
        "readOnlyHint": true
      },
      "description": "Overlaps, items outside the room, blocked door swings, countertop items with no base, cooking equipment not under a hood.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "kitchen_id": {
            "type": "string"
          }
        },
        "required": [
          "kitchen_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "get_schedule",
      "title": "Equipment schedule and loads",
      "annotations": {
        "readOnlyHint": true
      },
      "description": "Equipment list with power, kW, water and drain, and the electrical/gas/water/drain totals. (Drawing exports are made in the app.)",
      "inputSchema": {
        "type": "object",
        "properties": {
          "kitchen_id": {
            "type": "string"
          }
        },
        "required": [
          "kitchen_id"
        ],
        "additionalProperties": false
      }
    }
  ]
}
