Timeplex K-Beauty Booking MCP Server

Check real-time appointment availability and available time slots for a Korean beauty or wellness shop. Use this tool when a user asks whether a specific date or time is available, wants to find an available appointment slot, or asks for alternatives when a preferred time is unavailable. Returns available times and nearby alternatives when the requested time is unavailable. All times are in Korea Standard Time (KST).

Use this tool only for a shop that is already in the Timeplex catalog but cannot be booked online yet: a search_shops result with bookable=false, or a newly joined shop whose menu is not registered yet (get_shop_services says so). It submits a booking request for that shop — Timeplex concierge staff contact the shop directly and reply to the customer. Share the returned link with the user. Do not use this tool for a shop name that search_shops could not find (shop_name_not_found), and not for generic searches with no matching results — in both cases tell the user it is not on Timeplex instead. For bookable shops use get_shop_services -> search_availability -> start_booking instead.

Get the available services, prices, durations, and bookable staff or resources for a specific Korean beauty or wellness shop. Use this after finding a shop when service details, prices, durations, staff, or resources are needed before checking appointment availability. Pass lang to receive the content translated into the customer's language.

Search Korean beauty and wellness shops by shop name, service type, or location. Use this tool when a user wants to find a beauty salon, hair salon, nail salon, skincare or facial shop, spa, massage shop, or other K-beauty business in Korea, including requests for appointment or booking options. Results indicate whether each shop is bookable through Timeplex: bookable=true means real-time availability can be checked and the customer can proceed to booking through this MCP; bookable=false means it needs request_booking (Timeplex concierge arranges it manually). Shops fall into two categories: hair (hair salons) and beauty (everything else — massage, spa, nail, skincare, facial, waxing, scrub, etc.). Each shop result carries its category. If the user named a specific shop that is not registered, the response sets shop_name_not_found — tell the user that shop is not on Timeplex and offer the registered shops in the result as alternatives. Each result carries the shop address, so you can answer area questions ("shops in Seoul") without extra calls. Always reply to the user in the language they used, and start the reply with the response's reply_header line.

Build a booking link when the user wants to book, continue a booking, or has asked to check availability for a specific venue or service. Do not call this tool for informational requests such as viewing a venue's menu, prices, service duration, address, or business hours. If the user has booking intent but has not selected a date or time yet, a venue-level booking link may be created. This tool does not create or confirm a booking. Put **link_markdown into your reply as-is** — never expose the raw URL. The slot is not secured until the customer completes payment, and the booking is only finally confirmed after the shop approves — never imply it is already secured or complete. When a booking link is warranted, do not ask "shall I create a link?" first — create it and include the link in your reply. Pass lang — the language the user is writing in (ko|en|ja|zh) — so the booking card and its notes render in that language. Always reply in the language the user used.