ai.timeplex/booking

Tools

• get_shop_services

  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.

  shallow
• request_booking

  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.

  shallow
• search_availability

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

  shallow
• search_shops

  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.

  shallow
• start_booking

  Create a pre-filled Timeplex booking link (and booking card) for a selected Korean beauty or wellness shop and appointment. Use this after the user has selected or clearly identified a specific shop. A bare category request with no shop chosen and no area or date given ("recommend a scrub shop") is NOT a selection — ask for the area and the booking conditions first instead of calling this tool. **This tool does not create or confirm a reservation — it only generates a booking link.** Never ask "shall I create a link?". Once a specific shop has been selected or clearly identified, call this tool and include the link in your reply. Date, time and items are all optional — **if the customer has not picked them yet, still call it with just the shop**; they choose the rest on the booking page. Never withhold the link just to ask for a date, time, or service first. Put **link_markdown into your reply as-is** — never expose the raw URL. Briefly relay the returned guidance and note to the customer, always in the language the user used, starting with the response's reply_header line.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/b223fdd0-78c1-4e89-ad95-ce8297dd26d9/badge.svg)](https://vouch.tools/servers/b223fdd0-78c1-4e89-ad95-ce8297dd26d9)