@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