Toast MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TOAST_MCP_MODE | No | Transport mode. Set to 'http' when deploying remotely (e.g., Railway) with a public URL. Not needed for local stdio mode. | |
| TOAST_CLIENT_ID | No | Toast API client ID, obtained from Toast Web after API access is approved. | |
| TOAST_MCP_SECRET | No | A long random string used as the connector password for HTTP mode. Required only when TOAST_MCP_MODE=http. | |
| TOAST_ENVIRONMENT | No | Toast environment, e.g., 'production'. | |
| TOAST_CLIENT_SECRET | No | Toast API client secret, obtained from Toast Web. Shown only once. | |
| TOAST_RESTAURANT_GUID | No | The GUID of your restaurant location. Optional if you pass restaurantGuid per call. | |
| TOAST_ENABLE_WRITE_TOOLS | No | Set to 'true' to enable the 21 write tools that modify POS data. Default is 'false'. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| toast_get_orderB | Get detailed information about a specific order by GUID |
| toast_list_ordersC | List orders with filtering options (date range, status, business date). Returns paginated results. |
| toast_get_checkC | Get detailed information about a specific check within an order |
| toast_get_order_statusB | Get fulfillment status of an order (kitchen prep, ready, completed) |
| toast_get_orders_by_business_dateC | Get all orders for a specific business date (formatted YYYYMMDD) |
| toast_search_orders_by_customerC | Search orders by customer phone or email |
| toast_list_menusB | List all menus for a restaurant |
| toast_get_menuB | Get detailed information about a specific menu including all groups and items |
| toast_get_menu_itemC | Get detailed information about a specific menu item |
| toast_search_menu_itemsC | Search menu items by name, SKU, or PLU |
| toast_get_modifier_groupC | Get details about a modifier group (e.g., toppings, sides) |
| toast_list_menu_groupsB | List all menu groups (categories) across all menus |
| toast_get_items_by_categoryC | Get all menu items in a specific category/group |
| toast_get_86d_itemsB | Get all items currently marked as out of stock (86'd) |
| toast_list_employeesC | List all employees at a restaurant |
| toast_get_employeeC | Get detailed information about a specific employee |
| toast_list_jobsC | List all job positions at a restaurant |
| toast_get_jobC | Get detailed information about a job position |
| toast_search_employeesB | Search employees by name, email, or phone |
| toast_get_employee_time_entriesC | Get time entries (clock in/out) for an employee |
| toast_list_shiftsB | List shifts for a specific date range |
| toast_get_shiftC | Get detailed information about a specific shift |
| toast_get_active_shiftsA | Get all currently active/clocked-in shifts |
| toast_list_time_entriesC | List time entries (clock in/out events) for a date range |
| toast_get_labor_reportC | Get labor summary report for a business date |
| toast_get_employee_hoursB | Get total hours worked by an employee for a date range |
| toast_get_restaurant_infoC | Get detailed restaurant configuration information |
| toast_list_accessible_restaurantsA | List all restaurants accessible with current API credentials |
| toast_list_tablesC | List all tables at a restaurant |
| toast_get_tableC | Get information about a specific table |
| toast_list_service_areasB | List all service areas (dining sections) at a restaurant |
| toast_list_dining_optionsC | List all dining options (dine-in, takeout, delivery, curbside, etc.) |
| toast_list_revenue_centersC | List all revenue centers (bars, POS stations, etc.) |
| toast_get_online_ordering_statusC | Check if online ordering is enabled and get scheduling info |
| toast_get_delivery_settingsC | Get delivery configuration (radius, minimum amount, etc.) |
| toast_get_paymentC | Get detailed information about a specific payment |
| toast_get_check_paymentsC | Get all payments associated with a check |
| toast_get_payment_summaryB | Get payment summary for a business date (totals by payment type) |
| toast_get_stock_itemC | Get stock/inventory information for a specific item at a location |
| toast_list_low_stock_itemsB | List items that are low in stock or out of stock |
| toast_search_customersC | Search for customers by phone, email, or name |
| toast_get_customer_order_historyC | Get order history for a specific customer |
| toast_get_customer_loyalty_statusC | Get loyalty program status for a customer |
| toast_get_top_customersB | Get top customers by order frequency or total spent |
| toast_get_sales_summaryC | Get comprehensive sales summary for a business date |
| toast_get_hourly_salesB | Get sales broken down by hour for a business date |
| toast_get_item_sales_reportC | Get sales report for menu items |
| toast_get_payment_type_reportC | Get breakdown of sales by payment type |
| toast_get_discount_reportC | Get report on discounts applied |
| toast_get_void_reportC | Get report on voided orders and items |
| toast_list_cash_drawersC | List all cash drawers for a business date |
| toast_get_cash_drawerB | Get detailed information about a specific cash drawer |
| toast_list_cash_entriesC | List cash entries (paid in/paid out) for a cash drawer or business date |
| toast_get_cash_drawer_summaryB | Get summary of cash drawer activity (paid in, paid out, net) |
| toast_list_cash_depositsC | List cash deposit records |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 55 tools
Most tools target distinct resources, but several overlap: get_payment_summary and get_payment_type_report both aggregate by payment type, list_orders and get_orders_by_business_date have redundant filtering behavior, and get_order_status vs get_order have fuzzy boundaries. With 55 tools, agents may struggle to pick the canonical tool for a given request.
All tools share a toast_ prefix and generally follow a predictable verb_noun pattern with list_, get_, and search_. Minor inconsistencies exist, such as mixing report/summary suffixes and having both get_orders_by_business_date and list_orders with a date filter, but the overall style is consistent.
At 55 tools, this is a very large surface for one MCP server. While the domains are broad, the count exceeds the 'too many' threshold and includes many narrow variants that add selection overhead without clear separation of concerns.
As a read-only restaurant data integration, the tool set covers orders, menus, payments, cash handling, employees, customers, inventory, and reporting comprehensively. Minor gaps exist, such as no list_payments endpoint, no item-level order detail separate from the order object, and no write operations, but agents can generally work around them.