# GoTab MCP

> GoTab MCP connects your GoTab Point-of-Sale and commerce account directly to your AI agent. It lets you manage complex restaurant operations—from updating menu availability and checking real-time orders to reviewing active customer tabs—all through simple conversation, without ever opening the manager dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** pos, restaurant-management, menu-management, order-processing, hospitality

## Description

Managing a busy restaurant involves juggling multiple screens: the POS terminal, the kitchen display system, the inventory sheet, and the guest check list. This MCP handles that chaos by giving your AI agent direct access to all GoTab data. You can use natural language commands to manage everything from menu details to live order flow. Need to mark 'Truffle Fries' as sold out because you ran out? Tell your agent. Want to know if Sarah P.'s tab is paid up or what items she just ordered? Just ask. The system pulls the current tab balance, recent orders, and item status instantly. Because this MCP lives on Vinkius, connecting it through any compatible client means you get a unified view of your entire restaurant operation in one chat interface.

## Tools

### get_item
Retrieves detailed information for a specific product on the menu.

### get_location
Gets operational details for one selected physical store location.

### get_menu
Fetches all available details for a specific restaurant menu.

### get_order
Retrieves full details about one particular customer order.

### get_tab
Gets the current balance and status of a single guest tab.

### list_categories
Lists all defined groups or sections within a menu structure.

### list_items
Returns a comprehensive list of all available products for a given location.

### list_locations
Provides a master list of every accessible store or venue ID.

### list_menus
Lists all defined menus available for a specific location to check which is active.

### list_orders
Provides a list of the most recent customer orders placed at a location.

### list_tabs
Displays both currently open and previously closed tabs for easy account review.

### update_item_status
Changes the availability status of a product, such as marking it sold out (86'd).

## Prompt Examples

**Prompt:** 
```
Mark the 'Truffle Fries' (Item ID 883) at location 12 as sold out.
```

**Response:** 
```
Updating item... Success! I've marked Item ID 883 ('Truffle Fries') as 'sold_out' for location 12. It will no longer be available for order on the digital menu.
```

**Prompt:** 
```
Show me the details of Tab ID 93021.
```

**Response:** 
```
Fetching tab details... Tab #93021 is currently 'OPEN' under the name 'Sarah P.'. The current total is $45.50. Recent items ordered include 2x 'House Margarita' and 1x 'Calamari'.
```

**Prompt:** 
```
List all incoming orders that are currently queued in the kitchen for Location 1.
```

**Response:** 
```
Checking active ticket flow...
There are presently 3 live orders queued in prep queues globally. Would you like me to expand ticket #A22 specifically?
```

## Capabilities

### Update Menu Item Availability
Mark specific menu items as sold out or update their details instantly.

### Check and Track Customer Tabs
Retrieve current totals, status (open/closed), and recent charges for any guest tab.

### Review Live Order Status
Get details on specific orders or view a list of all incoming tickets across multiple locations.

### Manage Location Data
List and retrieve operational data for different physical venues managed by GoTab.

## Use Cases

### Running Low on Stock
The manager notices the chef just ran out of the special. Instead of finding an employee and manually logging into the POS system, they simply tell their agent to mark 'Truffle Fries' as sold out using `update_item_status`. The menu instantly reflects the change.

### Handling a Difficult Customer
A customer claims an item was charged twice. Instead of needing the employee to pull up multiple screens, the support agent asks the AI client for all details on that guest's tab using `get_tab`. The current total and transaction history appear immediately.

### Coordinating Multiple Locations
The F&B Director needs to know if a specific item is available at the downtown branch versus the airport location. They ask the agent to list items for both locations, cross-referencing data using `list_items` and `get_location`.

### Reviewing Daily Operations
At closing time, the manager needs a quick snapshot of all activity. They ask their agent to list recent orders across all venues (`list_orders`) to ensure everything was accounted for before generating end-of-day reports.

## Benefits

- Stop clicking through dashboards. Instead of navigating to a separate tab page just to check if an item is available, simply ask your agent, and it executes the `update_item_status` tool instantly.
- Handling customer disputes used to mean manually looking up old receipts or past transactions. Now, asking the agent to list tabs gives you instant access to all necessary history using the `list_tabs` tool.
- You don't have to open the full GoTab manager dashboard just to know what's happening in the kitchen. You can use your agent to view recent orders and monitor live ticket flow using `list_orders` and `get_order`.
- Managing multiple stores is easier than ever. Instead of logging into several systems, you simply ask to list all accessible locations (`list_locations`) and get centralized operational data for each venue.
- Menu updates are streamlined. You can use the agent to browse categories (`list_categories`) or pull item details using `get_item`, ensuring your menu information is always current before a new promotion launches.

## How It Works

The bottom line is that you manage complex restaurant systems by chatting with them instead of clicking through dashboards.

1. First, subscribe to this MCP and provide your unique GoTab API Access ID and Secret credentials.
2. Next, connect the MCP through any compatible client like Claude or Cursor. Your agent now has read/write access to all connected GoTab data.
3. Finally, start talking to your agent using plain language commands—like asking, 'What's the status of tab 93021?'—and it executes the necessary actions.

## Frequently Asked Questions

**How does GoTab MCP help me manage inventory status?**
You use the `update_item_status` tool. You can tell your agent to mark any item as sold out (86'd) across all digital menus instantly, without touching the POS system.

**Can I check past orders using GoTab MCP?**
Yes. The `list_orders` tool lets you retrieve a history of recent customer orders for any location. You can then get specific details on an older order using `get_order`.

**Does GoTab MCP cover multiple store locations?**
Absolutely. You first use the `list_locations` tool to see all your venues, and then you can run queries like listing items or orders for any specific location ID.

**Is checking tabs done via GoTab MCP safe?**
Yes, it's designed for accuracy. The `get_tab` tool retrieves the current total and status directly from the connected POS, giving you a real-time picture of outstanding balances.

**What if I need to update menu categories?**
While there isn't one tool for categories, you can start by using `list_categories` to see all groups, and then use the `get_menu` tool to understand how those sections relate to items.