Gaplessly MCP server

An AI assistant connected to this server can look up any business that takes bookings through Gaplessly and, where the business's plan includes AI booking, find its free appointment and table times and hand the guest a link to finish the booking themselves. Other businesses answer with their own booking page. It is one public endpoint for the whole platform, read-only, with no API key.

https://gaplessly.com/api/mcp

Streamable HTTP, JSON-RPC 2.0, stateless. Listed in the official MCP Registry as com.gaplessly/booking. This repository documents the hosted server; there is nothing to install or run.

Connect

Claude Code

claude mcp add --transport http gaplessly https://gaplessly.com/api/mcp

Claude (web and desktop): Customize, Connectors, then the + button. Name it Gaplessly, paste https://gaplessly.com/api/mcp, and click Add.

Cursor, in .cursor/mcp.json:

{
  "mcpServers": {
    "gaplessly": { "url": "https://gaplessly.com/api/mcp" }
  }
}

VS Code, in .vscode/mcp.json:

{
  "servers": {
    "gaplessly": { "type": "http", "url": "https://gaplessly.com/api/mcp" }
  }
}

Any other client that speaks streamable HTTP takes the same URL.

Tools

Tool	What it does
find_venues	Search the businesses that have chosen to be found by assistants, by name, suburb or postcode, or kind, and get back each one's slug and booking page. Use it when the guest names a business but you have no slug.
get_venue	A venue's public booking profile: what it is, where, what can be booked, and the venue's own current time. Call this once you have a slug. Takes slug (or venue, the same thing).
find_appointment_times	Free times at one venue for one service, over up to two weeks. For salons, clinics and studios.
find_table_times	Free times at one restaurant or venue for one party size, over up to two weeks.
start_appointment_booking	Turns a chosen appointment time into a link the guest opens to finish booking.
start_table_booking	Turns a chosen table time into a link the guest opens to finish booking.

get_venue answers for every business. find_venues only lists businesses that opted in to being found; an empty result means "not found here", and a booking link from the guest works with every other tool.

The two time searches take partOfDay, near, notBefore, notAfter and maxPerDay to narrow a day (each day lists at most 10 times by default, and omitted says how many more exist). A restaurant party above the venue's online limit gets no times but a groupEnquiry link and contact details to give the guest.

The two time searches and the two start_ tools need the business's plan to include AI booking; for any other business they return its booking page and liveTimes: false instead of times.

Every tool is read-only, including the two named start_: they return a link and write nothing. Ask the server itself for the authoritative definitions:

curl -s https://gaplessly.com/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Why nothing here books

An assistant cannot prove who it is speaking for, so a connector that booked outright would be booking for whoever the model says, on details the model typed. The last step is a link on the venue's own booking page, where the guest enters their own name, email and phone, and where deposits and a venue's own questions are asked. No tool accepts a guest's personal details.

Times

No tool returns a timezone, on purpose. A model that sees a zone beside a time converts it, and books hours wrong. Times come back as display text for the guest plus an opaque signed token. A token expires in about thirty minutes and cannot be edited, reused for another venue, or pointed at a different service or party size, which is what stops a prompt injection redirecting a booking.

More

• Full documentation
• Connector terms
• Privacy policy
• Gaplessly API reference and the CLI, for reading your own business's data with an API key
• Questions: hello@gaplessly.com

License

MIT. The Gaplessly name and logo are not covered by it.