MCP 服务器

Toast MCP Server

Enables AI assistants to manage restaurant operations by integrating with Toast POS, including orders, menus, employees, payments, inventory, and reporting through 50+ tools and 18 React apps.

README

Toast MCP Server

Complete Model Context Protocol (MCP) server for Toast restaurant POS and management platform integration.

🚀 Features

50+ Tools Across 10 Categories

Orders (12 tools) - Complete order lifecycle management
- Get, list, create, void orders
- Search by customer, business date
- Add/void selections, apply discounts
- Update promised times, track status
Menus (11 tools) - Full menu and item management
- List/get menus, groups, items
- Search items, update pricing
- 86 management (out of stock)
- Bulk operations
Employees (9 tools) - Staff management
- Employee CRUD operations
- Job position management
- Search and filtering
- Time entry tracking
Labor (6 tools) - Workforce analytics
- Shift management
- Active shift tracking
- Labor reports and summaries
- Employee hours calculation
Restaurant (9 tools) - Configuration and settings
- Restaurant info and access
- Tables and service areas
- Dining options, revenue centers
- Online ordering and delivery settings
Payments (6 tools) - Transaction management
- Payment CRUD operations
- Refunds and voids
- Payment summaries by type
Inventory (5 tools) - Stock management
- Stock level tracking
- Low stock alerts
- Quantity updates
- Bulk operations
Customers (4 tools) - Customer relationship management
- Customer search and profiles
- Order history
- Loyalty program integration
- Top customers analysis
Reporting (6 tools) - Analytics and insights
- Sales summaries
- Hourly breakdown
- Item sales reports
- Payment type, discount, and void reports
Cash (8 tools) - Cash management
- Cash drawer tracking
- Paid in/out entries
- Deposit recording
- Drawer summaries

18 React Apps (Client-Side UI)

Orders & Service:

Order Dashboard - Real-time monitoring
Order Detail - Deep order inspection
Order Grid - Multi-order management
Table Map - Visual floor plan

Menu Management:

Menu Manager - Full menu editing
Menu Item Detail - Item configuration
Menu Performance - Sales analytics

Staff & Labor:

Employee Dashboard - Staff directory
Employee Schedule - Shift planning
Labor Dashboard - Cost tracking
Tip Summary - Earnings distribution

Payments & Finance:

Payment History - Transaction log
Sales Dashboard - Comprehensive metrics
Revenue by Hour - Hourly analysis

Inventory & Operations:

Inventory Tracker - Stock management
Restaurant Overview - System config

Customer Management:

Customer Detail - Profiles and history
Customer Loyalty - Rewards tracking

📦 Installation

npm install @busybee3333/toast-mcp-server

Or clone and build locally:

git clone https://github.com/BusyBee3333/mcpengine.git
cd mcpengine/servers/toast
npm install
npm run build

🔧 Configuration

Set required environment variables:

export TOAST_CLIENT_ID="your_client_id"
export TOAST_CLIENT_SECRET="your_client_secret"
export TOAST_RESTAURANT_GUID="your_restaurant_guid"  # Optional
export TOAST_ENVIRONMENT="production"  # or "sandbox"

🎯 Usage

Stdio Mode (MCP Integration)

toast-mcp-server

Or via npx:

npx @busybee3333/toast-mcp-server

HTTP Mode (Web UI + API)

TOAST_MCP_MODE=http TOAST_MCP_PORT=3000 toast-mcp-server

Access UI at: http://localhost:3000/apps/

Claude Desktop Integration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "toast": {
      "command": "npx",
      "args": [
        "@busybee3333/toast-mcp-server"
      ],
      "env": {
        "TOAST_CLIENT_ID": "your_client_id",
        "TOAST_CLIENT_SECRET": "your_client_secret",
        "TOAST_RESTAURANT_GUID": "your_restaurant_guid",
        "TOAST_ENVIRONMENT": "production"
      }
    }
  }
}

🛠️ Tool Examples

Get Order

{
  "name": "toast_get_order",
  "arguments": {
    "orderGuid": "550e8400-e29b-41d4-a716-446655440000"
  }
}

List Orders for Business Date

{
  "name": "toast_list_orders",
  "arguments": {
    "businessDate": 20240215
  }
}

Create Order

{
  "name": "toast_create_order",
  "arguments": {
    "source": "ONLINE",
    "selections": [
      {
        "itemGuid": "item-123",
        "quantity": 2
      }
    ],
    "customer": {
      "firstName": "John",
      "lastName": "Doe",
      "phone": "+15551234567"
    }
  }
}

Mark Item 86'd

{
  "name": "toast_set_item_86",
  "arguments": {
    "itemGuid": "item-456",
    "outOfStock": true
  }
}

Get Sales Summary

{
  "name": "toast_get_sales_summary",
  "arguments": {
    "businessDate": 20240215
  }
}

🏗️ Architecture

toast/
├── src/
│   ├── clients/
│   │   └── toast.ts          # Toast API client with auth
│   ├── tools/
│   │   ├── orders.ts         # 12 order tools
│   │   ├── menus.ts          # 11 menu tools
│   │   ├── employees.ts      # 9 employee tools
│   │   ├── labor.ts          # 6 labor tools
│   │   ├── restaurant.ts     # 9 restaurant tools
│   │   ├── payments.ts       # 6 payment tools
│   │   ├── inventory.ts      # 5 inventory tools
│   │   ├── customers.ts      # 4 customer tools
│   │   ├── reporting.ts      # 6 reporting tools
│   │   └── cash.ts           # 8 cash tools
│   ├── types/
│   │   └── index.ts          # Comprehensive TypeScript types
│   ├── ui/
│   │   └── react-app/        # 18 React apps (client-side)
│   ├── server.ts             # MCP server implementation
│   └── main.ts               # Entry point (stdio + HTTP)
├── package.json
├── tsconfig.json
└── README.md