# Lightspeed Restaurant MCP

> Lightspeed Restaurant MCP lets your AI agent talk to your entire point-of-sale system. Check daily revenue reports, track every open order, update menu prices instantly, and see which tables are available for service—all through natural conversation.

## Overview
- **Category:** business-operations
- **Price:** Free
- **Tags:** inventory-management, order-tracking, payment-processing, analytics, staff-management, menu-management

## Description

This MCP connects any compatible AI client directly to the Lightspeed POS backend. Instead of jumping between dedicated dashboards and running manual reports, your agent accesses live data across orders, inventory, payments, and staff records. You can ask it to pull a detailed daily report showing gross sales versus net revenue, or check if specific menu items need price updates. It’s about getting answers immediately—for instance, asking for all open tables in the patio section right now. Because this connection is managed by Vinkius, you get access to one single catalog point that covers everything from staff roster management to tracking complex split-check payments.

## Tools

### list_orders
Retrieves a list of sales orders, useful for quickly checking what sold in a specific time frame.

### get_business
Pulls core general information about the restaurant location or business profile.

### get_order
Fetches complete, detailed records for a single specific customer order.

### list_menu_items
Lists every item sold on the menu, which is helpful for pricing audits and inventory checks.

### list_categories
Provides a breakdown of all menu sections, including how many items belong to each group.

### list_floors
Lists the physical dining areas and provides metrics like total table count and overall capacity for each floor.

### list_tables
Gets a list of all individual tables within the restaurant setup.

### list_employees
Retrieves information on staff members, including their roles and current clock status.

### list_payments
Lists recorded payment transactions for review or reconciliation.

### get_revenue_report
Generates a comprehensive daily management report detailing gross sales, net revenue, discounts, taxes, and tips.

## Prompt Examples

**Prompt:** 
```
Give me the revenue report for today
```

**Response:** 
```
⚡ **Revenue Report — Oct 18**

💰 Gross: $6,240 | Net: $5,810 | Discounts: $180 | Taxes: $430 | Tips: $720
```

**Prompt:** 
```
Update the price of the Margherita Pizza to $18.
```

**Response:** 
```
I have updated the price of the Margherita Pizza in the dinner menu from $16 to $18. The change is now synced across all active POS terminals.
```

**Prompt:** 
```
Which tables are currently available in the patio section?
```

**Response:** 
```
In the patio section, tables 12, 14, and 15 are currently available and clean. Table 16 is occupied, and table 18 is scheduled for a reservation in 20 minutes.
```

## Capabilities

### Track real-time sales and orders
Retrieve details on all transactions in a given time frame, including items sold, modifiers, tips, and voids.

### Manage menu data
List available menu items and categories to check pricing or availability for updates.

### Check table status and seating capacity
See a list of dining areas, including how many tables are in each section and their current occupancy.

### Audit employee records
Access the full staff roster to check roles, clock-in status, or performance metrics.

### Run financial reports
Generate management summaries that detail daily gross revenue, taxes collected, discounts applied, and tips distributed.

## Use Cases

### The End-of-Day Reconciliation
A manager needs to reconcile cash payments against digital sales. Instead of manually pulling reports, they ask the agent for a revenue report and then use `list_payments` to cross-reference every transaction type (cash vs card), ensuring zero discrepancies.

### Handling Unexpected Rush Hours
A shift lead sees the dining room getting crowded. They ask the agent which tables are currently available in the patio section using `list_tables` and instantly direct guests, avoiding bottlenecks at occupied spots.

### Price Change Verification
The kitchen changes a signature dish's ingredients, requiring a price change. The manager uses `list_menu_items` to verify the current pricing of that item across all categories before submitting an update.

### Investigating Missing Sales
A payroll issue is flagged because employee hours seem off. The supervisor asks the agent for a list of employees and their clock status using `list_employees`, isolating which staff members need immediate review.

## Benefits

- Stop manually running revenue reports. Just ask your agent for the 'daily gross/net' report; it instantly compiles data from all transactions using `get_revenue_report`.
- No more guessing about seating capacity. Check current floor plans and table counts with `list_floors` to ensure you match staffing levels to demand.
- Audit menu changes in seconds. Use `list_menu_items` or `list_categories` to verify pricing across the board before a promotional period starts.
- Simplify shift handoffs. Quickly pull staff rosters and check roles using `list_employees`, so every supervisor knows who is clocked in and where they are needed.
- Track sales activity on demand. If you need to know what was sold in the last hour, simply call `list_orders` instead of digging through complex transaction logs.

## How It Works

The bottom line is, your AI client acts as a universal dashboard, allowing you to ask questions that used to require logging into multiple separate systems.

1. You prompt your AI agent with a natural language request, like 'What was the net profit from last night?'
2. The MCP translates that query into specific API calls to the Lightspeed system.
3. Your agent receives structured data (like sales figures or table lists) and presents it back to you in plain English.

## Frequently Asked Questions

**Can Lightspeed Restaurant MCP track voids and tips?**
Yes, the MCP tracks detailed order information. It records items sold, modifications, tips left by customers, and any voided orders, which is crucial for accurate revenue auditing.

**How do I check table availability using Lightspeed Restaurant MCP?**
You can use the floor plan tools to get a list of tables. The agent shows you which specific sections are currently available and if any tables have upcoming reservations.

**Does this MCP help with staff scheduling or payroll?**
It helps with status, not scheduling. You can pull the current roster and check employees' clock-in/out status using the employee list tool to verify who is working right now.

**Can I update menu prices directly with Lightspeed Restaurant MCP?**
Yes, you can instruct your agent to update item pricing. It manages these changes and ensures they are synced across all active POS terminals in the system.

**How does getting a revenue report work with Lightspeed Restaurant MCP?**
You simply ask for the manager's daily report. The MCP compiles gross sales, net earnings, discounts, and taxes into one summary view.