# eCellar MCP

> eCellar MCP connects your winery's entire Direct-to-Consumer (DTC) operation—from tasting room bookings and customer profiles to inventory levels and club memberships—directly to your AI agent. Manage every aspect of premium wine sales conversationally.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** winery-management, dtc-sales, wine-clubs, pos-system, inventory-tracking, tasting-room

## Description

This connection lets you run a full, complex DTC winery business entirely through natural chat with your AI agent. You don't need to jump between the POS system, the CRM, and the warehouse inventory screen anymore. Need to know if a VIP customer has enough points for an allocation? Ask. Want to check stock levels across three different locations before confirming a large order? Get that data immediately. Whether you are handling daily reservations or planning long-term membership campaigns, this MCP pulls together every piece of information—customer history, current product pricing, and real-time inventory counts. It's everything needed for premium wine sales, all available inside the Vinkius catalog.

## Tools

### search_customers
Finds and summarizes customer history, including total spend, club membership, and visits.

### list_inventory
Shows the current stock levels across all physical storage locations.

### get_customer
Retrieves a specific customer's profile for personalized service details.

### list_orders
Lists multiple wine orders, including their payment status and fulfillment progress.

### get_order
Pulls up the full details of any single wine order.

### list_products
Retrieves the entire current product catalog used for sales and e-commerce listings.

### get_product
Provides comprehensive information and pricing for a specific wine product.

### list_clubs
Generates a list of active membership tiers and their revenue potential.

### list_club_members
Lists all current members of the wine club for retention planning.

### list_reservations
Displays a list of all upcoming tasting room bookings, filterable by date.

## Prompt Examples

**Prompt:** 
```
Who are our top 5 customers by lifetime spend?
```

**Response:** 
```
🍷 **Top 5 Customers — Lifetime Value**

1. **Michael & Sarah Henderson** — $47,200
   - Reserve Club member since 2018
   - 23 tasting room visits
   - Last order: Oct 2 (6x Estate Cab 2021)

2. **Jennifer Park** — $38,900
   - Founder's Circle since 2016
   - Prefers Bordeaux blends

3. **David & Lisa Chen** — $34,100
   - Estate Club, 18 visits

4. **Robert Williams** — $31,500
   - Reserve Club, corporate events

5. **Amanda Torres** — $28,700
   - Discovery Club → upgraded to Reserve 2024
```

**Prompt:** 
```
Search for inventory levels of the 2019 Reserve Cabernet.
```

**Response:** 
```
The 2019 Reserve Cabernet Sauvignon currently has 240 bottles on-hand at the main warehouse and 48 bottles available in the Tasting Room. 24 bottles are currently allocated for upcoming club shipments.
```

**Prompt:** 
```
Show me the reservation schedule for tomorrow afternoon.
```

**Response:** 
```
You have 12 reservations booked for tomorrow afternoon between 1:00 PM and 5:00 PM, totaling 45 guests. There are two VIP members arriving at 2:00 PM (the Hendersons and Robert Williams).
```

## Capabilities

### Identify and track VIP customers
Retrieve detailed customer profiles, including their lifetime spending history, club status, and past tasting room visits.

### Monitor all sales channels
Track every order placed—online, in the tasting room, or via phone call—with full line-item details.

### Manage wine club logistics
View and manage specific membership tiers, track available allocations, and check shipment schedules for members.

### Check current stock levels
Get real-time inventory counts across all physical locations: what's on hand versus what's reserved or allocated.

### Plan daily operations
View and manage the full schedule of tasting room bookings, filtering by date to prepare staff for the day.

## Use Cases

### A VIP client calls with an issue.
An agent asks, 'What's the status of Ms. Jones?' The system uses `search_customers` to confirm her lifetime spend and club membership, then checks `get_order` history for the last three months, giving the team a perfect answer on the spot.

### Checking if an allocation is possible.
The operations manager asks about 2019 Reserve Cab. The agent runs `list_inventory` to confirm available stock and then uses `get_product` to check the current list price before confirming the sale.

### Coordinating a large, multi-stage shipment.
The director asks for all orders going out next week. The agent calls `list_orders`, filters by date, and then uses `get_product` details to ensure every line item is correctly documented.

### Staffing the tasting room for a busy day.
The manager needs to know how many guests are coming. The agent calls `list_reservations` and cross-references that count with the total wine catalog using `list_products` to prepare staff on offerings.

## Benefits

- Stop searching for customer history. You can use `search_customers` to instantly pull up a person's total spend, club status, and tasting room visits in one go.
- Tasting room prep is faster than ever. Use `list_reservations` to view the day's schedule and get an immediate headcount for staff planning.
- Inventory control becomes simple. Checking stock across multiple sites happens instantly with `list_inventory`, so you never promise a bottle that isn’t there.
- Never lose track of sales details again. Running `list_orders` gives you the complete picture—line items, total cost, and whether it shipped or not.
- Planning for the future is easier. You can check potential revenue streams by running `list_clubs`, helping guide your wine club marketing efforts.

## How It Works

The bottom line is that instead of manually running five reports in different tabs, your AI client pulls everything together instantly.

1. Start by telling your AI agent who you need information on—maybe a customer's name or an order ID.
2. The MCP runs background checks, calling multiple tools like `search_customers` and `list_orders` to gather all relevant data points.
3. Your agent then synthesizes the results into one simple, natural-sounding answer for you.

## Frequently Asked Questions

**How does the eCellar MCP use `list_orders`?**
`list_orders` lets you see all past sales, giving you a clear view of line items, total amounts paid, and whether the order was fulfilled or still pending.

**Can I find out what wine clubs exist using `list_clubs`?**
Yes. The `list_clubs` tool gives you a list of all current membership tiers in your system, which is essential for planning new revenue streams.

**How do I use `search_customers` to find spending info?**
`search_customers` searches by name or email and returns profile details like total lifetime spend, club status, and a history of their visits for personalized recommendations.

**Does eCellar MCP help with reservations? (using `list_reservations`)**
Absolutely. By using `list_reservations`, you can view the full schedule of tasting room bookings, making daily prep and staff scheduling simple.

**How does using `list_products` help me manage the wine catalog?**
It gives you core data on every product, including pricing, tasting notes, and current stock levels. This makes it easy to populate a comprehensive e-commerce storefront or POS system.

**What key information can I get about inventory using `list_inventory`?**
You get a real-time breakdown across all locations: available for sale, allocated for clubs, and total on hand. This precise tracking prevents overselling and helps with planning.

**Does `list_club_members` provide enough detail for marketing campaigns?**
Yes. It lists comprehensive membership records that go beyond just names, allowing you to track engagement history and plan highly targeted communication efforts based on club status.

**When I use `get_order`, what fulfillment details can my AI agent access?**
The tool provides full line items, total payment records, and the order's current fulfillment status. This gives operations teams a clear view of where every purchase stands in the pipeline.

**How is eCellar different from Commerce7?**
eCellar is an all-in-one DTC platform popular with ultra-premium Napa Valley and Sonoma wineries. It includes CRM, ecommerce, POS, wine clubs, and reservations in a unified system with full REST API.

**Does this integration require additional licensing from eCellar?**
No, the Exchange REST API is generally available to all eCellar customers. You simply need to request your unique API Key and Secret from the eCellar support team as mentioned in the instructions.

**Can I manage reservations with this tool?**
Yes! The integration provides full access to your reservation and booking systems, allowing you to quickly query upcoming visits, manage guest lists, and track tasting room capacity.