gaplessly-booking

endpoint

https://gaplessly.com/api/mcp

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is gaplessly-booking live?

Yes — it answered the hub's last check (checked 56m ago). It answered 99% of checks over the last 30 days.

Is gaplessly-booking free to use?

Yes — the hub reached it with no key and no payment.

What tools does gaplessly-booking have?

6 tools: start_table_booking, get_venue, find_venues, find_table_times, find_appointment_times, start_appointment_booking.

Is gaplessly-booking safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

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.

• start_table_booking reads unknown never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627

  {
    "type": "object",
    "required": [
      "slotToken",
      "partySize"
    ],
    "properties": {
      "slug": {
        "type": "string",
        "description": "The venue's booking slug, exactly as find_venues or get_venue returned it or as it appears in the venue's own booking link: the last path segment of gaplessly.com/book/<slug>, or the first label of <slug>.gaplessly.com. Not the business name; use find_venues to turn a name into a slug."
      },
      "venue": {
        "type": "string",
        "description": "Alias of `slug`, kept for existing clients. Send `slug`."
      },
      "partySize": {
        "type": "integer",
        "minimum": 1,
        "description": "The same party size passed to find_table_times. The link opens on it."
      },
      "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."
      }
    },
    "additionalProperties": false
  }

  arguments 27 lines copy
• get_venue reads unknown 23h ago

  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 once you have a slug (find_venues turns a name or suburb into one): the other tools need it, and appointment searches need a service id from here. A detail the business has not entered (industry, address, phone) is left out and listed under `notProvided`; do not guess it. For a restaurant with an online party limit, `groupEnquiry` is where a larger party goes. 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.

  mcp-tool

  1234567891011121314

  {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "The venue's booking slug, exactly as find_venues or get_venue returned it or as it appears in the venue's own booking link: the last path segment of gaplessly.com/book/<slug>, or the first label of <slug>.gaplessly.com. Not the business name; use find_venues to turn a name into a slug."
      },
      "venue": {
        "type": "string",
        "description": "Alias of `slug`, kept for existing clients. Send `slug`."
      }
    },
    "additionalProperties": false
  }

  arguments 14 lines copy
• find_venues unknown 23h ago

  Search the businesses that take bookings through Gaplessly by name, by suburb or postcode, or by kind, and get back each one's slug, name, kind, address and booking page link. Use this when the guest names a business or an area but you do not have a slug; every other tool needs one. Send at least one of `name`, `location` or `kind`. Only real businesses that have chosen to be found by assistants are searchable here, so an empty result means "not found here", not that the business does not exist or cannot be booked: ask the guest for its booking link, which works with every other tool. Then call get_venue with the slug.

  mcp-tool

  12345678910111213141516171819202122232425262728

  {
    "type": "object",
    "properties": {
      "kind": {
        "enum": [
          "appointments",
          "hospitality"
        ],
        "type": "string",
        "description": "appointments for salons, clinics and studios; hospitality for restaurants, cafes and bars."
      },
      "name": {
        "type": "string",
        "description": "Part of the business name, for example \"Saltline\". Case does not matter."
      },
      "limit": {
        "type": "integer",
        "maximum": 10,
        "minimum": 1,
        "description": "How many venues to return, 1 to 10. Defaults to 5."
      },
      "location": {
        "type": "string",
        "description": "A suburb, city or postcode, matched against the venue address, for example \"Newtown\" or \"2042\"."
      }
    },
    "additionalProperties": false
  }

  arguments 28 lines copy
