MCP server
Waitwhile MCP by usefulapi
Read Waitwhile visits, bookings, customers, services and analytics; add, update and…
- Runs
- Remotely
- Version
- 1.27.0
- Listing updated
- 4 days ago
About Waitwhile MCP by usefulapi
Waitwhile MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read Waitwhile visits, bookings, customers, services and analytics; add, update and cancel visits.
Install
Run in a terminal
claude mcp add --transport http waitwhile https://waitwhile.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://waitwhile.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"waitwhile": {
"url": "https://waitwhile.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"waitwhile": {
"type": "http",
"url": "https://waitwhile.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"waitwhile": {
"serverUrl": "https://waitwhile.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"waitwhile": {
"type": "http",
"url": "https://waitwhile.usefulapi.io/mcp"
}
}
}Tools this server provides (29)
Read directly from the server.
- waitwhile_list_locations
- List the account's locations (businesses/sites): id, name, short name, address, time zone, opening hours and waitlist/booking settings. Use the ids to filter visits, services and resources. GET /locations.
- waitwhile_get_location
- One location by id or short name (the part of its public Waitwhile URL). GET /locations/{shortNameOrId}.
- waitwhile_list_location_status
- Live status of every location: open/closed, number of people waiting and being served, current estimated wait time, and booking counters. GET /location-status.
- waitwhile_get_location_status
- Live status of one location: open/closed, waiting and serving counts, estimated wait. GET /location-status/{locationId}.
- waitwhile_list_visits
- List visits: waitlist entries (people in line) and bookings (appointments), with customer, state (PENDING, DRAFT, BOOKED, WAITING, SERVING, COMPLETE), tags (e.g. NO-SHOW, CANCELLED, ARRIVED), services, resources, party size, position and timestamps. Filter by location, state, tag, customer, service, resource, booking date (local time) or created/updated date. Cursor-paged. Contains customer contac
- waitwhile_search_visits
- Search visits by a prefix match on customer name, phone, e-mail or customer id, optionally filtered by location, state, tag and excluded tags. Page-numbered. Contains customer contact details. GET /visits/search.
- waitwhile_get_visit
- One visit (waitlist entry or booking) by id: customer, state, tags, services, resources, party size, position, estimated wait and all timestamps. GET /visits/{visitId}.
- waitwhile_list_booking_slots
- Booking slots of a location for a date range with the free spots per resource and service, so you can see when an appointment can be booked. Dates are local to the location, YYYY-MM-DDThh:mm. GET /visits/availability.
- waitwhile_first_available_slots
- The first available booking slots of a location (optionally for a party size, services and resources) from a date. Use it to propose appointment times. GET /visits/first-available-slots.
- waitwhile_list_customers
- List customers (name, phone, e-mail, tags, last visit per location, created/updated). Cursor-paged, 20 per page by default; filter by location, external id or created/updated date. Contains personal data. GET /customers.
- waitwhile_search_customers
- Search customers by a prefix match on name, phone, e-mail or customer id; optionally narrowed by location, visit state or tag. Page-numbered. Contains personal data. GET /customers/search.
- waitwhile_get_customer
- One customer by id: contact details, tags, per-location state and last visit. Contains personal data. GET /customers/{customerId}.
- waitwhile_list_customer_notes
- The staff notes recorded on a customer (content, author, visit and location, timestamps). GET /customers/{customerId}/notes.
- waitwhile_list_services
- List services (what customers book or queue for): name, duration, price, locations, resources and category structure. GET /services.
- waitwhile_get_service
- One service by id. GET /services/{serviceId}.
- waitwhile_list_resources
- List resources — the people, rooms, tables or equipment that serve customers: name, locations, services, availability flag and category structure. GET /resources.
- waitwhile_get_resource
- One resource by id. GET /resources/{resourceId}.
- waitwhile_resources_availability
- Working hours/availability of a location's resources on a date (e.g. who is working today). GET /resources/availability.
- waitwhile_list_data_fields
- List the custom data fields (intake/booking form questions) with type, options and where they apply. Use the ids to read answers on visits. GET /data-fields.
- waitwhile_get_data_field
- One data field by id. GET /data-fields/{dataFieldId}.
- waitwhile_list_users
- List the staff users of the account: name, e-mail, roles, locations. Password data and tokens are never returned. GET /users.
- waitwhile_list_messages
- List the SMS/e-mail messages Waitwhile sent to and received from customers: channel, recipient, body, delivery state (PENDING, BLOCKED, FAILED, DELIVERED, UNCONFIRMED, RECEIVED) and error. Filter by location, visit, customer, state or date. Contains personal data. This only reads; it cannot send. GET /messages.
- waitwhile_get_message
- One message by id. Contains personal data. GET /messages/{messageId}.
- waitwhile_visit_analytics
- Aggregated visit statistics for a period: visits, waitlisted, bookings, served, no-shows, cancellations, wait and serve duration quantiles, and breakdowns by location, resource, service, party size, user, day of week and hour of day. GET /analytics/visits (JSON).
- waitwhile_list_audit_entries
- The account's audit log: who changed what and when (visits, customers, locations, services, resources, users, messages). Filter by type, event, entity, location or date. GET /audit-entries.
- waitwhile_create_visit
- WRITE: create ONE visit at a location. Without a date it adds the customer to the waitlist; with a local date-time (YYYY-MM-DDThh:mm) it creates a booking. Needs a location and at least a name, phone or e-mail. Not idempotent: calling it twice creates two visits. Visit notes are not supported here (the field is deprecated): use waitwhile_add_customer_note. By default the request asks Waitwhile to
- waitwhile_update_visit
- WRITE: change ONE visit — its state (e.g. WAITING to SERVING to COMPLETE, or BOOKED), add/remove tags (e.g. ARRIVED, CONFIRMED, NO-SHOW), booking date/duration or party size. Only the fields you pass change. By default the request asks Waitwhile to suppress the customer message; this may only stop the immediate status message, and scheduled reminders/follow-ups can still go out per the location's
- waitwhile_cancel_visit
- WRITE: cancel ONE visit (a waitlist entry or booking). Waitwhile sets its state to COMPLETE and adds the CANCELLED tag; the visit is kept, not deleted. By default the request asks Waitwhile to suppress the customer message; this may only stop the immediate cancellation notice, and scheduled reminders/follow-ups can still go out per the location's settings. With send_notifications=true Waitwhile ma
- waitwhile_add_customer_note
- WRITE: add one staff note to a customer's record (optionally tied to a visit and location). Adds only; nothing is edited or sent to the customer. POST /customers/{customerId}/notes.
Waitwhile MCP by usefulapi FAQ
How do I add Waitwhile MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http waitwhile https://waitwhile.usefulapi.io/mcp