Find venues, book tables, rooms and services, buy event tickets and order food delivery.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Book a table reservation (not a room/stay — use book_room for that) on behalf of a real guest. The venue's city/countryCode come from search_venues. This is a REQUEST the venue reviews and confirms, not an instant confirmation.
Date and time of the reservation, ISO format, e.g. 2026-10-18T12:30. With no timezone offset it is read as the venue's local time. Must be in the future, at least the venue's minimum notice (default 2 hours) ahead, and inside its opening hours (see search_venues openingHours).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Book a table reservation (not a room/stay — use book_room for that) on behalf of a real guest. The venue's city/countryCode come from search_venues. This is a REQUEST the venue reviews and confirms, not an instant confirmation.
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| datetime* | string | Date and time of the reservation, ISO format, e.g. 2026-10-18T12:30. With no timezone offset it is read as the venue's local time. Must be in the future, at least the venue's minimum notice (default 2 hours) ahead, and inside its opening hours (see search_venues openingHours). |
| guestName* | string | |
| guestCount | integer | |
| guestEmail | string | |
| guestPhone* | string | |
| restaurantId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId",
"datetime",
"guestName",
"guestPhone"
],
"properties": {
"notes": {
"type": "string"
},
"datetime": {
"type": "string",
"description": "Date and time of the reservation, ISO format, e.g. 2026-10-18T12:30. With no timezone offset it is read as the venue's local time. Must be in the future, at least the venue's minimum notice (default 2 hours) ahead, and inside its opening hours (see search_venues openingHours)."
},
"guestName": {
"type": "string"
},
"guestCount": {
"type": "integer",
"default": 2,
"maximum": 50,
"minimum": 1
},
"guestEmail": {
"type": "string"
},
"guestPhone": {
"type": "string"
},
"restaurantId": {
"type": "string"
}
}
}Submit a stay booking request on behalf of a real guest — check_room_availability shows whether the dates are free; the venue's city/countryCode come from search_venues. This is a REQUEST the venue reviews and confirms (same as a guest booking on the website), not an instant confirmation. No payment is collected by this tool. If the venue takes a deposit, it is requested after the venue confirms the room.
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| checkIn* | string | YYYY-MM-DD |
| checkOut* | string | YYYY-MM-DD |
| guestName* | string | |
| guestCount | integer | |
| guestEmail | string | |
| guestPhone* | string | |
| restaurantId* | string | |
| roomFacilityTypeId* | string |
Book a spa/massage-style SERVICE slot on behalf of a real guest — check_service_availability shows free slots; the venue's city/countryCode come from search_venues. Unlike book_room this is an INSTANT confirmation (a real slot is atomically reserved). No payment is collected by this tool — the guest pays at the venue.
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| startIso* | string | ISO datetime the appointment starts |
| guestName* | string | |
| guestEmail | string | |
| guestPhone* | string | |
| restaurantId* | string | |
| serviceTypeId* | string | |
| practitionerId | string | Optional: a specific person from check_service_availability's availablePractitioners. Omit for whoever is free. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId",
"serviceTypeId",
"startIso",
"guestName",
"guestPhone"
],
"properties": {
"notes": {
"type": "string"
},
"startIso": {
"type": "string",
"description": "ISO datetime the appointment starts"
},
"guestName": {
"type": "string"
},
"guestEmail": {
"type": "string"
},
"guestPhone": {
"type": "string"
},
"restaurantId": {
"type": "string"
},
"serviceTypeId": {
"type": "string"
},
"practitionerId": {
"type": "string",
"description": "Optional: a specific person from check_service_availability's availablePractitioners. Omit for whoever is free."
}
}
}Cancels the connected person's own order under the same rules as the WaitApp website: free while the venue or a rider has not started, refused once the rider is collecting or has the food. A paid order is flagged for the venue to review a refund; refunds are never instant or automatic. When the connection is set to confirm each decision, the first call returns what would be cancelled and cancels nothing, and a call with confirmed: true cancels. With full control it cancels immediately, at most 3 a day.
| Argument | Type | Description |
|---|---|---|
| reason | string | |
| orderId | string | The orderId from list_my_orders |
| confirmed | boolean | True records that the person agreed to cancel this order |
| orderCode | string | The order code returned when the order was placed, e.g. WA-K4M2 |
| restaurantId | string | The venue the order was placed at (needed with orderCode if the person has the same code at two venues) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"reason": {
"type": "string",
"maxLength": 200
},
"orderId": {
"type": "string",
"description": "The orderId from list_my_orders"
},
"confirmed": {
"type": "boolean",
"description": "True records that the person agreed to cancel this order"
},
"orderCode": {
"type": "string",
"description": "The order code returned when the order was placed, e.g. WA-K4M2"
},
"restaurantId": {
"type": "string",
"description": "The venue the order was placed at (needed with orderCode if the person has the same code at two venues)"
}
}
}Looks up the status of a booking or order by its code: the bookingCode or orderCode returned when it was placed (for example WA-K4M2), for a table, stay, service or delivery request, or a pre-order. It needs the restaurantId it was placed at and the phone number it was made with; no sign-in is needed. Returns the status (pending means the venue has not responded yet) and the key details of the booking or order.
| Argument | Type | Description |
|---|---|---|
| phone* | string | The phone number the booking or order was made with. Ask the person for it; it is checked together with the code. No sign-in is needed. |
| bookingCode* | string | |
| restaurantId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId",
"bookingCode",
"phone"
],
"properties": {
"phone": {
"type": "string",
"description": "The phone number the booking or order was made with. Ask the person for it; it is checked together with the code. No sign-in is needed."
},
"bookingCode": {
"type": "string"
},
"restaurantId": {
"type": "string"
}
}
}Check remaining capacity for a specific event.
| Argument | Type | Description |
|---|---|---|
| eventId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"eventId"
],
"properties": {
"eventId": {
"type": "string"
}
}
}Check which physical rooms/facilities of a given catalog type are actually free for a date range — real availability, not just that the type exists. Use list_room_types first to get roomFacilityTypeId.
| Argument | Type | Description |
|---|---|---|
| checkIn* | string | YYYY-MM-DD |
| checkOut* | string | YYYY-MM-DD, must be after checkIn |
| restaurantId* | string | |
| roomFacilityTypeId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId",
"roomFacilityTypeId",
"checkIn",
"checkOut"
],
"properties": {
"checkIn": {
"type": "string",
"description": "YYYY-MM-DD"
},
"checkOut": {
"type": "string",
"description": "YYYY-MM-DD, must be after checkIn"
},
"restaurantId": {
"type": "string"
},
"roomFacilityTypeId": {
"type": "string"
}
}
}Check whether a bookable SERVICE (spa, massage, etc. — a list_room_types entry with kind "service") has a free slot at a specific start time. Real time-slot availability, not date-range like rooms. Use list_room_types first to get the service's id.
| Argument | Type | Description |
|---|---|---|
| startIso* | string | ISO datetime the appointment would start |
| restaurantId* | string | |
| serviceTypeId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId",
"serviceTypeId",
"startIso"
],
"properties": {
"startIso": {
"type": "string",
"description": "ISO datetime the appointment would start"
},
"restaurantId": {
"type": "string"
},
"serviceTypeId": {
"type": "string"
}
}
}Places a drafted delivery order exactly as drafted. The draftId comes from draft_delivery_order, or from place_delivery_order when the connection is set to confirm each decision. Retrying with the same draftId never creates a second order. When payment is online, the result includes a payment link to WaitApp's payment page where the guest pays; this tool charges nothing. The venue must accept the order after it is placed; track_order follows it by orderCode.
| Argument | Type | Description |
|---|---|---|
| draftId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"draftId"
],
"properties": {
"draftId": {
"type": "string"
}
}
}Removes one of the connected person's saved delivery locations. Orders already placed to it are not affected. Use the id from list_saved_locations.
| Argument | Type | Description |
|---|---|---|
| id* | string | The location id from list_saved_locations |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The location id from list_saved_locations"
}
}
}Prices a food/drink DELIVERY order from the venue's menu (choices and sides included), finds the delivery address and quotes the delivery fee, without placing anything. Returns the items, delivery fee, total, distance and estimated delivery time, and a draftId that confirm_delivery_order places (place_delivery_order does both steps and follows the connection's permission setting). Requires the connected WaitApp account. Item ids and each item's optionGroups come from list_menu_items; chosen choices go in selectedOptions (group name and choice name), and a group with required=true must be chosen. Give the fullest address available (street or estate, area, city), or a savedLocationId. Fails with a clear message if the venue is closed, doesn't deliver, or the address is outside its delivery area. payment: pay_on_delivery (the guest pays the venue or rider on delivery) or online (the guest pays the meal on WaitApp's payment page after the order is placed; this tool and the assistant send and approve no payment). The delivery fee is always paid to the rider on delivery.
| Argument | Type | Description |
|---|---|---|
| items* | array | |
| payment | string | How the guest pays for the meal. pay_on_delivery: nothing is charged here; they pay the venue/rider on delivery (default where the venue allows it). mobile_money: when the order is confirmed, a payment prompt is sent to mobileMoneyNumber and the guest approves it on their own phone. Some venues require mobile_money. The delivery fee is always paid to the rider on delivery. |
| guestName* | string | |
| guestPhone* | string | The recipient's phone; the rider calls it on arrival |
Drafts a pre-order for a time slot, for PICKUP (default) or courier DELIVERY (method: delivery, with deliveryAddress or savedLocationId; the slot must offer delivery and the venue must deliver, and the delivery fee is paid to the rider on delivery). Nothing is placed or reserved: it checks the slot against the items (lead time, capacity, items sold that day), prices the order with choices, and returns the summary: slot and ready time, items, total, what is due now and what on collection. The slot comes from list_preorder_slots (slotInstanceId). Returns a draftId for place_preorder. Requires the connected WaitApp account. payment: on_collection (default; the guest pays the venue when collecting) or online (the amount due now is paid by the guest on WaitApp's payment page after the order is placed; the assistant sends and approves no payment); some venues require online. guestPhone is required: the guest and venue use it to find the order. One slot per order.
| Argument | Type | Description |
|---|---|---|
| items* | array | |
| method | string | |
| payment | string | |
| guestName* | string | Who collects, or receives, the order |
| guestPhone* | string | |
| restaurantId* | string | |
| slotInstanceId |
What the person allowed this connection to do on their behalf: whether delivery orders, cancellations and ratings go through immediately (full control, within the limits they set) or are returned for their agreement first (confirm each decision), plus the limits and what is left today. Also says whether a WaitApp account is connected.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Returns the link to WaitApp's payment page for one of the connected person's own orders that still has an amount to pay now (an order placed with online payment, or a pre-order with a deposit). The person opens the link, sees the exact charge, and pays it themselves; this tool charges nothing and sends no payment prompt. Find the order by orderCode (with restaurantId if the same code exists at two venues) or by orderId from list_my_orders.
| Argument | Type | Description |
|---|---|---|
| orderId | string | The orderId from list_my_orders |
| orderCode | string | The order code returned when the order was placed, e.g. WA-K4M2 |
| restaurantId | string | The venue the order was placed at (needed with orderCode if the person has the same code at two venues) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"orderId": {
"type": "string",
"description": "The orderId from list_my_orders"
},
"orderCode": {
"type": "string",
"description": "The order code returned when the order was placed, e.g. WA-K4M2"
},
"restaurantId": {
"type": "string",
"description": "The venue the order was placed at (needed with orderCode if the person has the same code at two venues)"
}
}
}Returns the link to WaitApp's ticket checkout page for an event, with the chosen ticket type and quantity filled in. The guest opens it, sees the exact price, and buys the tickets themselves; this tool charges nothing and sends no payment prompt. check_event_availability shows what is left and the ticket types (tierId).
| Argument | Type | Description |
|---|---|---|
| tierId | string | The ticket type, from check_event_availability |
| eventId* | string | |
| quantity | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"eventId"
],
"properties": {
"tierId": {
"type": "string",
"description": "The ticket type, from check_event_availability"
},
"eventId": {
"type": "string"
},
"quantity": {
"type": "integer",
"default": 1,
"maximum": 20,
"minimum": 1
}
}
}List upcoming, published events (ticketed or free) for a venue, or across all venues if restaurantId is omitted.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| restaurantId | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"restaurantId": {
"type": "string"
}
}
}List a restaurant's menu items. Call with just restaurantId first to see the category names (and counts), then filter with category and/or query rather than reading the whole menu. Items with choices (sides, sizes, add-ons) list them under optionGroups: when ordering, pass the chosen group and choice names as selectedOptions; a group with required=true must be chosen. Unavailable items are left out. Items marked soldAheadOnly are sold only for a scheduled date (a pre-order with a time slot): they can't be ordered for immediate delivery; use list_preorder_slots to pick a time, then draft_preorder and place_preorder (pickup). Paginate with limit and offset.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | Only items whose name or description contains this text, e.g. 'burger' |
| offset | integer | |
| category | string | Only items in this category (case-insensitive), e.g. 'drinks' |
| restaurantId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId"
],
"properties": {
"limit": {
"type": "integer",
"default": 30,
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"description": "Only items whose name or description contains this text, e.g. 'burger'"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
},
"category": {
"type": "string",
"description": "Only items in this category (case-insensitive), e.g. 'drinks'"
},
"restaurantId": {
"type": "string"
}
}
}The connected person's own order history at WaitApp venues, newest first. Each order has its venue, code, status, total, type, when it was placed and what was ordered: every item with its quantity, price and chosen choices. Items carry menuItemId and selectedOptions in the form draft_delivery_order accepts. Deliveries also show the address, delivery fee and stage. A kitchen and a bar order placed together are one entry. Filter by venue, status, text (an item or venue name) or date, and page back with nextBefore. Only this person's own orders are returned.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | An item name or venue name, e.g. burger or Social |
| since | string | Only orders placed on or after this date, e.g. 2026-09-01 |
| before | string | Only orders placed before this time. Pass nextBefore from the previous page |
| status | string | e.g. pending, accepted, preparing, ready, served, cancelled |
| restaurantId | string | Only orders at this venue |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1
},
"query": {
"type": "string",
"description": "An item name or venue name, e.g. burger or Social"
},
"since": {
"type": "string",
"description": "Only orders placed on or after this date, e.g. 2026-09-01"
},
"before": {
"type": "string",
"description": "Only orders placed before this time. Pass nextBefore from the previous page"
},
"status": {
"type": "string",
"description": "e.g. pending, accepted, preparing, ready, served, cancelled"
},
"restaurantId": {
"type": "string",
"description": "Only orders at this venue"
}
}
}For venues that take scheduled pre-orders (bakeries, caterers; list_menu_items marks their items soldAheadOnly): the dates and times an order can be booked for. Pass the items the guest wants (menuItemId and quantity) so each slot is checked against them: lead time (a cake may need days of notice), items not sold on some days, per-slot limits and capacity. First states the venue's schedule in plain words (schedule: e.g. weekdays, order by 08:00, ready at 11:00; weekends only; every day), so you can describe the pattern to the guest, then lists bookable slots soonest first, each with slotInstanceId, when it will be ready (readyAtLocal), the last moment to order (orderByLocal), places left, and payment terms where a deposit or full payment is required; plus unavailable slots with the reason. method is pickup or delivery.
| Argument | Type | Description |
|---|---|---|
| items | array | The items to book; leave empty to just see the venue's slots |
| method | string | How the guest will receive it; slots that don't offer it are marked unavailable |
| restaurantId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"menuItemId",
"quantity"
],
"properties": {
"quantity": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"menuItemId": {
"type": "string"
}
}
},
"default": [],
"maxItems": 50,
"description": "The items to book; leave empty to just see the venue's slots"
},
"method": {
"enum": [
"pickup",
"delivery"
],
"type": "string",
"description": "How the guest will receive it; slots that don't offer it are marked unavailable"
},
"restaurantId": {
"type": "string"
}
}
}List a venue's bookable room/facility catalog (only entries visible to customers). Use search_venues first to find the restaurantId.
| Argument | Type | Description |
|---|---|---|
| restaurantId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId"
],
"properties": {
"restaurantId": {
"type": "string"
}
}
}The connected person's saved delivery locations, such as Home and Work: label, address, notes for the rider, and which one is their default. Pass a location's id as savedLocationId to draft_delivery_order or place_delivery_order instead of typing an address. Only ever shows this person's own.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Orders food for delivery in one call: prices the order, quotes the delivery fee, then places it or returns a draft depending on the permission chosen when connecting (get_connection_permissions shows it). With full control it places the order within the spending limits set; with confirm-each-decision it places nothing and returns a draft summary with a draftId that confirm_delivery_order places. Same inputs and rules as draft_delivery_order. idempotencyKey is required: the same key returns the same order instead of creating a second one. When payment is online, the result includes a payment link to WaitApp's payment page where the guest sees the exact charge and pays it; this tool charges nothing. The venue must accept the order after it is placed; track_order follows it by orderCode.
| Argument | Type | Description |
|---|---|---|
| items* | array | |
| payment | string | |
| guestName* | string | |
| guestPhone* | string | |
| restaurantId* | string | |
| idempotencyKey* | string | A unique value you generate for this order; reuse it on any retry |
| deliveryAddress | string |
Places a pre-order drafted with draft_preorder, exactly as drafted: holds the time slot and creates the order. When an amount is due now, the result includes a payment link to WaitApp's payment page where the guest sees the exact charge and pays it themselves; this tool charges nothing. The held slot is released and the order cancelled if the amount due now is not paid in time. If anything fails part-way the slot is released and nothing is charged. Retrying with the same draftId never creates a second order. track_order follows the order by orderCode.
| Argument | Type | Description |
|---|---|---|
| draftId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"draftId"
],
"properties": {
"draftId": {
"type": "string"
}
}
}The delivery fee, distance and estimated delivery time from one venue to an address or a saved location, with no cart: a quick way to compare venues before building an order. The figure is the same one a draft order then shows. Also says whether the address is inside the venue's delivery area and whether the venue is open now. Needs a connected WaitApp account.
| Argument | Type | Description |
|---|---|---|
| restaurantId* | string | |
| deliveryAddress | string | Full delivery address. Not needed when savedLocationId is given |
| savedLocationId | string | The id of one of the person's saved locations (list_saved_locations) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId"
],
"properties": {
"restaurantId": {
"type": "string"
},
"deliveryAddress": {
"type": "string",
"description": "Full delivery address. Not needed when savedLocationId is given"
},
"savedLocationId": {
"type": "string",
"description": "The id of one of the person's saved locations (list_saved_locations)"
}
}
}Leave a rating for the connected person's own DELIVERED order: food quality, delivery speed and packaging, each 1 to 5, an optional short comment, and optionally a rating for the rider. One rating per order; a repeat returns the existing one. The scores are the person's own. If the connection is set to confirm each decision, the first call returns the scores and submits nothing until a call with confirmed: true.
| Argument | Type | Description |
|---|---|---|
| food* | integer | |
| comment | string | |
| orderId | string | The orderId from list_my_orders |
| confirmed | boolean | True records that the person agreed to submit these scores |
| orderCode | string | The order code returned when the order was placed, e.g. WA-K4M2 |
| packaging* | integer | |
| riderRating | integer | |
| restaurantId | string | The venue the order was placed at (needed with orderCode if the person has the same code at two venues) |
| deliverySpeed* |
Saves a delivery location to the connected person's WaitApp account under a label such as Home or Work, so later orders can use it. Saving a label the person already has updates that location. Up to 10 can be saved. Notes are for the rider, for example a gate code, floor or landmark.
| Argument | Type | Description |
|---|---|---|
| label* | string | A short name, e.g. Home, Work, Mum's place |
| notes | string | Gate code, floor, landmark |
| address* | string | Full address: street or estate, area, city |
| makeDefault | boolean | Make this the person's default location |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"label",
"address"
],
"properties": {
"label": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "A short name, e.g. Home, Work, Mum's place"
},
"notes": {
"type": "string",
"maxLength": 200,
"description": "Gate code, floor, landmark"
},
"address": {
"type": "string",
"maxLength": 300,
"minLength": 5,
"description": "Full address: street or estate, area, city"
},
"makeDefault": {
"type": "boolean",
"description": "Make this the person's default location"
}
}
}Finds which venues sell a dish or cuisine, such as pizza or biryani, by searching the menus of live venues in a city or country (never event organisers). Items filed under a category with the searched name (a Platters section for platter) come first, then dish names and descriptions; close equivalents are searched too (platter also finds basket and sharing plate) and listed in alsoSearched. Returns, for each venue with a match, the venue (whether it delivers, whether it is open now, and its distance when a position is known) and up to perVenue matching items with price and whether they have required choices; matchingItems and moreMatches say how many more exist. When a position is given, or the connected person has a default saved location, venues come back nearest first. Use list_menu_items with the venue id for the full menu and each item's options. Matches marked soldAheadOnly are sold only for a scheduled date (a pre-order with a time slot). Uses a search index, so it covers every live venue quickly. A city or countryCode narrows it and is recommended, because dish names are the same everywhere.
| Argument | Type | Description |
|---|---|---|
| city | string | City, case-insensitive exact match |
| query* | string | A dish or cuisine, e.g. pizza, biryani, burger. Every word must appear in the item's name, category or description |
| nearLat | number | With nearLng: venues come back nearest-first from this point |
| nearLng | number | |
| openNow | boolean |
Search WaitApp venues (restaurants, hotels, lodges) by name, city and/or country, and filter them: takesDelivery, venueType (restaurant, hotel, event_organizer, ...) and openNow. Empty query lists venues. Name matching is forgiving (case, '&' vs 'and', small typos); if nothing matches closely, the closest names come back as didYouMean. Each venue says what it supports (delivery, table reservations, stays), whether it is open now and on what basis (openNowBasis: the venue's own switch, its opening hours, or no hours set so assumed open), when it next opens if closed (opensAt), and its hours in words (hoursSummary) and per day (openingHours). With a saved location (savedLocationId) or coordinates (nearLat and nearLng), each venue carries its straight-line distance and venues come back nearest first; with neither, the connected person's default saved location is used when they have one (sortedBy says so). For the delivery fee to an address use quote_delivery. Each venue includes its city and countryCode: venue names repeat across countries. To find who sells a dish, use search_menu.
| Argument | Type | Description |
|---|---|---|
| city | string | City to filter by, case-insensitive exact match |
| limit | integer | |
| query | string | Name to search for. Forgiving: ignores case and punctuation, treats '&' as 'and', tolerates small typos |
| nearLat | number | With nearLng: adds distance from this point |
| nearLng | number | |
How an order is going, for the connected person's own order: for a delivery, the stage, minutes remaining, how far the rider is from the drop-off (km) and the rider's first name; for a scheduled pre-order, its time slot, ready time (in the venue's local time) and what is due in advance; for other orders, the status. The rider's phone number and exact location are never returned.
| Argument | Type | Description |
|---|---|---|
| orderId | string | The orderId from list_my_orders |
| orderCode | string | The order code returned when the order was placed, e.g. WA-K4M2 |
| restaurantId | string | The venue the order was placed at (needed with orderCode if the person has the same code at two venues) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"orderId": {
"type": "string",
"description": "The orderId from list_my_orders"
},
"orderCode": {
"type": "string",
"description": "The order code returned when the order was placed, e.g. WA-K4M2"
},
"restaurantId": {
"type": "string",
"description": "The venue the order was placed at (needed with orderCode if the person has the same code at two venues)"
}
}
}OPTIONAL. Fetch a small version of the actual photo(s) of a menu item, room/facility type, event or venue so you can look at them and describe them to the guest. Meant for when the guest asks what something looks like. To just show a picture, the imageUrl / photos / coverImageUrl links in the other tools are enough. Returns up to 3 images (resized small) or a note that none exist. Use the id from list_menu_items, list_room_types, list_events or search_venues.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| kind* | string | |
| maxPhotos | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"menu_item",
"room_type",
"event",
"venue"
],
"type": "string"
},
"maxPhotos": {
"type": "integer",
"default": 2,
"maximum": 3,
"minimum": 1
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId",
"roomFacilityTypeId",
"checkIn",
"checkOut",
"guestName",
"guestPhone"
],
"properties": {
"notes": {
"type": "string"
},
"checkIn": {
"type": "string",
"description": "YYYY-MM-DD"
},
"checkOut": {
"type": "string",
"description": "YYYY-MM-DD"
},
"guestName": {
"type": "string"
},
"guestCount": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1
},
"guestEmail": {
"type": "string"
},
"guestPhone": {
"type": "string"
},
"restaurantId": {
"type": "string"
},
"roomFacilityTypeId": {
"type": "string"
}
}
}| restaurantId* | string |
| deliveryAddress | string | Full delivery address, e.g. 'Plot 12, Foxtale Court, Kawanda Road, Rhodes Park, Lusaka'. Not needed when savedLocationId is given |
| savedLocationId | string | The id of one of the person's saved locations (see list_saved_locations), used instead of deliveryAddress |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId",
"items",
"guestName",
"guestPhone"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"menuItemId"
],
"properties": {
"quantity": {
"type": "integer",
"default": 1,
"maximum": 50,
"minimum": 1
},
"menuItemId": {
"type": "string"
},
"selectedOptions": {
"type": "array",
"items": {
"type": "object",
"required": [
"category",
"choice"
],
"properties": {
"choice": {
"type": "string",
"description": "choice name"
},
"category": {
"type": "string",
"description": "optionGroups name"
}
}
}
}
}
},
"maxItems": 30,
"minItems": 1
},
"payment": {
"enum": [
"pay_on_delivery",
"online",
"mobile_money"
],
"type": "string",
"description": "How the guest pays for the meal. pay_on_delivery: nothing is charged here; they pay the venue/rider on delivery (default where the venue allows it). mobile_money: when the order is confirmed, a payment prompt is sent to mobileMoneyNumber and the guest approves it on their own phone. Some venues require mobile_money. The delivery fee is always paid to the rider on delivery."
},
"guestName": {
"type": "string"
},
"guestPhone": {
"type": "string",
"description": "The recipient's phone; the rider calls it on arrival"
},
"restaurantId": {
"type": "string"
},
"deliveryAddress": {
"type": "string",
"description": "Full delivery address, e.g. 'Plot 12, Foxtale Court, Kawanda Road, Rhodes Park, Lusaka'. Not needed when savedLocationId is given"
},
"savedLocationId": {
"type": "string",
"description": "The id of one of the person's saved locations (see list_saved_locations), used instead of deliveryAddress"
}
}
}| string |
| From list_preorder_slots |
| deliveryAddress | string | For delivery: the full address. Not needed when savedLocationId is given |
| savedLocationId | string | For delivery: one of the person's saved locations (see list_saved_locations) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"restaurantId",
"slotInstanceId",
"items",
"guestName",
"guestPhone"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"menuItemId"
],
"properties": {
"quantity": {
"type": "integer",
"default": 1,
"maximum": 50,
"minimum": 1
},
"menuItemId": {
"type": "string"
},
"selectedOptions": {
"type": "array",
"items": {
"type": "object",
"required": [
"category",
"choice"
],
"properties": {
"choice": {
"type": "string",
"description": "choice name"
},
"category": {
"type": "string",
"description": "optionGroups name"
}
}
}
}
}
},
"maxItems": 30,
"minItems": 1
},
"method": {
"enum": [
"pickup",
"delivery"
],
"type": "string",
"default": "pickup"
},
"payment": {
"enum": [
"on_collection",
"online",
"mobile_money"
],
"type": "string"
},
"guestName": {
"type": "string",
"description": "Who collects, or receives, the order"
},
"guestPhone": {
"type": "string"
},
"restaurantId": {
"type": "string"
},
"slotInstanceId": {
"type": "string",
"description": "From list_preorder_slots"
},
"deliveryAddress": {
"type": "string",
"description": "For delivery: the full address. Not needed when savedLocationId is given"
},
"savedLocationId": {
"type": "string",
"description": "For delivery: one of the person's saved locations (see list_saved_locations)"
}
}
}| Full delivery address. Not needed when savedLocationId is given |
| savedLocationId | string | The id of one of the person's saved locations (see list_saved_locations), used instead of deliveryAddress |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"restaurantId",
"items",
"guestName",
"guestPhone"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"menuItemId"
],
"properties": {
"quantity": {
"type": "integer",
"default": 1,
"maximum": 50,
"minimum": 1
},
"menuItemId": {
"type": "string"
},
"selectedOptions": {
"type": "array",
"items": {
"type": "object",
"required": [
"category",
"choice"
],
"properties": {
"choice": {
"type": "string"
},
"category": {
"type": "string"
}
}
}
}
}
},
"maxItems": 30,
"minItems": 1
},
"payment": {
"enum": [
"pay_on_delivery",
"online",
"mobile_money"
],
"type": "string"
},
"guestName": {
"type": "string"
},
"guestPhone": {
"type": "string"
},
"restaurantId": {
"type": "string"
},
"idempotencyKey": {
"type": "string",
"maxLength": 100,
"minLength": 8,
"description": "A unique value you generate for this order; reuse it on any retry"
},
"deliveryAddress": {
"type": "string",
"description": "Full delivery address. Not needed when savedLocationId is given"
},
"savedLocationId": {
"type": "string",
"description": "The id of one of the person's saved locations (see list_saved_locations), used instead of deliveryAddress"
}
}
}| integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"food",
"deliverySpeed",
"packaging"
],
"properties": {
"food": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"comment": {
"type": "string",
"maxLength": 500
},
"orderId": {
"type": "string",
"description": "The orderId from list_my_orders"
},
"confirmed": {
"type": "boolean",
"description": "True records that the person agreed to submit these scores"
},
"orderCode": {
"type": "string",
"description": "The order code returned when the order was placed, e.g. WA-K4M2"
},
"packaging": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"riderRating": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"restaurantId": {
"type": "string",
"description": "The venue the order was placed at (needed with orderCode if the person has the same code at two venues)"
},
"deliverySpeed": {
"type": "integer",
"maximum": 5,
"minimum": 1
}
}
}| true: only venues open right now |
| perVenue | integer | Matching items shown per venue; each venue says how many more matched |
| maxVenues | integer |
| countryCode | string | ISO 3166-1 alpha-2, e.g. ZM |
| takesDelivery | boolean | true: only venues that deliver |
| savedLocationId | string | A saved location of the connected person (list_saved_locations): venues come back nearest-first from it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"city": {
"type": "string",
"description": "City, case-insensitive exact match"
},
"query": {
"type": "string",
"minLength": 2,
"description": "A dish or cuisine, e.g. pizza, biryani, burger. Every word must appear in the item's name, category or description"
},
"nearLat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "With nearLng: venues come back nearest-first from this point"
},
"nearLng": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"openNow": {
"type": "boolean",
"description": "true: only venues open right now"
},
"perVenue": {
"type": "integer",
"default": 8,
"maximum": 15,
"minimum": 1,
"description": "Matching items shown per venue; each venue says how many more matched"
},
"maxVenues": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1
},
"countryCode": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2, e.g. ZM"
},
"takesDelivery": {
"type": "boolean",
"description": "true: only venues that deliver"
},
"savedLocationId": {
"type": "string",
"description": "A saved location of the connected person (list_saved_locations): venues come back nearest-first from it"
}
}
}| openNow |
| boolean |
| true: only venues open right now |
| venueType | string | e.g. restaurant, hotel, event_organizer |
| countryCode | string | ISO 3166-1 alpha-2, e.g. ZM for Zambia — filter to a single country |
| takesDelivery | boolean | true: only venues that deliver |
| savedLocationId | string | A saved location of the connected person (list_saved_locations): adds distance from it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"city": {
"type": "string",
"description": "City to filter by, case-insensitive exact match"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"description": "Name to search for. Forgiving: ignores case and punctuation, treats '&' as 'and', tolerates small typos"
},
"nearLat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "With nearLng: adds distance from this point"
},
"nearLng": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"openNow": {
"type": "boolean",
"description": "true: only venues open right now"
},
"venueType": {
"type": "string",
"description": "e.g. restaurant, hotel, event_organizer"
},
"countryCode": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2, e.g. ZM for Zambia — filter to a single country"
},
"takesDelivery": {
"type": "boolean",
"description": "true: only venues that deliver"
},
"savedLocationId": {
"type": "string",
"description": "A saved location of the connected person (list_saved_locations): adds distance from it"
}
}
}