• find_table_times reads unknown 23h ago

  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. Each day lists at most 10 times unless `maxPerDay` says otherwise, spread across the day; `omitted` says how many more exist. To answer "around 7pm" or "lunch", send `near`, `partOfDay`, `notBefore` or `notAfter`. A party above the venue's online limit gets no times: the result carries `groupEnquiry` (a link and any contact details the venue published) to give the guest instead.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859

  {
    "type": "object",
    "required": [
      "partySize"
    ],
    "properties": {
      "days": {
        "type": "integer",
        "maximum": 14,
        "minimum": 1,
        "description": "How many consecutive days to search from that day, 1 to 14. Defaults to 3."
      },
      "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."
      },
      "near": {
        "type": "string",
        "description": "A 24 hour time as HH:MM, for example 19:00 for 7pm. When a day has more times than maxPerDay, keep the ones closest to this."
      },
      "slug": {
        "type": "string",
        "description": "The venue's booking slug, exactly as find_venues or get_venue returned it or as it appears in the venue's own booking link: the last path segment of gaplessly.com/book/<slug>, or the first label of <slug>.gaplessly.com. Not the business name; use find_venues to turn a name into a slug."
      },
      "venue": {
        "type": "string",
        "description": "Alias of `slug`, kept for existing clients. Send `slug`."
      },
      "notAfter": {
        "type": "string",
        "description": "Drop times later than this 24 hour HH:MM."
      },
      "maxPerDay": {
        "type": "integer",
        "maximum": 40,
        "minimum": 1,
        "description": "Most times to return per day, 1 to 40. Defaults to 10. Past it, the times are spread across the day (or nearest `near`) and `omitted` says how many were left out."
      },
      "notBefore": {
        "type": "string",
        "description": "Drop times earlier than this 24 hour HH:MM."
      },
      "partOfDay": {
        "enum": [
          "morning",
          "afternoon",
          "evening"
        ],
        "type": "string",
        "description": "Only times in this part of the day: morning (before 12:00), afternoon (12:00 to 16:59), evening (17:00 on)."
      },
      "partySize": {
        "type": "integer",
        "minimum": 1,
        "description": "How many people are coming, including the person booking."
      }
    },
    "additionalProperties": false
  }

  arguments 59 lines copy
• find_appointment_times reads unknown 23h ago

  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. Each day lists at most 10 times unless `maxPerDay` says otherwise, spread across the day; `omitted` says how many more exist. To answer "around 6pm" or "afternoons", send `near`, `partOfDay`, `notBefore` or `notAfter` instead of asking for everything.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758

  {
    "type": "object",
    "required": [
      "serviceId"
    ],
    "properties": {
      "days": {
        "type": "integer",
        "maximum": 14,
        "minimum": 1,
        "description": "How many consecutive days to search from that day, 1 to 14. Defaults to 3."
      },
      "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."
      },
      "near": {
        "type": "string",
        "description": "A 24 hour time as HH:MM, for example 19:00 for 7pm. When a day has more times than maxPerDay, keep the ones closest to this."
      },
      "slug": {
        "type": "string",
        "description": "The venue's booking slug, exactly as find_venues or get_venue returned it or as it appears in the venue's own booking link: the last path segment of gaplessly.com/book/<slug>, or the first label of <slug>.gaplessly.com. Not the business name; use find_venues to turn a name into a slug."
      },
      "venue": {
        "type": "string",
        "description": "Alias of `slug`, kept for existing clients. Send `slug`."
      },
      "notAfter": {
        "type": "string",
        "description": "Drop times later than this 24 hour HH:MM."
      },
      "maxPerDay": {
        "type": "integer",
        "maximum": 40,
        "minimum": 1,
        "description": "Most times to return per day, 1 to 40. Defaults to 10. Past it, the times are spread across the day (or nearest `near`) and `omitted` says how many were left out."
      },
      "notBefore": {
        "type": "string",
        "description": "Drop times earlier than this 24 hour HH:MM."
      },
      "partOfDay": {
        "enum": [
          "morning",
          "afternoon",
          "evening"
        ],
        "type": "string",
        "description": "Only times in this part of the day: morning (before 12:00), afternoon (12:00 to 16:59), evening (17:00 on)."
      },
      "serviceId": {
        "type": "string",
        "description": "One service id from this venue's get_venue result. Not a service name."
      }
    },
    "additionalProperties": false
  }

  arguments 58 lines copy
• start_appointment_booking reads unknown never probed

  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.

  mcp-tool

  1234567891011121314151617181920212223242526

  {
    "type": "object",
    "required": [
      "slotToken",
      "serviceId"
    ],
    "properties": {
      "slug": {
        "type": "string",
        "description": "The venue's booking slug, exactly as find_venues or get_venue returned it or as it appears in the venue's own booking link: the last path segment of gaplessly.com/book/<slug>, or the first label of <slug>.gaplessly.com. Not the business name; use find_venues to turn a name into a slug."
      },
      "venue": {
        "type": "string",
        "description": "Alias of `slug`, kept for existing clients. Send `slug`."
      },
      "serviceId": {
        "type": "string",
        "description": "The same service id passed to find_appointment_times, from get_venue. The link opens on this service."
      },
      "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."
      }
    },
    "additionalProperties": false
  }

  arguments 26 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.