timeplex-booking

endpoint

https://chat.timeplex.ai/mcp

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing

karma

0 · newcomer

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• search_shops open 1h ago

  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.

  mcp-tool

  123456789101112131415161718

  {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Shop name, service, or natural-language search term (optional). If no shop name matches, it is also interpreted as a service/category search."
      },
      "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."
      },
      "service_type": {
        "type": "string",
        "description": "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."
      }
    },
    "additionalProperties": false
  }

  arguments 18 lines copy
• get_shop_services unknown never probed

  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.

  mcp-tool

  1234567891011121314151617

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

  arguments 17 lines copy
• search_availability unknown never probed

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

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142

  {
    "type": "object",
    "required": [
      "slug",
      "date",
      "items"
    ],
    "properties": {
      "date": {
        "type": "string",
        "description": "YYYY-MM-DD (Asia/Seoul)"
      },
      "slug": {
        "type": "string",
        "description": "Shop slug returned by search_shops."
      },
      "time": {
        "type": "string",
        "description": "Optional requested appointment time (HH:MM). If provided, check whether that exact time is available and return nearby available alternatives if unavailable."
      },
      "items": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "qty": {
              "type": "integer"
            },
            "service_id": {
              "type": "string"
            },
            "resource_id": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "description": "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."
      }
    },
    "additionalProperties": false
  }

  arguments 42 lines copy
• request_booking unknown never probed

  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.

  mcp-tool

  12345678910111213141516171819

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

  arguments 19 lines copy
• start_booking unknown never probed

  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.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344

  {
    "type": "object",
    "required": [
      "slug"
    ],
    "properties": {
      "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."
      },
      "lang": {
        "type": "string",
        "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."
      },
      "slug": {
        "type": "string",
        "description": "Shop slug returned by search_shops."
      },
      "time": {
        "type": "string",
        "description": "HH:MM. Optional — omit if the customer has not picked a time."
      },
      "items": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "qty": {
              "type": "integer"
            },
            "service_id": {
              "type": "string"
            },
            "resource_id": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "description": "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)."
      }
    },
    "additionalProperties": false
  }

  arguments 44 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.