Gaplessly Booking

Read a venue's public booking profile: what it is, where it is, what can be booked, and what time it is THERE right now. Call this first: the other tools need this venue's slug, and appointment searches need a service id from here. Returns `venueClock`, which is the venue's own current date and time. Every date you ask for later is resolved against `venueClock.today`, not against your own today: the two are routinely different days. Times are given as text on purpose and there is no timezone identifier anywhere in the result, because converting them is how a booking ends up hours off.

{
  "type": "object",
  "properties": {
    "venue": {
      "type": "string",
      "description": "The venue's booking slug, exactly as get_venue returned it or as it appears in the venue's own booking link (the last path segment of gaplessly.com/book/<slug>). Not the business name."
    }
  },
  "required": [
    "venue"
  ],
  "additionalProperties": false
}

Free appointment times at one venue for one service, over up to two weeks. For salons, clinics, studios and anywhere a guest books a named service with a provider. Use find_table_times for a restaurant instead. Needs a service id from get_venue. Each returned time has an `at` label to show the guest and a `slotToken`. The token is the booking handle: it is signed, it expires in about 30 minutes, and it is the only way a time can be booked later. Pass it back exactly as given, never edited, and never reuse one from a different venue. An empty `times` array for a day means that day is genuinely unavailable, not that something failed.

{
  "type": "object",
  "properties": {
    "venue": {
      "type": "string",
      "description": "The venue's booking slug, exactly as get_venue returned it or as it appears in the venue's own booking link (the last path segment of gaplessly.com/book/<slug>). Not the business name."
    },
    "serviceId": {
      "type": "string",
      "description": "One service id from this venue's get_venue result. Not a service name."
    },
    "from": {
      "type": "string",
      "description": "Which day to start from: the word \"today\", the word \"tomorrow\", or an exact calendar date as YYYY-MM-DD. Resolved against the venue's own current date, which is often not yours. Do not send a phrase like \"next Tuesday\" or a time of day; both are rejected."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 14,
      "description": "How many consecutive days to search from that day, 1 to 14. Defaults to 7."
    }
  },
  "required": [
    "venue",
    "serviceId"
  ],
  "additionalProperties": false
}

Free table times at one restaurant or venue for one party size, over up to two weeks. Use find_appointment_times for a salon or clinic instead. Each returned time has an `at` label to show the guest and a `slotToken`. The token is the booking handle: it is signed, it expires in about 30 minutes, and it is the only way a time can be booked later. Pass it back exactly as given, never edited, and never reuse one from a different venue. An empty `times` array for a day means the venue has nothing at that party size that day, which usually means closed or fully booked; for a large party the venue may take it by phone even when nothing shows here.

{
  "type": "object",
  "properties": {
    "venue": {
      "type": "string",
      "description": "The venue's booking slug, exactly as get_venue returned it or as it appears in the venue's own booking link (the last path segment of gaplessly.com/book/<slug>). Not the business name."
    },
    "partySize": {
      "type": "integer",
      "minimum": 1,
      "description": "How many people are coming, including the person booking."
    },
    "from": {
      "type": "string",
      "description": "Which day to start from: the word \"today\", the word \"tomorrow\", or an exact calendar date as YYYY-MM-DD. Resolved against the venue's own current date, which is often not yours. Do not send a phrase like \"next Tuesday\" or a time of day; both are rejected."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 14,
      "description": "How many consecutive days to search from that day, 1 to 14. Defaults to 7."
    }
  },
  "required": [
    "venue",
    "partySize"
  ],
  "additionalProperties": false
}

Turn a time from find_appointment_times into a link the guest taps to finish booking. This does NOT book anything: it returns a short-lived URL on the venue's own booking page, already opened at that service, that staff member and that exact time, where the guest enters their own name, email and phone and confirms. Give the guest the `url` and say plainly that the booking is not made until they open it. Never ask the guest for their contact details to pass here; this tool does not take them, and the page collects them directly. Nothing is reserved in the meantime, so a popular time can still go before they tap.

{
  "type": "object",
  "properties": {
    "venue": {
      "type": "string",
      "description": "The venue's booking slug, exactly as get_venue returned it or as it appears in the venue's own booking link (the last path segment of gaplessly.com/book/<slug>). Not the business name."
    },
    "slotToken": {
      "type": "string",
      "description": "A `slotToken` from find_appointment_times or find_table_times, copied exactly. It is signed and carries the venue and the time inside the signature, so it cannot be edited, built by hand, or used at a different venue. It expires about 30 minutes after the search."
    },
    "serviceId": {
      "type": "string",
      "description": "The same service id passed to find_appointment_times, from get_venue. The link opens on this service."
    }
  },
  "required": [
    "venue",
    "slotToken",
    "serviceId"
  ],
  "additionalProperties": false
}

Turn a time from find_table_times into a link the guest taps to finish booking. This does NOT book anything: it returns a short-lived URL on the venue's own booking page, already opened at that party size and that exact sitting, where the guest enters their own details and confirms. The venue holds the table from the moment the guest opens the link, for about ten minutes, which is what gives them time to fill the form in. Until they open it nothing is held, so give them the `url` promptly and say the table is not theirs until they do.

{
  "type": "object",
  "properties": {
    "venue": {
      "type": "string",
      "description": "The venue's booking slug, exactly as get_venue returned it or as it appears in the venue's own booking link (the last path segment of gaplessly.com/book/<slug>). Not the business name."
    },
    "slotToken": {
      "type": "string",
      "description": "A `slotToken` from find_appointment_times or find_table_times, copied exactly. It is signed and carries the venue and the time inside the signature, so it cannot be edited, built by hand, or used at a different venue. It expires about 30 minutes after the search."
    },
    "partySize": {
      "type": "integer",
      "minimum": 1,
      "description": "The same party size passed to find_table_times. The link opens on it."
    }
  },
  "required": [
    "venue",
    "slotToken",
    "partySize"
  ],
  "additionalProperties": false
}