# Commerce7 MCP MCP

> Commerce7 MCP connects your AI agent to run your entire winery business through natural conversation. It lets you manage customer profiles, track wine club memberships, check real-time inventory levels, and process orders—all without leaving your chat window.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** dtc-wine, wine-clubs, pos, inventory-management, customer-loyalty, order-management

## Description

Running a DTC winery requires juggling sales data, reservations, and stock counts across multiple systems. This MCP eliminates the manual work. You connect your AI agent to this connector through Vinkius and then talk to it like you're talking to an employee who has access to every single dashboard: customer records, POS transactions, club financials, and tasting room schedules. Need to know what wine was sold last week? Done. Want to check if the Estate Club still has allocated stock for the Cabernet? It knows instantly. You can ask your agent to pull up a specific customer's history, cross-reference it with their active coupon codes, and then list all outstanding orders—all in one conversation.

## Tools

### search_customers
Searches the entire customer database using name or email and returns comprehensive data like order history and club status.

### list_inventory
Provides a comprehensive count of all wine stock, broken down into available, allocated, and committed quantities.

### list_collections
Lists predefined groups used to organize different categories in the product catalog.

### list_coupons
Shows a list of active discount codes, including their expiration and remaining uses.

### get_customer
Fetches a specific customer's profile details using their unique identifier.

### list_orders
Filters and displays multiple past orders based on their status (pending, processing, fulfilled).

### get_order
Retrieves the full line-item breakdown and status for a single order number.

### list_products
Generates a full list of all wines available in the catalog, including vintage and score details.

### get_product
Pulls specific details, including tasting notes and pricing, for one wine product.

### list_clubs
Retrieves the names and status of all available wine clubs at the winery.

### list_club_members
Generates a list of active members belonging to a specific wine club.

### list_reservations
Lists upcoming tasting room bookings by date, allowing staff to plan daily capacity.

## Prompt Examples

**Prompt:** 
```
How many wine club members renewed this month?
```

**Response:** 
```
🍷 **Wine Club Report — October 2025**

👥 **Active members**: 1,247
- Reserve Club: 342 (27%)
- Estate Club: 589 (47%)
- Discovery Club: 316 (26%)

📈 **This month**:
- Renewals: 89 members
- New joins: 34
- Cancellations: 12
- Net growth: +22

💰 **Club revenue**: $187,400
📦 **Next shipment**: November 15 (Estate & Reserve)
```

**Prompt:** 
```
Show me the details for order number 'ORD-892'.
```

**Response:** 
```
Order #ORD-892. Customer: Jane Doe. Items: 3x Cabernet Sauvignon 2019, 1x Chardonnay 2021. Total: $245.00. Status: Shipped.
```

**Prompt:** 
```
Are there any reservations for the tasting room tomorrow?
```

**Response:** 
```
Yes, you have 4 reservations for tomorrow. Total guests: 12. First reservation is at 11:00 AM (Party of 4, VIP experience).
```

## Capabilities

### Search and manage customer data
Find any wine buyer by name or email to view their full purchase history, club status, and total lifetime value.

### Track all sales transactions
Retrieve detailed records of online purchases, POS sales, and specific line items for every order number.

### Manage wine club memberships
List members across different club tiers, track renewal counts, and manage allocation schedules using dedicated tools.

### Review available products and stock
Browse the entire wine catalog, including tasting notes and pricing, while simultaneously checking real-time inventory status (available vs. allocated).

### Handle reservations and events
View daily scheduling data for your tasting room, showing party size and the specific experience type booked.

### Check promotional codes and categories
Review active coupon usage limits or organize the wine catalog by category collections.

## Use Cases

### The VIP Customer Inquiry
A high-value client calls and asks about their account. Instead of having a staff member manually check multiple systems, your agent runs `search_customers` to pull up the profile, then uses `get_order` to show their last shipment details, all while confirming their club status.

### End-of-Day Inventory Reconciliation
The operations team asks: 'Based on today's POS sales and current allocations, what is our net available stock?' The agent runs `list_orders` for the day, then uses that data to update and report against `list_inventory`.

### Handling a Bulk Club Shipment
The director needs to confirm how many members in the Estate Club are eligible for this month's shipment. The agent runs `list_club_members` filtered by club type and cross-references the list against sales data.

### Pre-Event Readiness Check
The manager asks: 'Are we prepared for tomorrow's 12 guests?' The agent runs `list_reservations`, counts the parties, and immediately uses `get_product` to confirm if enough stock of high-demand wines is available.

## Benefits

- Stop manually cross-referencing data. Instead of checking the POS system for sales and then switching to a separate CRM for loyalty status, you can ask your agent to search customers and get both pieces of information immediately.
- Handle complex club management tasks instantly. Use `list_club_members` and `list_orders` together to find out which members haven't purchased in the last quarter—a huge win for retention efforts.
- Keep track of stock without opening inventory sheets. You can ask your agent if there's enough wine available by running a query against `list_inventory`, cross-referencing it with expected sales from `list_orders`.
- Tasting room planning is simplified. Ask the agent to check daily reservations using `list_reservations` and immediately see which products (`get_product`) might be best paired for those booked parties.
- Never lose a sale due to poor visibility. When a customer asks about a discount, your agent can use `list_coupons` to verify availability before you even look at the sales data.

## How It Works

The bottom line is, your AI agent runs complex business logic by calling specific functions in the background, so you only get one clean answer at the end.

1. Your AI agent identifies your need (e.g., 'What is Jane Doe's club status?').
2. The MCP intercepts this request, determines which specific tool to run (`search_customers`), and executes the call using Commerce7's API.
3. The raw data comes back—customer profile details, order history, etc.—and your AI agent formats it into a readable summary for you.

## Frequently Asked Questions

**How do I check a customer’s history using `search_customers`?**
You just provide their name or email. The agent returns a consolidated profile showing everything from club status to all past purchases, making relationship management straightforward.

**Can I use `list_orders` to find out how many units of wine were sold?**
Yes. You can run `list_orders` and ask the agent to summarize the total quantity of specific items, which is much faster than exporting raw data.

**What does `list_inventory` show me about stock levels?**
It gives you a breakdown that matters: it separates what's available for sale from what's already allocated to clubs or committed to pending orders. This prevents overselling.

**How do I check if a coupon is valid using `list_coupons`?**
You run `list_coupons` and ask the agent to filter by usage limits or expiry date, so you know immediately if it's still viable for sale.

**When I run `list_orders`, how do I filter results by a specific timeframe?**
You must specify date parameters in the query. This allows you to pull precise subsets of data, like all orders from last fiscal quarter or only shipments processed yesterday.

**If I use `get_product`, how can I confirm which collections that wine belongs to?**
The product details returned by this tool include metadata fields. These fields show exactly which existing collections, pricing tiers, and vintage categories apply to the specific item.

**What kind of identifier do I need for `get_customer` to find a profile?**
You must provide a unique key like an email address or phone number. The agent uses this single piece of data to pull the complete customer profile and associated order history.

**Can I use `list_reservations` to get all bookings for a whole week?**
Yes, you pass both a start date and an end date range when calling this tool. This provides a comprehensive view of every booking across the entire calendar period.

**How do I get Commerce7 API access?**
Visit developer.commerce7.com to register your application. You'll receive an App ID and Secret. Your winery's Tenant ID is your Commerce7 subdomain.

**What object types can I manage with this integration?**
You can manage customers, orders, club memberships, reservations, and inventory directly from the chat interface.

**Are the responses real-time?**
Yes, the AI connects directly to the Commerce7 API to provide real-time updates on your inventory and reservations.