# LeafLink MCP MCP

> LeafLink MCP connects your AI agent directly into wholesale cannabis operations. Manage product listings, track inventory in real-time, process incoming orders, and update order statuses using natural language commands. Automate everything from catalog updates to fulfillment tracking without touching a dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** wholesale-marketplace, order-management, inventory-tracking, supply-chain, b2b-commerce

## Description

This connector lets you manage the full lifecycle of your wholesale business—from listing new products to fulfilling complex orders. You can ask your agent to check current stock levels for specific SKUs, list all pending buyer accounts, or pull up detailed information on any received order ID. If an order needs moving along, simply tell your agent to accept it or cancel it; it handles the status change right away. It also manages your product catalog, letting you create new listings and update inventory counts instantly based on sales data. Because this is integrated into Vinkius, your agent can access these tools alongside hundreds of others, giving you a single point of control for all your B2B commerce needs.

## Tools

### list_wholesale_brands
Returns a list of all registered brands within the account.

### create_new_product
Adds a product with full details to the wholesale catalog.

### list_wholesale_customers
Provides a roster of every buyer and customer in your network.

### get_order_details
Retrieves detailed information for one specific order ID.

### get_product_details
Gets all data points for a single product SKU.

### list_received_orders
Lists every wholesale order that has been received from buyers.

### list_wholesale_products
Pulls an inventory list of all available products in the catalog.

### update_order_status
Changes an order's status (accept, fulfill, cancel) within its lifecycle.

### update_product_inventory
Adjusts the current stock count for a specific product SKU.

## Prompt Examples

**Prompt:** 
```
Show me all active wholesale orders in LeafLink.
```

**Response:** 
```
I've retrieved your received orders. You have 8 active orders, including Order #ORD-101 from 'Green Valley Dispensary' and #ORD-102 from 'High Peak Wellness'. Would you like to see the details for any of them?
```

**Prompt:** 
```
Check the inventory level for 'Sour Diesel Flower 3.5g'.
```

**Response:** 
```
For 'Sour Diesel Flower 3.5g', I found 150 units currently in stock with 25 units reserved for pending orders, leaving 125 units available for wholesale.
```

**Prompt:** 
```
Accept the order #ORD-101.
```

**Response:** 
```
Successfully accepted order #ORD-101. Its status has been updated in LeafLink, and the buyer has been notified.
```

## Capabilities

### Create product listings
Adds brand-new products to the wholesale catalog with full details.

### Retrieve order information
Gets all necessary data points for a specific, existing order ID.

### Check product stock levels
Pulls real-time inventory counts and availability across the entire catalog.

### Manage wholesale orders
Lists all received buyer orders or moves an order through its lifecycle (accept, cancel, etc.).

### Update product inventory counts
Adjusts the stock level for any given SKU based on incoming shipments or sales.

## Use Cases

### Fulfilling an urgent order
A buyer calls about Order #ORD-102. Instead of checking the dashboard, the agent uses `get_order_details` to verify items and then runs `update_order_status` to mark it as 'fulfilled', giving instant confirmation.

### Catalog audit before a sale
Sales Director needs to know how many products exist. They ask the agent to run `list_wholesale_products`, which gives them the full, current inventory list in seconds for planning purposes.

### Handling new shipment receipts
The warehouse team just got a pallet of product X. The agent uses `update_product_inventory` to increase the stock count immediately, making it visible and available for sale without manual data entry.

## Benefits

- Process orders instantly. Instead of logging in to update an order, you just tell your agent to use `update_order_status` on Order #ORD-101, and the status updates immediately.
- Get real-time stock data without manual checks. You can check product availability for any item using `list_wholesale_products`, knowing the number is current.
- Streamline catalog maintenance. Need to add a new SKU? Use `create_new_product` directly via your agent, providing all necessary metadata and pricing details in one prompt.
- Maintain clear vendor visibility. Quickly list registered brands or buyers using `list_wholesale_brands` or `list_wholesale_customers`, keeping your wholesale network data current.
- Reduce fulfillment delays. When a shipment arrives, you can update the stock count right away with `update_product_inventory`, making the product available for sale immediately.

## How It Works

The bottom line is you tell your agent what you need done using plain English, and it executes the necessary API calls in the background.

1. Subscribe to this MCP and enter your LeafLink API Key (JWT Bearer Token) in Vinkius.
2. Connect your preferred AI client (Claude, Cursor, etc.) to the Vinkius catalog.
3. Use natural language prompts with your agent; it routes the request through the appropriate tool.

## Frequently Asked Questions

**How do I check inventory using LeafLink MCP?**
You simply ask your agent to list all products or check a specific SKU. The agent uses `list_wholesale_products` or `get_product_details` to pull real-time stock levels for you.

**Can I change an order status with LeafLink MCP?**
Yes, you can tell your agent to update the order status. It uses the `update_order_status` tool to move orders through their required lifecycle stages like accepting or cancelling.

**What if I need to add a new product? Which LeafLink MCP tool do I use?**
Use the `create_new_product` tool. You provide all the necessary product details in one go, and it adds the item directly to your wholesale catalog.

**Does LeafLink MCP handle buyer information?**
Yes. Your agent can list all registered buyers using `list_wholesale_customers` or get specific data on brands with `list_wholesale_brands`.

**How do I retrieve a complete list of all pending and past orders using the `list_received_orders` tool?**
The `list_received_orders` tool retrieves an exhaustive list of every wholesale order associated with your account. This allows you to quickly identify which buyers placed recent or historical purchases that require attention.

**What process should I use if I need to adjust inventory levels manually? How does `update_product_inventory` work?**
You use the `update_product_inventory` tool by specifying the exact product and the new stock quantity. This is essential for recording physical shipments, handling write-offs, or adjusting counts outside of a standard order cycle.

**How can I list all available products in my catalog to check pricing details? Do I use `list_wholesale_products`?**
Yes, the `list_wholesale_products` tool retrieves a comprehensive listing of every product you carry. This function provides crucial metadata and current pricing across your entire inventory for planning or auditing.

**What authentication credentials are needed to connect LeafLink MCP?**
This MCP requires your specific LeafLink API Key, which must be provided as a JWT Bearer Token. This ensures that only authorized agents can interact with your wholesale data securely.

**How do I update the inventory level for a product?**
Use the `update_product_inventory` tool with the unique product ID and the new total quantity. This will update the quantity field in LeafLink.

**Can I fulfill an order using the agent?**
Yes, use the `update_order_status` tool with the order number and set the action to 'fulfill' to transition the order status.

**Is it possible to see my buyer list?**
Absolutely. The `list_wholesale_customers` tool retrieves all organizational buyers and dispensary accounts registered in your LeafLink network.