# Dutchie Plus MCP

> Dutchie Plus connects your agent directly to enterprise dispensary operations. You can list every location in your network, monitor online menus across all stores, track complex order fulfillment history, and audit synchronized product brands using natural conversation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** dispensary-operations, online-menu, order-fulfillment, multi-location, retail-tech, cannabis-compliance

## Description

Running a multi-location cannabis retail business means juggling tons of data: which store has what menu active, who placed an order, and if the stock counts match up. This MCP lets you manage all that from one place. Your agent can pull details for every dispensary location, check current online menus by category, or look at the fulfillment status of any specific online order. You won't have to jump between separate dashboards just to get a full picture. It’s like having an operations manager sitting with your AI client, instantly checking inventory and processing orders across the entire network. Connecting this integration via Vinkius means you can route all that location, menu, and order data directly through your preferred AI client, no matter what platform it runs on.

## Tools

### get_dutchie_plus_metadata
Retrieves technical metadata and usage limits for your Dutchie Plus account.

### get_location_details
Gets detailed settings and information about a single dispensary location.

### get_order_details
Provides complete details for one specific online order, including payment status.

### quick_enterprise_volume_audit
Pulls a high-level summary of order activity across multiple locations for quick review.

### list_pending_fulfillment_orders
Identifies which online orders are ready to be picked up or need fulfillment right now.

### list_synced_brands
Lists all product brands that have been synchronized into your entire enterprise account.

### list_dispensary_locations
Lists all dispensary locations that are managed within your Dutchie Plus account.

### list_online_menus
Lists all configured online menus and their details for a specified store location.

### list_enterprise_orders
Retrieves a list of recent online orders for one specific, selected dispensary location.

### search_dispensaries_by_city
Searches and finds dispensary locations using a keyword like a city or store name.

## Prompt Examples

**Prompt:** 
```
List all our dispensary locations.
```

**Response:** 
```
I've found 8 locations in your network, including 'Downtown Dispensary' (San Francisco) and 'Airport Plaza' (Los Angeles). Would you like to see the current online menu URL for Downtown?
```

**Prompt:** 
```
Show me the pending online orders for location 'LOC-12345'.
```

**Response:** 
```
For 'Downtown Dispensary' (LOC-12345), there are 5 pending online orders, including 'WEB-99' (Ready for Pickup) and 'WEB-101' (Awaiting Fulfillment). Should I pull the items list for WEB-99?
```

**Prompt:** 
```
List all synchronized brands in our account.
```

**Response:** 
```
I've retrieved 12 synchronized brands, including 'Nature's Own', 'Indica Gold', and 'Pure CBD'. 'Nature's Own' has 45 associated products in your catalog. Would you like to see the brand details for Indica Gold?
```

## Capabilities

### List dispensary locations
Retrieve a complete list of every physical store managed in the Dutchie Plus account.

### Check location details
Get detailed configuration and real-time status information for one specific store location.

### Review online menus
Access the currently configured online menu, including categories and preview URLs, for any selected location.

### Track individual orders
Pull all detailed information—including payment status and fulfillment history—for a single customer order.

### Monitor pending orders
Identify which online orders are waiting for pickup or need to be fulfilled right now.

### Audit product brands
List and retrieve all product brands that are currently synchronized across the entire enterprise account.

## Use Cases

### A regional manager needs a daily performance snapshot.
The agent runs `list_dispensary_locations` first, then uses `quick_enterprise_volume_audit` to pull the latest sales numbers for every store. This gives the manager a single report they can review in minutes without logging into dozens of systems.

### An e-commerce specialist needs to fix an outdated menu.
The agent uses `list_online_menus` and then runs `get_location_details` for the specific store. This confirms which categories are available online, letting the specialist know exactly what parts of the menu need updating.

### A fulfillment team needs to process a rush of orders.
The agent calls `list_pending_fulfillment_orders` for the specific store location. This immediately flags all orders that are sitting in the queue, letting the team prioritize their workflow and get them out the door.

### A corporate buyer needs to reconcile brand counts.
The agent runs `list_synced_brands` across the whole account. This provides a master list of all synchronized brands, including product counts, allowing the buyer to audit inventory before placing new bulk orders.

## Benefits

- Stop manually checking dashboards. You can ask your agent to run a quick audit of order activity across all stores using `quick_enterprise_volume_audit`—it's instant.
- Never worry about local menu discrepancies again. Use `list_online_menus` and `get_location_details` to verify that the current online offering matches what your physical store stocks.
- Track down orders faster than before. Instead of clicking through pages, you can use `list_pending_fulfillment_orders` to get a single list of everything awaiting pickup or fulfillment.
- Centralize brand visibility. Need to know which products are available company-wide? Running `list_synced_brands` gives you an instant inventory map across your entire network.
- Verify store presence easily. If you're planning new marketing, use `search_dispensaries_by_city` to quickly find and confirm locations by name or city.

## How It Works

The bottom line is that you use conversation to orchestrate complex operational queries across multiple systems at once.

1. Connect this MCP to your AI client. You'll need a valid Dutchie Plus API Key, found in your enterprise settings.
2. Authorize the connection using that key. This lets your agent talk to the system on your behalf.
3. Tell your agent what you need—for example, 'List all locations and check the online menu for the Downtown store.' The MCP runs the calls and sends back the data.

## Frequently Asked Questions

**How do I find out if my store is in the network using list_dispensary_locations?**
Run `list_dispensary_locations`. This tool will return an exhaustive list of every managed site, giving you all the necessary IDs and names to start building reports.

**What is the best way to check pending orders using list_pending_fulfillment_orders?**
To get a focused view, you should first identify the correct store ID. Then use `list_pending_fulfillment_orders` and specify that location's ID to narrow down the results.

**Can I audit my brands using list_synced_brands?**
Yes, running `list_synced_brands` gives you a complete inventory of every brand synced across your entire enterprise account, along with associated product counts.

**How do I check the online menu for one store? (list_online_menus)**
You need to provide the location ID first. Then, calling `list_online_menus` will pull all configured menus and their details specifically for that single, designated store.

**How do I check my rate limits or usage quotas using get_dutchie_plus_metadata?**
This tool retrieves your account's current metadata, including API limitations. It lets you know exactly what endpoints you can call and how many times per period. You don't have to guess if your request is failing due to a quota issue.

**How do I pull all historical order data using list_enterprise_orders?**
The tool provides detailed information for every recent online order associated with a specific dispensary location. You get the full history, including payment status and complete fulfillment records, making auditing simple.

**Is quick_enterprise_volume_audit reliable for generating reports?**
It generates a high-level summary of order activity across multiple locations quickly. This is great for immediate reporting needs, giving you an instant pulse on your whole network's sales volume.

**How do I find a store if I don't know its exact ID using search_dispensaries_by_city?**
You simply give the tool a city or name keyword, and it searches for matching dispensary locations. This saves time by finding the right location without needing to list every single site first.

**How do I get a Dutchie Plus API Key?**
Log in to your Dutchie Plus enterprise dashboard, navigate to the **API** or **Integrations** section in your enterprise settings, and you can generate your unique API Key from there.

**Can the agent manage inventory levels?**
Dutchie Plus primarily manages the online e-commerce layer. Inventory levels are typically managed in the underlying POS (like Dutchie POS). This integration focuses on menus and online orders.

**Does it support multi-location reporting?**
Yes, you can use the list_dispensary_locations tool to see all sites and then query orders or menus for any specific location in your network.