Timeplex K-Beauty Booking

Previous value: -"Area (optional; overrides an area found in query), in English, Korean, Japanese or Chinese — \"Seoul\", \"Gangnam\", \"Myeongdong\", \"Hongdae\", \"Seongsu\", \"Busan\", \"강남\", \"明洞\"… If no shop is in that area, the search widens to the surrounding city (relaxed). Newly joined shops with no address yet are appended with area_match=false."New value: +"Area (optional; overrides an area found in query), in English, Korean, Japanese, Chinese or Russian — \"Seoul\", \"Gangnam\", \"Myeongdong\", \"Hongdae\", \"Seongsu\", \"Busan\", \"강남\", \"明洞\", \"Сеул\"… If no shop is in that area, the search widens to the surrounding city (relaxed). Newly joined shops with no address yet are appended with area_match=false."

Previous value: -"Service (optional; overrides a service found in query). Available on TimePlex now: massage, head spa / scalp treatment, hair salon, spa, Korean body scrub (seshin, akasuri), makeup, semi-permanent makeup (PMU, microblading, brow tattoo) — in English, Korean, Japanese or Chinese (マッサージ, ヘッドスパ, アカスリ, 按摩, 搓澡…). Other services (nail, lash, facial, personal color) are recognized but may return unsupported_service. Leave empty to search all."New value: +"Service (optional; overrides a service found in query). Available on TimePlex now: massage, head spa / scalp treatment, hair salon, spa, Korean body scrub (seshin, akasuri), makeup, semi-permanent makeup (PMU, microblading, brow tattoo) — in English, Korean, Japanese, Chinese or Russian (マッサージ, ヘッドスパ, アカスリ, 按摩, 搓澡, массаж, сесин…). Other services (nail, lash, facial, personal color) are recognized but may return unsupported_service. Leave empty to search all."

Previous value: -"Booking items. Follow the booking_model returned by get_shop_services: use resource_id for designated-staff shops and qty for capacity-based shops. designated (hair salons, plus some beauty shops such as body scrub): [{service_id, resource_id}]. capacity (most massage, spa, etc.): [{service_id, qty}] where qty is the number of people."New value: +"Booking items. Follow the booking_model returned by get_shop_services: use resource_id for designated-staff shops and qty for capacity-based shops. designated (hair salons, plus some beauty shops such as body scrub): [{service_id, resource_id}]. capacity (most massage, spa, etc.): [{service_id, qty}] where qty is the number of guests (party size)."

Previous value: -"Area filter (optional), in English or Korean — \"Seoul\", \"Gangnam\", \"Hongdae\", \"Busan\", \"Jeju\", \"강남\", \"홍대\"… Matched against the shop address. Shops with no address registered are excluded when this is set."New value: +"Area (optional; overrides an area found in query), in English, Korean, Japanese or Chinese — \"Seoul\", \"Gangnam\", \"Myeongdong\", \"Hongdae\", \"Seongsu\", \"Busan\", \"강남\", \"明洞\"… If no shop is in that area, the search widens to the surrounding city (relaxed). Newly joined shops with no address yet are appended with area_match=false."

Previous value: -"Shop name, service, or natural-language search term (optional). If no shop name matches, it is also interpreted as a service/category search."New value: +"Free-text user request or a specific shop name (optional), in any language. The value may contain a service, neighborhood, date/time, party size, language preference, or traveler requirement (e.g. \"foreigner-friendly head spa in Gangnam tomorrow for 2 people\"). Recognized service and location terms are extracted before shop-name matching; the value is treated as a shop name only when the remaining words closely match a registered shop."

Previous value: -"Shop category (optional). Accepts broad categories (\"hair\", \"beauty\") and specific ones (\"massage\", \"spa\", \"head spa\", \"nail\", \"skincare\", \"facial\", \"esthetic\", \"waxing\", \"scrub\"), in English, Korean, Japanese or Chinese (アカスリ, ヘッドスパ, マッサージ, 搓澡, 头皮护理, 按摩…). Leave empty to search all categories."New value: +"Service (optional; overrides a service found in query). Available on TimePlex now: massage, head spa / scalp treatment, hair salon, spa, Korean body scrub (seshin, akasuri), makeup, semi-permanent makeup (PMU, microblading, brow tattoo) — in English, Korean, Japanese or Chinese (マッサージ, ヘッドスパ, アカスリ, 按摩, 搓澡…). Other services (nail, lash, facial, personal color) are recognized but may return unsupported_service. Leave empty to search all."

Added value: +{
+  "description": "How the request was read: service (massage|headspa|hair|spa|scrub|makeup|…), area, foreigner_friendly, date (YYYY-MM-DD, KST), time, time_range, time_of_day, party_size, gender, attributes, name_query (leftover words treated as a shop name), ignored_terms. Use date/time/party_size for search_availability (party_size → qty).",
+  "type": "object"
+}

