Gaplessly MCP server
Commit Nov 2, 2026Allows AI assistants to search for venues and find available appointment or table times for bookings.
Also known as gaplessly/mcp
- Stars
- 1
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 2, 2026
- License
- MIT
What is Gaplessly MCP?
Gaplessly allows AI assistants to search for venues and find available appointment or table times for bookings. It exposes 6 tools, such as find_venues, get_venue, find_appointment_times.
Summary generated from the project's README
About Gaplessly MCP server
Finding available appointment slots or restaurant tables through an AI assistant is what this server enables. It connects AI clients to businesses that use Gaplessly for their booking management. Developers can integrate this via streamable HTTP using a single public endpoint that requires no API keys or authentication. It works with Claude Code, Claude web and desktop, Cursor, and VS Code.
Users can search for businesses by name, suburb, postcode, or type using the find_venues tool. Once a venue is identified, the server provides specific tools to check for available appointment times at salons or clinics, and table times at restaurants for up to two weeks. The server is read-only, meaning it never writes data or accepts personal guest details. Instead, it generates secure links that allow guests to complete their own bookings on the venue's official page, ensuring security and accuracy.
What you can do with it
- 1Locate local service businessesSearch for businesses by name, suburb, or kind to find their booking pages.
- 2Check restaurant availabilityFind free table times for a specific party size over a two-week period.
- 3Schedule service appointmentsLook up available appointment slots for clinics, salons, or studios.
- 4Hand off bookings to guestsGenerate a secure link so a user can finish a reservation on the venue's own site.
Written from the project's README. Every use case is checked against a quote from it.
Gaplessly MCP tools 6
Detected from the READMEfind_venuesget_venuefind_appointment_timesfind_table_timesstart_appointment_bookingstart_table_booking
| find_venues | — | |
| get_venue | — | |
| find_appointment_times | — | |
| find_table_times | — | |
| start_appointment_booking | — | |
| start_table_booking | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablegaplessly/mcp is public and reachablegithub.com/gaplessly/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-02github.com/gaplessly/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubAn 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.
Gaplessly MCP questions
What tools does Gaplessly MCP provide?
It exposes 6 tools, including find_venues, get_venue, find_appointment_times, find_table_times, start_appointment_booking.
Does this server allow an AI to complete a booking?
No, the server is read-only and provides a link for the guest to finish the booking themselves on the venue's own page.
Do I need an API key to use this?
No, it is a public endpoint that requires no authentication.
How does the server handle timezones?
The server does not return timezones to prevent models from incorrectly converting hours; instead, times are returned as display text.
Can I search for businesses by location?
Yes, you can search for businesses by name, suburb, postcode, or kind.