# MarketMan MCP

> MarketMan MCP manages every aspect of restaurant operations through conversation. It handles real-time inventory tracking, drafts purchase orders for vendors, analyzes recipes to calculate food costs, and monitors spoilage waste—all without needing to click tabs or copy spreadsheets.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** restaurant-management, food-cost-analysis, purchase-orders, waste-tracking, supply-chain-visibility

## Description

Need to know if you can actually open for service? This MCP connects your agent directly to the core intelligence platform that runs a restaurant. You talk to it naturally, and it pulls data on everything from stock levels to supplier history. It doesn't just tell you what you need; it helps you draft the actual purchase orders or identify recipes that are costing too much. The entire catalog of tools is managed via Vinkius, meaning your agent can access this restaurant intelligence alongside dozens of other systems you use daily.

Whether you’re checking current stock levels against par targets, reviewing supplier details, or generating a count sheet for the day, it all happens in conversation. You get accurate data on waste events and can analyze food costs per plate instantly.

## Tools

### list_inventory
Retrieves a list of all current inventory items, helping you check stock levels against par targets.

### list_purchase_orders
Lists existing purchase orders so you can track deliveries and review invoices from suppliers.

### list_vendors
Provides a comprehensive list of all vendors used by the restaurant, including their order history.

### list_categories
Lists inventory categories and shows item counts within each group for high-level tracking.

### get_count_sheets
Generates current inventory count sheets to help you track variance during manual audits.

### list_recipes
Lists all recipes in the system, allowing you to analyze ingredient quantities and food costs for menu engineering.

### get_waste_events
Retrieves records of waste events, helping you identify patterns in spoilage and reduce unnecessary loss.

### get_restaurant_info
Pulls general information about the restaurant location or entity for context.

## Prompt Examples

**Prompt:** 
```
Are we low on any inventory items?
```

**Response:** 
```
📦 **Low Inventory Alert**

⚠️ **Below Par Level**:
- 🥩 Ribeye: 8 lbs (par: 20) — **ORDER NOW**
- 🧈 Butter: 5 lbs (par: 15) — order by Friday
- 🍋 Lemons: 12 ct (par: 30) — order by Thursday

✅ Everything else is within range (47/50 items OK)
```

**Prompt:** 
```
Draft a purchase order for our primary produce vendor.
```

**Response:** 
```
I have prepared a draft purchase order for 'Fresh Farms Inc.' It includes 20 lbs of tomatoes, 15 lbs of onions, and 10 bunches of basil to bring you up to par levels. Total estimated cost is $145. Would you like to review?
```

**Prompt:** 
```
What is the current food cost percentage for our signature burger?
```

**Response:** 
```
The food cost for the Signature Burger is currently at 28.5%. The recent $0.50 increase in beef prices from your wholesale supplier raised the cost per portion by 3%.
```

## Capabilities

### Check Current Stock Levels
List every inventory item to see what's low or needs reordering.

### Manage Supplier Information
Access and organize details about all your vendors and their order history.

### Generate Procurement Lists
Create a list of current purchase orders, tracking deliveries and invoices for review.

### Analyze Menu Costs
List all existing recipes to analyze ingredient quantities and associated food costs.

### Track Spoilage
Review past waste events to identify patterns in spoilage and reduce losses.

### Audit Stock Counts
Pull up current inventory count sheets for detailed variance tracking during audits.

## Use Cases

### Running End-of-Day Inventory Checks
The manager asks their agent, 'What's our inventory status?' The agent uses list_inventory to identify three items below par levels and simultaneously runs get_count_sheets if the count was done manually. This prevents running out of key ingredients before morning service.

### Revising a High-Cost Menu Item
The head chef asks, 'What's the cost breakdown for the Signature Burger?' The agent uses list_recipes to retrieve the full ingredient data and calculate the current food cost percentage, flagging any expensive components.

### Handling a Supplier Dispute
The operations manager asks about a specific vendor. The agent uses list_vendors to pull up the supplier's full order history, allowing them to quickly prove discrepancies or track overdue deliveries.

### Planning for Peak Season Ordering
Instead of manually compiling lists, the manager asks to draft an order. The agent uses list_purchase_orders and compiles a draft request including needed items and expected costs from Fresh Farms Inc.

## Benefits

- Stop manually checking stock sheets. You ask about low items, and the agent immediately lists everything below par level using list_inventory.
- Drafting orders is fast. Instead of logging into a separate system to see what needs ordering, you just talk to your agent and it accesses purchase order data via list_purchase_orders.
- You can nail down food cost percentages quickly. Use the list_recipes tool to pull up all ingredients and analyze their quantities for menu tweaks.
- Vendor management is cleaner. You don't need to open multiple tabs; you simply ask for a vendor list using list_vendors and get order history right there.
- Waste tracking becomes proactive. The agent uses get_waste_events to show you where spoilage happens, helping you adjust your buying habits immediately.
- Auditing is simplified. Instead of printing physical sheets, the agent pulls up current count sheets via get_count_sheets for instant variance checking.

## How It Works

The bottom line is you get real-time operational insights without ever leaving your chat interface.

1. Tell your agent what data you need—for example, 'What's our stock level on beef?' or 'List all vendors.'
2. The MCP runs the appropriate tool against MarketMan and pulls the structured data (e.g., low inventory items, vendor lists, waste logs).
3. Your agent processes that raw data, presenting you with an immediate, conversational summary or a draft document ready for review.

## Frequently Asked Questions

**How does MarketMan MCP help with inventory counts?**
It simplifies physical audits by generating count sheets. Instead of starting from scratch, you can ask the agent to get_count_sheets for an accurate baseline when performing a manual stock take.

**Can I use MarketMan MCP to draft purchase orders?**
Yes, you can. The MCP pulls current order data and allows your agent to help draft the necessary purchase orders based on what needs replenishing or revising.

**Is MarketMan MCP better than a standard ERP system?**
It's different. A traditional ERP is where the data lives; this MCP uses natural conversation to access and analyze that data, presenting actionable insights instantly without requiring specialized queries or coding.

**What kind of waste tracking does MarketMan MCP provide?**
It gives you detailed records via get_waste_events. You can ask for past spoilage reports to identify patterns and reduce the money you lose to food waste.

**Does MarketMan MCP help with menu engineering?**
Absolutely. By listing recipes and analyzing ingredient quantities, it gives chefs the data needed to adjust portion sizes or swap expensive ingredients without impacting taste.