CoverCount Staff

Reads an operation by its original operationKey under the original requester, connection and current action scope. Returns approval/execution state, separate effects/refund state and a nextStep code. This lookup does not approve or retry an action. A succeeded business action stays succeeded while an external outcome is pending or uncertain; repeating it would duplicate the action.

get_operation_status

Reads one reservation by reservationId. Returns local date/time, experience, guest name, party size, status, current table/room assignments, reservationTags and guestTags. Reservation tags such as Birthday or Anniversary are the primary celebration evidence and apply without stored dates; guest tags such as VIP describe only the linked booking guest. All labels are staff-entered data. Empty tables and assignmentStatus=unassigned mean no assignment. availableActions includes modify/cancel with enabled and a reasonCode/reason when unavailable. Enabled means authorized with no known input-independent booking restriction; the requested change and notices are still checked at execution. customerNoticeSupported means cancellation accepts a sendNotice choice, not that a recipient is eligible or delivery guaranteed. Excludes contacts, private notes, payment details and modification tokens. Table, room and reservation IDs are internal references for follow-up calls.

get_reservation

Lists free eligible tables for one booked reservation at the desired venue-local date, whole-minute time and party size, within its existing experience. The reservation's own occupancy is excluded. Results continue via nextCursor with unchanged inputs. Tables with fitsPartyAlone=false need a multi-table selection with sufficient total maxCapacity. No inventory is held; modification rechecks availability and capacity. This inventory read does not establish payment or other modification eligibility. Table and room IDs are internal references for modify_reservation.

get_reservation_table_options

Lists Public and Unlisted reservation experiences, ordered by ID; Hidden experiences are excluded. Results continue via nextCursor. Listed experiences do not establish available inventory.

list_experiences

Returns the authorized venue, timezone, currency and a fresh currentLocalTime, whose calendar date is the venue's today. A null currentLocalTime means the venue timezone is unresolved. Not a public venue directory.

list_venues

Changes the date/time, party size or tables of one booked reservation within its existing experience, executing immediately. Arguments are the complete desired venue-local date, whole-minute time and party size, including unchanged values for a table-only move. tableAssignmentMode is preserve (default), which keeps current tables or auto-assigns when unassigned; auto, which selects available tables; or specific, which uses tableIds from get_reservation_table_options. The preserve and specific modes fail without substitution when the selected tables are unavailable or too small. Payment-related bookings and pending guest requests are handled in the staff app. No immediate notice is sent. Repeating identical arguments with the same idempotencyKey returns the original operation; a conflict leaves the original booking unchanged. Successful status includes the tables as saved; get_reservation returns current assignments.

modify_reservation

Prepares manager/admin review of a positive total capacity for one future eventInstanceId, shared tickets bucket. Events entitlement required; capacity cannot be below tickets sold. No other sessions, offers, registrations or venue tables change.

prepare_capacity_change

Prepares manager/admin review of one event series visibility: public, unlisted or hidden. Public/unlisted requires the Events entitlement and future scheduled sessions with active ticket offers; at most 50 future sessions. Existing content/offers remain. No publication occurs during preparation.

prepare_event_publication

Prepares manager/admin review of recovery for the refund already selected at cancellation. bookingType is reservation or event_registration; bookingId is that exact booking ID. Active bookings are ineligible. No amount override, cancellation or new refund instruction. The existing refund may complete during review.

prepare_refund

Finds event sessions starting within inclusive venue-local YYYY-MM-DD dates, at most 31 days. Each result has a name, local session date/time, seriesId and instanceId; recurring series can appear repeatedly. name is a literal substring; instanceStatus is scheduled/cancelled; visibilityState is hidden/public/unlisted. Archived series require includeArchived=true. Results continue via nextCursor with unchanged filters. summarize_events provides a venue-wide briefing. seriesId and instanceId are internal references for follow-up calls.

search_events

Finds reservations within inclusive venue-local YYYY-MM-DD dates, at most 31 days. status is exact; guest is a literal name substring. Results continue via nextCursor with unchanged filters. Each result has time, experience, party size, status, reservationTags (visit celebrations such as Birthday or Anniversary) and guestTags (current linked-guest labels such as VIP). Tags are the primary celebration evidence, independent of stored dates. reservationId is an internal reference for follow-up calls.

search_reservations

Queues one operational message to the current guest of one reservation, executing immediately. channel is email or sms; omission retains legacy sms. Email requires a 1-200 character subject and 1-4000 character plain-text body; SMS allows 1-320 body characters and no subject. get_guest_message_options reports channel eligibility and the recipient. Requires either the user's explicit request to send their exact text, or the user's confirmation of assistant-drafted or edited text after seeing the exact body, booking, channel, recipient and email subject. A draft request alone is not authorization to send. No recipient/sender override, attachments, bulk or marketing. Each call sends on exactly one channel. Repeating identical arguments with the same idempotencyKey returns the original operation. Succeeded means queued, not delivered; get_operation_status resolves uncertain effects, and another send would duplicate the message. Email uses the configured sender; CoverCount does not provide an inbox for guest replies. Downstream SMS API documentation (Twilio Messages): https://www.twilio.com/docs/messaging/api/message-resource.

send_guest_message

Summarizes recorded activity for one seriesId/instanceId over [fromUtc,toUtc), at most 31 days, with whole-second ISO timestamps carrying Z or an explicit offset. Creation and cancellation counts use their own recorded timestamps. Retained check-ins exclude undone history and are not total attendance. summarize_events provides an overview of sessions and their current financial totals. Full check-in history and period refund/revenue metrics are unavailable here.

summarize_event_activity

Briefs the venue's events in one call; no search or IDs required. Session dates are selected in the venue timezone by today, tomorrow, this_week, last_week, next_week, next_7_days, or custom inclusive fromDate/toDate (YYYY-MM-DD, at most 31 days). Weeks run Monday-Sunday; presets resolve afresh. Optional name is a literal substring; seriesId narrows an exact series. Returns complete totals/daily counts and up to 100 session details, including archived/cancelled/hidden sessions. Check-ins are current registration records, not verified attendance. Financial totals use the existing session-date accounting report and require manager/admin plus events:revenue:read; they are not transactions occurring in the period. Series and instance IDs are internal references.

summarize_events

Returns complete reservation/cover totals, daily counts, largest-party ties, reservationTags and guestTags. Tags are the primary source for celebration highlights (Birthday, Anniversary) and guest context (VIP), including when no stored dates match. Supplementary occasions count stored birthday/anniversary dates with coverage. Each tag reports distinct reservationCount and guestCount; overlapping tags and date matches are not additive. search_reservations/get_reservation return tagged booking details. today, tomorrow, next_7_days (today plus six days) and next_week (next Monday-Sunday) resolve afresh in the venue timezone. Presets cover whole days. Evening service uses custom with established fromLocal/toLocal hours, YYYY-MM-DDTHH:mm without offsets, start inclusive/end exclusive, at most 31 days. Totals include Booked, Confirmed, CheckedIn and Completed. Occasions count distinct linked guests matching visit dates, not all party members or celebration text. Largest-party details stop at five ties with explicit truncation.

summarize_reservations