# Tock Reservations MCP > Tock Reservations. Connects your AI agent directly to Tock's API for managing restaurant operations. You can list every reservation, pull detailed guest profiles, or check real-time business metrics like total covers and occupancy rates—all via natural conversation. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** reservations, guest-management, restaurant-operations, booking-system, hospitality-tech, event-scheduling ## Description Listen up. This MCP Server connects your agent straight into Tock’s API, letting you manage every single thing that happens at a restaurant without opening a dashboard or typing endless database queries. You can talk to it like talking to a seasoned manager; your AI client handles all the messy booking and guest data retrieval using natural conversation. When you use this server, you get immediate operational oversight. The `quick_hospitality_volume_audit` pulls a high-level summary of reservations, guests, and special events across your entire operation right away. You can also check out what's going on with the whole Tock account itself; the `get_tock_account_metadata` function gives you usage limits and configuration details for your main setup. Need to know how a single venue is running? The `list_managed_businesses` tool shows you all distinct businesses or venues that live under your master Tock account. For any specific location, you'll get the core operational info with `get_business_detailed_data`, and you can track real-time business performance using `get_business_performance_metrics`. This gives you instant data on key metrics like total expected covers or average check sizes for that single venue. When it comes to bookings, you've got coverage. You can pull a full list of all reservations tied to any specific business using `list_business_reservations`, and you can identify all pop-up events or special happenings with `list_business_special_events`. If you need to plan ahead, the agent uses `list_future_scheduled_reservations` to show you every booking set for a date in the future. To deep dive into any single appointment, `get_reservation_details` pulls the full content and current status for that specific reservation ID. Managing people is just as easy. The system lets your agent pull a list of every guest registered in the business directory using `list_business_guests`, helping you check visit history or contact details across multiple venues. If you need to know everything about one venue, the server can also retrieve performance data and general metrics for that single location through dedicated calls. ## Tools ### get_business_detailed_data Retrieves detailed settings and core information for a specific Tock business venue. ### get_business_performance_metrics Calculates and returns a summary of key performance metrics (e.g., covers, average check) for a given business. ### get_reservation_details Gets the full content and current status for one specific reservation. ### get_tock_account_metadata Retrieves metadata, usage limits, and configuration details for your entire Tock account. ### list_business_guests Lists every guest registered in the business directory associated with a venue. ### list_business_reservations Generates a list of all reservations tied to a specific business. ### list_business_special_events Lists records for special events and pop-up bookings hosted at the venue. ### list_future_scheduled_reservations Identifies reservations scheduled to happen on a date in the future. ### list_managed_businesses Lists all distinct businesses and venues currently managed under your Tock account. ### quick_hospitality_volume_audit Pulls a high-level summary of reservations, guests, and events across the entire operation. ## Prompt Examples **Prompt:** ``` List all reservations for tonight. ``` **Response:** ``` I've found 15 reservations for tonight, including a party of 4 for 'John Miller' (7:00 PM) and a party of 2 for 'Alice Connor' (8:30 PM). Total expected covers: 45. Would you like to see the guest notes for John Miller? ``` **Prompt:** ``` What are our performance metrics for this week? ``` **Response:** ``` This week across your business, you have 350 total covers with an occupancy rate of 85%. The average check size is $75. Performance is up 10% compared to last week. Should I pull the breakdown by day of the week? ``` **Prompt:** ``` Search for guest 'Sarah Connor'. ``` **Response:** ``` Sarah Connor has visited your venues 5 times. Their last visit was on March 15th at the 'Downtown Bistro'. They are flagged as a 'VIP Guest'. Would you like to see their dietary preferences and special notes? ``` ## Capabilities ### Pull Operational Metrics Get instant performance data, including total expected covers and average check sizes for any business. ### Audit Guest Records List all registered guests in the system directory to check visit history or contact details. ### Retrieve Booking Lists Get lists of all reservations, future bookings, or special pop-up events for a specific business. ### Deep Dive into Reservations Fetch the full content and current status for any single reservation by its unique ID. ### Manage Venue Metadata List all individual businesses or venues managed under your main Tock account. ## Use Cases ### Checking for VIP Guests A host needs to check on a high-value guest. They prompt: 'Who is the next party arriving?' The agent runs `list_business_reservations`, finds John Miller, and then uses `get_reservation_details` to pull up his special notes and history. ### End-of-Day Performance Review The manager asks: 'How did we do last night?' The agent runs `get_business_performance_metrics`, returning the total covers, average check size, and occupancy rate in a single chat response. ### Planning for Pop-Ups The ops team needs to plan marketing around upcoming non-standard events. They ask: 'What special pop-ups are coming up?' The agent runs `list_business_special_events` and provides a list of dates and venues. ### Troubleshooting Guest Data A team member can't find a guest. They ask the agent to search, which uses `list_business_guests`. The agent returns the full name, contact info, and total visit count for verification. ## Benefits - Check occupancy rates instantly. Instead of logging into a dashboard to find out how many covers are expected, ask your agent for `get_business_performance_metrics` and get the number immediately. - Personalize service on the fly. If you need to know if 'Sarah Connor' is a repeat customer, use `list_business_guests`. Your agent pulls her entire visit history in one go. - Audit everything quickly. Forget digging through tabs for general health checks. The `quick_hospitality_volume_audit` tool gives you a summary of reservations, guests, and events right away. - Manage multiple locations easily. Need to know what venues are set up? Run `list_managed_businesses`. It shows every location under your Tock account in one list. - Isolate booking data. If you only care about the next week's schedule, use `list_future_scheduled_reservations` instead of listing everything forever. ## How It Works The bottom line is you get a single conversational interface for all of your reservation and operations data. 1. Connect the Tock integration to your AI client. 2. Authorize access using your Tock REST API Key (found in your business dashboard settings). 3. Use natural language prompts to query booking details, guest lists, or performance metrics. ## Frequently Asked Questions **How do I check overall business health using get_business_performance_metrics?** You prompt your agent to 'get business performance metrics.' The tool returns real-time data like total covers, occupancy rates, and average check size for the specific venue you reference. **Can I use list_business_guests to find a person's history?** Yes. `list_business_guests` retrieves all registered guests in your directory. It lets you see their total visit count and last recorded visit date. **What is the difference between list_business_reservations and list_future_scheduled_reservations?** They are similar, but different. `list_business_reservations` gets all current bookings (past and future). `list_future_scheduled_reservations` only pulls records set for a date after today. **Do I need to use get_tock_account_metadata first?** No. While you *can* run `get_tock_account_metadata` to check limits, the agent can proceed with querying reservations and guests without it. **If I want to see upcoming pop-ups or special one-off events, should I use list_business_special_events?** Yes, run `list_business_special_events` for that. This tool specifically pulls a list of organized activities and temporary pop-ups. It keeps these separate from standard reservations, letting you see the venue's broader event calendar. **What information do I get when I call get_reservation_details?** The tool returns every piece of data tied to a single booking. You get full content, status updates (like checked in or cancelled), and all associated party details for that specific reservation ID. **How do I find the IDs needed for other calls if I don't know which businesses are managed?** You must first run `list_managed_businesses`. This tool provides a list of all venues and business identifiers registered in your Tock account. Use these resulting IDs to feed into tools like `get_business_performance_metrics`. **What is the difference between quick_hospitality_volume_audit and getting performance metrics?** The audit provides a simple, immediate summary of reservations, guests, and events. The `get_business_performance_metrics` tool offers deeper analysis, providing trends like average check size and historical occupancy rates. **How do I get a Tock API Key?** Log in to your Tock dashboard as an administrator, navigate to **Settings > API**, and you can generate or retrieve your unique **REST API Key** from there. Ensure you have an active business subscription. **Does the integration show guest dietary preferences?** Yes, you can use the get_reservation_details tool to retrieve specific guest notes, which typically include dietary restrictions, special occasions, and seating preferences. **Can the agent make new reservations?** This integration currently focuses on listing and auditing existing reservations, guests, and events. Making new reservations or processing payments should be handled via the Tock booking widget or dashboard interface.