resOS MCP by usefulapi

io.usefulapi/resos · v1.0.1 · productivity

resOS MCP by usefulapi is healthy: it completed an MCP handshake in 761 ms and exposes 19 tools.

Read bookings, guests and availability; create, update or cancel bookings in resOS.

Endpoint: https://resos.usefulapi.io/mcp (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count19
Latency761 ms
Last checked (UTC)2026-11-02T20:10:28.560Z

Health history

Checked (UTC)StatusLatencyError
2026-11-02T20:10:28.560ZHealthy761

Tools (19)

resos_list_bookingsList bookings, newest or oldest first as you sort, with date, time, party size, status, the guest's name, e-mail and phone, assigned tables and custom-field answers. Filter by date range, status, party size or guest name. The comment thread and sent-message log are not included (use resos_get_bookin
resos_get_bookingOne booking by id, with the guest's contact data, tables, custom fields, payment, the comment thread (guest and restaurant messages) and the internal restaurant notes. GET /bookings/{id}.
resos_list_customersList the restaurant's customers (guest profiles): name, e-mails, phones, city and country, tags, notes, flags, booking count and newsletter consent. The street address is not returned. Filter by name. Pages of at most 100. GET /customers.
resos_get_customerOne customer (guest profile) by id: contact data, tags, notes, flags, booking count and latest booking. GET /customers/{id}.
resos_list_guest_feedbackList guest feedback (ratings for food, service, value and atmosphere, whether they recommend, and the message). Filter by date range, or only submitted feedback. Pages of at most 100. GET /guestFeedback.
resos_get_guest_feedbackOne guest feedback entry by id. GET /guestFeedback/{id}.
resos_list_seating_areasList the seating areas with their tables (id, name, minimum and maximum seats) and table combinations. Use the ids for bookings and availability. GET /tables.
resos_list_opening_hoursList the opening hours: regular weekly hours (day 1 Monday to 7 Sunday) and special date-specific hours, each with id, name, open and close times and whether the restaurant is open. GET /openingHours.
resos_get_opening_hourOne opening-hour entry by id. GET /openingHours/{id}.
resos_list_custom_fieldsList the custom booking fields (name, label, type, required, choices). Use the ids to read or set custom-field answers. GET /customFields.
resos_get_custom_fieldOne custom booking field by id. GET /customFields/{id}.
resos_get_available_datesDates in a range on which the restaurant is open for bookings (default: the next 30 days). GET /bookingFlow/dates.
resos_get_available_timesBooking times that are free on a date for a party size, optionally for one seating area. GET /bookingFlow/times.
resos_get_available_tablesThe tables and table combinations that are free for a party size in a time window (UTC). Use it before assigning tables to a booking. GET /bookingFlow/availableTables.
resos_create_bookingWRITE: create a booking for a guest. It is a real booking in the restaurant's book. If notify_email or notify_sms is true, resOS e-mails or texts the GUEST (a confirmation); both default to false. Date and time are in the restaurant's local timezone. Check resos_get_available_times first: resOS may
resos_update_bookingWRITE: change fields of an existing booking: date, time, party size, tables, duration, status, or the guest's name, e-mail or phone. Only the fields you pass change. A status change or a new time can make resOS e-mail or text the GUEST (for example on approved or declined). To cancel use resos_cance
resos_cancel_bookingWRITE: cancel a booking (status canceled, with a canceled-at time). resOS may e-mail or text the GUEST a cancellation notice. The booking stays in resOS and can be read afterwards. Not retried: after a timeout read the booking first. PUT /bookings/{id}/cancel.
resos_add_booking_noteWRITE: add an internal restaurant note to a booking (for example `Birthday, bring a candle`). The guest does not see it and nothing is sent. At most 50 notes per booking; notes cannot be deleted through the API. Not retried: after a timeout read the booking first, or the note may be added twice. POS
resos_send_booking_commentWRITE: post a comment from the restaurant on a booking's guest thread. The guest can see it. If send_notification is true, resOS e-mails or texts the GUEST the message now: you must choose true or false. At most 25 comments per booking and 5 per minute. Cannot be deleted through the API. Not retried