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