# CellarPass MCP

> CellarPass manages everything for your winery tasting room. Use this MCP to query current bookings, check open slots for specific tours, review venue capacities across multiple locations, and pull detailed guest profiles including visit history and favorite experiences—all through natural conversation.

## Overview
- **Category:** event-management
- **Price:** Free
- **Tags:** reservation-system, winery-management, guest-experience, tasting-room, booking-management, hospitality-operations

## Description

Managing a tasting room means juggling reservations, staff scheduling, and knowing who's coming in the door. This MCP connects your CellarPass account to your AI client so you stop clicking between five different dashboards. Instead of checking separate systems for bookings, experience details, or guest history, your agent handles it all. You can ask about daily arrivals and immediately see which VIP guests are visiting; you can check if a private cellar is available next month; or you can pull up John Doe's record to remember he loves the Food & Wine Pairing. It’s built for hospitality operations that need deep context, making Vinkius the central hub where all those systems finally talk to each other.

## Tools

### list_reservations
Lists all confirmed reservations for a date range, crucial for daily shift planning.

### get_reservation
Retrieves all details for an existing booking, including the guest count and time.

### list_experiences
Returns a list of all available tours and pairings, including pricing details.

### get_experience
Pulls detailed information about a single type of tasting experience (e.g., Vineyard Tour).

### check_availability
Confirms if a specific time slot for an activity is open for booking.

### list_venues
Shows a list of every physical tasting room location managed by the winery.

### get_venue
Gets specific operational hours and capacity data for a single tasting room location.

### search_guests
Finds specific client profiles, showing their past visits and high-value preferences for better service.

## Prompt Examples

**Prompt:** 
```
What reservations do we have for this Saturday?
```

**Response:** 
```
🎟️ **Saturday Reservations — Oct 18, 2025**

📊 **Summary**: 14 reservations | 47 guests | 3 experiences

**Morning**
- 10:00 — **Henderson Party** 👥 6 | Reserve Tasting | ⭐ VIP Club Member
- 10:30 — **Park Family** 👥 4 | Estate Tour
- 11:00 — **Chen Group** 👥 8 | Food & Wine Pairing | 🎂 Birthday
- 11:00 — **Williams** 👥 2 | Reserve Tasting

**Afternoon**
- 1:00 — **Torres Wedding Party** 👥 12 | Private Cellar | 🥂 Special Event
- 1:30 — **Johnson** 👥 2 | Estate Tour
- 2:00 — **Davis** 👥 4 | Reserve Tasting
...

> 💡 3 VIPs today. Henderson party has $47K lifetime spend — consider winemaker greeting.
```

**Prompt:** 
```
Open a slot for Vineyard Tour tomorrow at 2PM.
```

**Response:** 
```
Confirmed. I've updated CellarPass directly: there is now 1 open session assigned to Vineyard Tour tomorrow starting at 2:00 PM.
```

**Prompt:** 
```
Look up John Doe's past visits and favored pairings.
```

**Response:** 
```
Searching the guest CRM... John Doe visited the Estate three times prior, primarily booking the 'Food & Wine Pairing' events showcasing top-tier local cheddars.
```

## Capabilities

### Check immediate availability
Determine if a specific tasting experience or venue has open slots on any given date.

### Retrieve reservation details
Pull up full booking information for a specific day, allowing you to see guest names and group sizes.

### Identify potential guests
Search your CRM database by name or parameters to pull visit history, spending totals, and preferred services for any client.

### List available experiences
Get a complete list of all types of tours and pairings offered, including pricing and duration.

### Manage multi-site locations
View details about multiple physical tasting room venues, including their operating hours and capacity limits.

## Use Cases

### Handling a sudden group booking inquiry
A corporate client calls wanting 20 people next month. Instead of checking availability manually, your agent uses `check_availability` and cross-references it with `get_venue` to confirm if the venue has enough capacity *and* open slots for that date.

### Identifying a lapsed VIP client
A guest hasn't visited in six months. You use `search_guests` on their profile, which shows they used to love the Private Cellar experience. Your agent drafts an outreach email mentioning that specific high-value service.

### Planning a large seasonal event
You are planning a harvest festival and need to know all potential dates. You use `list_experiences` first, then run `list_venues` to see which physical locations can support the required number of stations.

## Benefits

- Daily operations get easier. Use `list_reservations` to instantly pull a full day's itinerary, including group sizes and arrival times; no more cross-referencing spreadsheets.
- Boost revenue through personalization. Run `search_guests` to find out which clients loved the Food & Wine Pairing three years ago. This allows your agent to suggest that exact experience during their visit.
- Avoid overbooking entire sites. Check capacity and time slots using `check_availability` before confirming any private event, ensuring you don't commit to more people than a venue can handle.
- Optimize staffing schedules. By listing all available venues via `list_venues`, managers can assign staff based on the known location and expected crowd size for the day’s bookings.
- Understand your product mix better. Use `list_experiences` to compare pricing, duration, and capacity across every single tour type so you can recommend the best fit instantly.

## How It Works

The bottom line is: you talk to your AI client, and it handles all the backend API calls needed to get one unified answer.

1. You initiate a request by asking your agent a question like, 'Who's coming in the next month?'
2. The MCP routes the query to CellarPass, which checks reservation data against venue and experience availability.
3. Your agent returns a structured report detailing bookings, available time slots, or guest profiles directly in the chat.

## Frequently Asked Questions

**How do I check availability using the list_reservations tool?**
You don't use `list_reservations` for checking open slots. Use the `check_availability` tool instead; it is designed specifically to confirm if a time slot or experience is free.

**What should I do when I need guest history? Do I use search_guests?**
Yes, run `search_guests`. This tool provides the deep profile data you need, including their visit frequency and spending habits, which is key for targeted outreach.

**Can I list all available venues using list_venues?**
You can. `list_venues` gives you a master roster of every physical location associated with your CellarPass account, useful for multi-site planning.

**How does get_experience help me plan an event?**
`get_experience` pulls the full details—like duration and pricing—for a single tour type. This is vital when you need to present specific, structured options to a client.

**If I run `get_reservation` using an invalid booking ID, how should my agent handle the error?**
The system returns a specific 'Not Found' status code. Your AI client can catch this error and prompt you to check the reservation ID or try listing reservations by date instead.

**Can I use `list_experiences` to get the current pricing, duration, and capacity for all our offerings?**
Yes. Running `list_experiences` provides a comprehensive list that includes pricing structure, estimated duration, and maximum group capacity for every available tasting experience.

**When I run `check_availability`, does it account for multiple venue locations or different time zones?**
It handles both. You simply need to specify the venue ID and desired date range, and the tool cross-references all associated location schedules and time zone offsets automatically.

**What information do I need to pass to `get_venue` to retrieve its full operational details?**
You must provide the unique venue ID. This allows your agent to fetch everything, including operating hours, total capacity numbers, and specific location notes for that site.

**How many wineries use CellarPass?**
CellarPass serves 800+ wineries across Napa Valley, Sonoma, Oregon, Washington, and other premier wine regions. It's the #1 tasting room reservation platform.

**Can I flag or review VIP guest history using this integration?**
Yes! Your AI can pull visitor profiles and tag high-revenue VIPs, highlighting lifetime spend seamlessly when generating your daily prep reviews.

**Does it manage multiple tasting room venues?**
Correct. With 'Venues' configuration endpoints natively wired, the AI can cross-reference capacities against your separate tasting properties in a single conversational flow.