# Dutchie POS MCP

> Dutchie POS equips your AI agent to handle everything from product catalog management and real-time inventory tracking to order fulfillment monitoring for cannabis dispensaries. It lets you check current stock, identify low batches, run sales audits, and look up customer records all through natural conversation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** point-of-sale, sku-management, real-time-inventory, loyalty-programs, retail-analytics, batch-tracking

## Description

This MCP connects the Dutchie POS system—the industry standard for retail dispensary operations—to your AI workflow. You can manage everything from product details to fulfillment status using plain language. Need to know what's selling? Check recent sales activity summaries instantly, or pull detailed information on a specific order using its ID. Inventory tracking is granular; you don't just see total stock numbers. You track lot numbers and batch details across your entire location. Plus, you can list all registered customers in the POS system. Integrating this through Vinkius gives your agent access to thousands of other services, letting you handle inventory, orders, and customer records all from one place.

## Tools

### get_dutchie_pos_metadata
Retrieves general account settings and usage limits for your Dutchie POS connection.

### get_order_details
Fetches full details for a single, specific retail order using its unique ID.

### get_product_details
Gets all settings and information related to one product SKU or catalog item.

### quick_pos_sales_audit
Generates an instant, high-level summary report covering recent sales activity metrics.

### list_pos_customers
Retrieves a list of every customer profile registered in the POS system.

### list_current_inventory
Outputs a list of every inventory lot held on site, including quantities for each batch.

### list_low_stock_inventory
Identifies and lists all specific product lots that fall below your defined stock quantity minimums.

### list_retail_orders
Lists all recent retail orders placed through the dispensary's point-of-sale system.

### list_retail_products
Outputs a list of every product available in your entire Dutchie POS catalog.

### search_catalog_products
Searches the entire product database using keywords or a specific SKU to narrow down results.

## Prompt Examples

**Prompt:** 
```
List all products in the 'Flower' category.
```

**Response:** 
```
I've found 15 products in the Flower category, including 'Blue Dream' and 'Sour Diesel'. Would you like to see the current inventory level for Blue Dream?
```

**Prompt:** 
```
Show me our low stock inventory items.
```

**Response:** 
```
The following items are below the threshold: 'Indica Gummies' (3 units left) and 'CBD Tincture' (2 units left). 5 other items are also low. Should I pull the batch numbers for these items?
```

**Prompt:** 
```
Check the status of retail order 'ORD-5544'.
```

**Response:** 
```
Order 'ORD-5544' is currently 'FULFILLED'. It was a Cash transaction totaling $125.00 for customer 'John Doe'. Should I list the individual line items for this order?
```

## Capabilities

### Check real-time stock levels
List every product lot currently in stock and its precise quantity.

### Identify low-stock items
Pinpoint exactly which inventory lots are below a set threshold, saving you time searching through records.

### Retrieve order details
Get complete information about any specific retail transaction, including payment type and customer info.

### Search product catalog
Find products quickly using a name keyword or SKU number instead of browsing categories.

### Audit sales activity
Pull high-level summaries of recent daily sales and customer volumes immediately.

## Use Cases

### Checking Stock Before Ordering
An inventory specialist needs to know if the store can handle a massive rush. They ask their agent to `list_low_stock_inventory` for all 'Flower' products and then use `list_retail_products` to confirm which specific SKUs need immediate attention.

### Investigating an Old Customer Sale
A manager needs to verify the details of a transaction from last week. They ask the agent to `list_retail_orders`, find the relevant ID, and then call `get_order_details` to confirm everything about that customer's purchase.

### Quick Daily Sales Check
At the end of a shift, the lead just needs a summary. Instead of printing reports, they ask for a sales audit, triggering `quick_pos_sales_audit` to get immediate metrics on customer volume and revenue.

### Finding a Specific Item
A team member remembers the product name but not the SKU. They tell their agent to `search_catalog_products` using keywords, which immediately returns options from the full catalog without needing category filters.

## Benefits

- Instantly audit sales activity. Instead of running multiple reports to gauge performance, the `quick_pos_sales_audit` tool gives you a high-level summary right when you ask for it.
- Maintain compliance with batch tracking. The ability to call `list_current_inventory` lets you verify exact lot numbers and quantities across all products in seconds.
- Never miss a sale detail again. By using `get_order_details`, your agent can pull specific transaction data, like payment type or customer name, for any given order ID.
- Quickly update product knowledge. Need to know the full specs on an SKU? Use `get_product_details` instead of navigating through the entire catalog menu.
- Control inventory shortages proactively. The `list_low_stock_inventory` tool pinpoints exactly which items need reordering, saving you from running out of key sellers.

## How It Works

The bottom line is: you talk to your agent like talking to a coworker who has instant access to every record in your dispensary system.

1. Connect your AI agent to this MCP via Vinkius.
2. Authorize the connection using your Dutchie POS API Key (found in your settings).
3. Tell your agent exactly what you need—for example, 'List all products that are low on stock'—and it executes the necessary data calls.

## Frequently Asked Questions

**How do I check stock levels using list_current_inventory?**
You tell your agent to `list_current_inventory`. It immediately returns a comprehensive breakdown of every product lot and its current, exact quantity available across the whole store.

**What is get_product_details used for in Dutchie POS?**
`get_product_details` lets you pull all technical specifications for a single item. This means getting more than just the name, like regulatory details or specific batch requirements.

**How do I find out what customers bought last week using list_retail_orders?**
You ask your agent to `list_retail_orders`. It pulls a chronological record of all recent sales, allowing you to review who bought what and when.

**Can I search for products by name or SKU using search_catalog_products?**
Yes. You use `search_catalog_products` with keywords or an exact SKU. It searches the entire catalog database to find matches, skipping manual browsing.

**Before I run any major reports, how do I verify my API connection status using get_dutchie_pos_metadata?**
You call this tool to check your account limits and metadata first. It confirms that the MCP has the necessary permissions to interact with your POS system before you run larger queries.

**If I need comprehensive details for a single transaction, how does get_order_details work?**
You simply provide the unique order ID to this tool. It pulls every line item, payment type, and customer association tied specifically to that one sale.

**What is the specific purpose of list_low_stock_inventory for managing inventory?**
Running this tool identifies all items below your set quantity threshold. It’s essential for proactive restocking and quickly addressing compliance issues before stock runs out.

**How do I get a full roster of users by using list_pos_customers?**
This tool lists every customer registered in your POS organization. You can pull contact data, loyalty status information, and historical records for all accounts.

**How do I get a Dutchie POS API Key?**
Log in to your Dutchie POS (Greenbits or LeafLogix) back office, navigate to the **Integrations** or **API** section in your settings, and you can generate your unique API Key from there.

**Can the agent update product pricing?**
This integration currently focuses on listing and auditing products, inventory, and orders. Modifying prices or inventory quantities should be managed via the Dutchie POS back office.

**Does it support lab results tracking?**
Yes, you can use the get_product_details tool to retrieve technical metadata which includes batch-level lab result data stored in Dutchie POS.