@striderlabs/mcp-wingstop
An MCP (Model Context Protocol) server for Wingstop — find nearby locations, browse the wing menu with all 13 flavors, build your order, apply coupons, check out, and view Wing Club rewards using Playwright browser automation.
Features
- Find Locations — Locate nearby Wingstop restaurants with address, hours, distance, and delivery availability
- Browse Menu — Full menu by category: wings, tenders, combos, sides, drinks, and dips — with flavors and prices
- Order Management — Create orders, add items with flavor selections, remove items
- Coupons — Apply promo codes for discounts
- Checkout — Review and submit orders for pickup or delivery
- Wing Club Rewards — Check points balance, tier status, and available reward offers
Installation
npm install @striderlabs/mcp-wingstop
npx playwright install chromium
Usage
As an MCP server (Claude Desktop / Cursor / etc.)
Add to your MCP client config (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"wingstop": {
"command": "npx",
"args": ["-y", "@striderlabs/mcp-wingstop"]
}
}
}
Run directly
npx @striderlabs/mcp-wingstop
Tools
find_locations
Find nearby Wingstop locations.
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
location | string | Yes | Address, city, or ZIP code |
Example:
{ "location": "Dallas, TX" }
get_menu
Browse the Wingstop menu with prices and flavors.
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
category | string | No | Filter by category: wings, tenders, combos, sides, drinks, dips |
Example:
{ "category": "wings" }
create_order
Start a new order at a selected Wingstop location.
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
locationId | string | Yes | Location ID from find_locations |
locationName | string | Yes | Location name/address |
orderType | string | No | "pickup" or "delivery" (default: "pickup") |
Example:
{
"locationId": "ws_loc_001",
"locationName": "Wingstop - 123 Main St",
"orderType": "pickup"
}
add_item
Add a menu item to the current order.
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
menuItemId | string | Yes | Item ID from get_menu |
name | string | Yes | Display name |
price | number | Yes | Price per item (USD) |
quantity | number | No | Quantity (default: 1) |
flavor | string | No | Wing flavor (e.g. "Lemon Pepper", "Mango Habanero") |
size | string | No | Size (e.g. "6-piece", "10-piece") |
customizations | object | No | Extra key-value customizations |
Example:
{
"menuItemId": "classic-wings-10",
"name": "10-Piece Classic Wings",
"price": 14.99,
"quantity": 1,
"flavor": "Lemon Pepper",
"size": "10-piece"
}
remove_item
Remove an item from the current order.
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
itemId | string | Yes | Order item ID (shown in add_item response) |
apply_coupon
Apply a promo code to the current order.
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
code | string | Yes | Coupon or promo code |
Example:
{ "code": "WINGFAN10" }
checkout
Submit the order for pickup or delivery.
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
customerName | string | Yes | Customer name |
phone | string | No | Phone number |
pickupTime | string | No | Pickup time (default: "ASAP") |
deliveryAddress | string | No | Delivery address (required for delivery) |
notes | string | No | Special instructions |
Example:
{
"customerName": "Alex Smith",
"phone": "555-123-4567",
"pickupTime": "6:30 PM"
}
Note: Full order placement requires authentication with Wingstop. The server generates an order ID and summary — complete payment at wingstop.com or in the Wingstop app.
get_rewards
Check Wing Club rewards balance and offers.
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
includeOffers | boolean | No | Include reward offers (default: true) |
Supported Flavors
Wingstop's 13 signature flavors:
| Flavor | Heat Level |
|---|---|
| Lemon Pepper | None |
| Garlic Parmesan | None |
| Hickory Smoked BBQ | None |
| Hawaiian | Mild |
| Mild | Mild |
| Butter Garlic | None |
| Cajun | Medium |
| Louisiana Rub | Medium |
| Cajun Garlic | Medium |
| Original Hot | Hot |
| Spicy Korean Q | Hot |
| Mango Habanero | Extra Hot |
| Atomic | Extra Hot |
Session Persistence
The server saves browser cookies to ~/.wingstop-mcp-cookies.json for persistent sessions across restarts. If you're logged in to Wingstop in the automated browser, your session will be preserved.
How It Works
The server uses Playwright to automate a headless Chromium browser with stealth settings, navigating wingstop.com to fetch live location data, menu items, and rewards information. A comprehensive static fallback dataset is used when live scraping is unavailable.
Order state is maintained in-memory for the duration of the MCP session.
Development
git clone https://github.com/markswendsen-code/mcp-wingstop
cd mcp-wingstop
npm install
npx playwright install chromium
npm run dev # watch mode
npm run build # production build
License
MIT