Timeplex K-Beauty Booking

Official6 tools

by timeplex

Real-time booking for Korean beauty & wellness shops — search availability, get a booking link.

MCP Server: ai.timeplex/booking

The ai.timeplex/booking MCP server (slug: ai-timeplex-booking) provides real-time booking for Korean beauty & wellness shops. It supports operations to search availability and get a booking link, using a total of 6 tools exposed by the server.

🛠️ Key Features

Real-time booking workflows for Korean beauty & wellness shops
Search availability
Retrieve a booking link
6 tools exposed by the MCP server

🚀 Use Cases

Find open appointment times at Korean beauty & wellness shops
Obtain booking links for confirmed availability

⚡ Developer Benefits

Tool-driven access to availability search
Programmatic booking-link retrieval
Clear, limited tool set (6 tools) for focused integration

⚠️ Limitations

Scope described is limited to Korean beauty & wellness shops
No additional details beyond availability search and booking-link retrieval were provided

Captured live from the server via tools/list.

search_shops

Find Korean beauty & wellness shops on Timeplex. bookable=true means you can check availability and book through this MCP; 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, skin care, waxing, scrub, etc.). Each shop result carries its category. 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.

Parameters3

query	string	optional	Shop name, partial match (optional). If no name matches, it is also interpreted as a shop category.
service_type	string	optional	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.
location	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Shop name, partial match (optional). If no name matches, it is also interpreted as a shop category."
    },
    "service_type": {
      "type": "string",
      "description": "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."
    },
    "location": {
      "type": "string",
      "description": "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."
    }
  },
  "additionalProperties": false
}

get_shop_services

Get a shop's service menu (name, price, duration) and its staff/seats. Pass lang to receive the content translated into the customer's language.

Parameters2

slug	string	required	Shop slug returned by search_shops
lang	string	optional	Customer language (optional): ko\|en\|ja\|zh\|th. Defaults to the original text (ko).

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Shop slug returned by search_shops"
    },
    "lang": {
      "type": "string",
      "description": "Customer language (optional): ko|en|ja|zh|th. Defaults to the original text (ko)."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

search_availability

Check available time slots for a date. If time is given, it also judges whether that exact slot is bookable and returns nearby alternatives when it is not.

Parameters4

slug	string	required
date	string	required	YYYY-MM-DD (Asia/Seoul)
items	array	required	Booking items. Hair: [{service_id, resource_id}]. Massage: [{service_id, qty}] (qty = number of people).
time	string	optional	HH:MM (optional) — judge whether this exact time is bookable

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD (Asia/Seoul)"
    },
    "items": {
      "type": "array",
      "description": "Booking items. Hair: [{service_id, resource_id}]. Massage: [{service_id, qty}] (qty = number of people).",
      "items": {
        "type": "object",
        "properties": {
          "service_id": {
            "type": "string"
          },
          "resource_id": {
            "type": "string"
          },
          "qty": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      }
    },
    "time": {
      "type": "string",
      "description": "HH:MM (optional) — judge whether this exact time is bookable"
    }
  },
  "required": [
    "slug",
    "date",
    "items"
  ],
  "additionalProperties": false
}

request_booking

Submit a booking request for a shop that is not onboarded to Timeplex yet (bookable=false). Timeplex concierge staff contact the shop directly and reply to the customer. Share the returned link with the user.

Parameters2

venue_name	string	required	Name of the shop the customer wants to book
lang	string	optional	Customer language (optional)

Raw schema

{
  "type": "object",
  "properties": {
    "venue_name": {
      "type": "string",
      "description": "Name of the shop the customer wants to book",
      "maxLength": 255
    },
    "lang": {
      "type": "string",
      "description": "Customer language (optional)",
      "maxLength": 10
    }
  },
  "required": [
    "venue_name"
  ],
  "additionalProperties": false
}

start_booking

Build a link that lets the customer continue the booking for the chosen shop, service and time. **This creates and changes nothing — it only builds a link.** So never ask "shall I create a link?"; once a shop is known, call it right away and include the link in your reply. date, time and items are all optional — **if the customer has not picked a date or time yet, still call it with just the shop** and hand over the link; they pick the rest on the booking page. Never withhold the link to ask for a date first. It books nothing — the customer must open the link, enter email, name and phone, and pay. Payment submits the booking and secures the slot; the **final confirmation comes from the shop owner** afterwards. Put **link_markdown into your reply as-is** — never expose the raw URL. Pass on guidance, and mention that the slot is not held until payment (whoever pays first gets it) and that the shop owner confirms it after that. Describe the remaining steps only as "just enter your email, name and phone, then pay" — keep it light, and always write your reply in the language the user used, starting with the response's reply_header line.

Parameters4

slug	string	required
date	string	optional	YYYY-MM-DD (Asia/Seoul). Optional — omit if the customer has not picked a date; they choose it on the booking page.
time	string	optional	HH:MM. Optional — omit if the customer has not picked a time.
items	array	optional	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).

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD (Asia/Seoul). Optional — omit if the customer has not picked a date; they choose it on the booking page."
    },
    "time": {
      "type": "string",
      "description": "HH:MM. Optional — omit if the customer has not picked a time."
    },
    "items": {
      "type": "array",
      "description": "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).",
      "items": {
        "type": "object",
        "properties": {
          "service_id": {
            "type": "string"
          },
          "resource_id": {
            "type": "string"
          },
          "qty": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      }
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

get_booking_status

Look up booking and payment status by reservation number, including whether it can be cancelled and the refund terms. To actually cancel, hand the customer the status_url from the response — cancelling is done there, not through this MCP. Reply in the user's language.

Parameters1

res_no

string

required

Reservation number

Raw schema

{
  "type": "object",
  "properties": {
    "res_no": {
      "type": "string",
      "description": "Reservation number"
    }
  },
  "required": [
    "res_no"
  ],
  "additionalProperties": false
}

Install

Tools (6)

search_shopsget_shop_servicessearch_availabilityrequest_bookingstart_bookingget_booking_status

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://chat.timeplex.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "booking": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://chat.timeplex.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: ai.timeplex/booking

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_shops

get_shop_services

search_availability

request_booking

start_booking

get_booking_status

Install

Remote endpoint

Related servers