Added value: +{
+  "description": "Set when no shop was in the requested area and the search widened: {area:{from,to}}.",
+  "type": [
+    "object",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Present when the shop matched through its menu: the menu items (original names) that matched the request. Pick the service from these in get_shop_services.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "A recognized service that is not on TimePlex yet (e.g. nail, lash, facial, personal_color).",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Customer language (optional): ko|en|ja|zh. Defaults to en. Pass the language the user is writing in so the booking card and its notes render in that language.",
+  "type": "string"
+}

Added value: +{
+  "description": "Language the card content is rendered in (echo of input lang; en fallback). The widget uses it to localize its own labels.",
+  "type": "string"
+}

Added value: +"Filter code. Use business_type_label when naming the shop to the user."

Added value: +{
+  "description": "Display label the shop selected (spa = 스파·헤드스파 / spa & head spa). null when unset.",
+  "properties": {
+    "en": {
+      "type": "string"
+    },
+    "ko": {
+      "type": "string"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

Previous value: -"Shop category (optional). Accepts broad categories (\"hair\", \"beauty\") and specific ones (\"massage\", \"spa\", \"head spa\", \"nail\", \"skincare\", \"facial\", \"esthetic\", \"waxing\", \"scrub\"), in English or Korean. Leave empty to search all categories."New value: +"Shop category (optional). Accepts broad categories (\"hair\", \"beauty\") and specific ones (\"massage\", \"spa\", \"head spa\", \"nail\", \"skincare\", \"facial\", \"esthetic\", \"waxing\", \"scrub\"), in English, Korean, Japanese or Chinese (アカスリ, ヘッドスパ, マッサージ, 搓澡, 头皮护理, 按摩…). Leave empty to search all categories."

Added value: +{
+  "description": "Services this staff/seat handles. Empty = handles every service. Pass this resource only for a service in this list.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +"Weekly hours, index 0 = Sunday: [{open:\"10:30\", close:\"21:00\", closed:false} × 7]"

Added value: +{
+  "properties": {
+    "close": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "closed": {
+      "description": "true = closed that weekday",
+      "type": "boolean"
+    },
+    "open": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

Previous value: -[
-  "object",
-  "null"
-]New value: +[
+  "array",
+  "null"
+]

Added value: +{
+  "description": "Set when the user named a specific shop that is not registered on Timeplex. Tell the user that shop is not on Timeplex — do not treat it as a category with zero results, and do not submit it with request_booking.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "How this shop books: 'designated' — pass items as [{service_id, resource_id}]; 'capacity' — pass items as [{service_id, qty}]. Use this for search_availability and start_booking.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"Staff (hair) or seats (massage)."New value: +"Staff to designate (designated-staff shops) or seats (capacity-based shops)."

Previous value: -"Booking items. Hair: [{service_id, resource_id}]. Massage: [{service_id, qty}] (qty = number of people)."New value: +"Booking items. Follow the booking_model returned by get_shop_services: use resource_id for designated-staff shops and qty for capacity-based shops. designated (hair salons, plus some beauty shops such as body scrub): [{service_id, resource_id}]. capacity (most massage, spa, etc.): [{service_id, qty}] where qty is the number of people."

Added value: +"Shop slug returned by search_shops."

Previous value: -"HH:MM (optional) — judge whether this exact time is bookable"New value: +"Optional requested appointment time (HH:MM). If provided, check whether that exact time is available and return nearby available alternatives if unavailable."

Previous value: -"Shop name, partial match (optional). If no name matches, it is also interpreted as a shop category."New value: +"Shop name, service, or natural-language search term (optional). If no shop name matches, it is also interpreted as a service/category search."

Previous value: -"Shop category (optional). Accepts broad categories (\"hair\", \"beauty\") and specific ones (\"massage\", \"spa\", \"head spa\", \"nail\", \"skin care\", \"esthetic\", \"waxing\", \"scrub\"), in English or Korean. Leave empty to search all categories."New value: +"Shop category (optional). Accepts broad categories (\"hair\", \"beauty\") and specific ones (\"massage\", \"spa\", \"head spa\", \"nail\", \"skincare\", \"facial\", \"esthetic\", \"waxing\", \"scrub\"), in English or Korean. Leave empty to search all categories."

Added value: +"null = newly joined shop that has not registered an address yet"

Added value: +{
+  "description": "Present only when a location filter was applied: true = address matched the area; false = no address registered yet (newly onboarding) — confirm the area with the shop",
+  "type": "boolean"
+}

Previous value: -"Optional — omit if no service is chosen yet. Hair: [{service_id, resource_id}] — **exactly one** (hair shops book one service at a time). Massage: [{service_id, qty}] — multiple allowed (several services and several people at once)."New value: +"Optional — omit if no service is chosen yet. Follow the booking_model returned by get_shop_services: use resource_id for designated-staff shops and qty for capacity-based shops. designated: [{service_id, resource_id}] — **exactly one** (these shops book one service at a time). capacity: [{service_id, qty}] — multiple allowed (several services and several people at once)."

Added value: +"Shop slug returned by search_shops."

Added value: +"Customer-facing summary of the remaining steps — keep it light and pass it on"

Added value: +"What the customer does after opening the link (contact info, payment, shop-owner approval)"

Added value: +"How the slot is secured and finally confirmed — mention this to the customer"

Previous value: -nullNew value: +{
+  "properties": {
+    "bookings": {
+      "items": {
+        "properties": {
+          "service": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "staff": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "status": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "when": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "cancel": {
+      "description": "Whether cancellation is possible and the refund terms",
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "payment": {
+      "description": "Payment status summary (no card data)",
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "phase": {
+      "description": "Overall reservation phase",
+      "type": "string"
+    },
+    "reservation_no": {
+      "type": "string"
+    },
+    "shop": {
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "slug": {
+          "type": "string"
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "status_url": {
+      "description": "Customer-facing status page (cancelling happens there, not via MCP)",
+      "type": "string"
+    },
+    "totals": {
+      "type": [
+        "object",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "status_url"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "properties": {
+    "lang": {
+      "type": "string"
+    },
+    "note": {
+      "type": "string"
+    },
+    "resources": {
+      "description": "Staff (hair) or seats (massage).",
+      "items": {
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "services": {
+      "items": {
+        "properties": {
+          "currency": {
+            "type": "string"
+          },
+          "duration_min": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "id": {
+            "description": "Pass as items[].service_id to search_availability / start_booking",
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "price": {
+            "type": [
+              "number",
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "shop": {
+      "properties": {
+        "address": {
+          "type": "string"
+        },
+        "business_hours": {
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "business_type": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "map_url": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "slug": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "required": [
+    "shop",
+    "services"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "properties": {
+    "instruction": {
+      "type": "string"
+    },
+    "link_label": {
+      "type": "string"
+    },
+    "link_markdown": {
+      "description": "Put this into the reply as-is (never expose the raw URL)",
+      "type": "string"
+    },
+    "next_step_url": {
+      "description": "Concierge chat where the customer completes the request",
+      "type": "string"
+    },
+    "recorded": {
+      "description": "true — the demand was logged",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "recorded",
+    "next_step_url"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "properties": {
+    "alternatives": {
+      "description": "Nearby bookable times when the requested time is not available",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "blocked": {
+      "description": "Present when online booking is blocked (e.g. 'inquiry_only')",
+      "type": "string"
+    },
+    "date": {
+      "type": "string"
+    },
+    "mode": {
+      "description": "Slot mode the shop operates in",
+      "type": "string"
+    },
+    "next_step": {
+      "type": "string"
+    },
+    "note": {
+      "type": "string"
+    },
+    "requested_time": {
+      "description": "Verdict for the exact time asked, when time was given.",
+      "properties": {
+        "available": {
+          "type": "boolean"
+        },
+        "time": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "slots": {
+      "items": {
+        "properties": {
+          "available": {
+            "type": "boolean"
+          },
+          "time": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "timezone": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "date",
+    "slots"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "properties": {
+    "available_service_types": {
+      "description": "business_type values currently registered",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "categories": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "count": {
+      "type": "integer"
+    },
+    "filter_applied": {
+      "description": "How the inputs were interpreted (category/service_type/location/query)",
+      "type": "object"
+    },
+    "note": {
+      "description": "Follow-up guidance for the agent",
+      "type": "string"
+    },
+    "reply_header": {
+      "type": "string"
+    },
+    "reply_header_usage": {
+      "type": "string"
+    },
+    "shops": {
+      "description": "Matching shops.",
+      "items": {
+        "properties": {
+          "address": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "bookable": {
+            "description": "true = bookable via this MCP; false = use request_booking",
+            "type": "boolean"
+          },
+          "business_type": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "category": {
+            "enum": [
+              "hair",
+              "beauty"
+            ],
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "slug": {
+            "description": "Shop id for the other tools",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "shops",
+    "count"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "properties": {
+    "booking_url": {
+      "description": "Prefilled booking page (customer completes contact info + payment there)",
+      "type": "string"
+    },
+    "confirmed": {
+      "description": "Always false — nothing is booked by this tool",
+      "type": "boolean"
+    },
+    "guidance": {
+      "type": "string"
+    },
+    "link_label": {
+      "type": "string"
+    },
+    "link_markdown": {
+      "description": "Put this into the reply as-is (never expose the raw URL)",
+      "type": "string"
+    },
+    "next_steps": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "note": {
+      "type": "string"
+    },
+    "reply_header": {
+      "type": "string"
+    },
+    "reply_header_usage": {
+      "type": "string"
+    },
+    "summary": {
+      "description": "What is preselected on the booking page.",
+      "properties": {
+        "currency": {
+          "type": "string"
+        },
+        "items": {
+          "items": {
+            "properties": {
+              "currency": {
+                "type": "string"
+              },
+              "duration_min": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "price": {
+                "type": [
+                  "number",
+                  "string",
+                  "null"
+                ]
+              },
+              "qty": {
+                "type": "integer"
+              },
+              "service": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "staff": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "shop": {
+          "type": "string"
+        },
+        "timezone": {
+          "type": "string"
+        },
+        "total_price": {
+          "type": "number"
+        },
+        "when": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    }
+  },
+  "required": [
+    "booking_url",
+    "link_markdown",
+    "confirmed"
+  ],
+  "type": "object"
+}