@striderlabs/mcp-burgerking

@striderlabs/mcp-burgerking

An MCP (Model Context Protocol) server for Burger King fast food ordering. This package enables AI assistants like Claude to search the BK menu, manage a cart, find nearby locations, and place orders via Playwright browser automation.

Features

• Search the full Burger King menu by keyword or category
• Get detailed nutrition info and customization options for any item
• Add items to an in-memory cart with customizations
• View cart contents and estimated totals (with tax)
• Find nearby Burger King locations
• Checkout with delivery or pickup options
• Track order status after placement

Installation

Via npm

npm install @striderlabs/mcp-burgerking

Via tarball

npm install /path/to/striderlabs-mcp-burgerking-1.0.0.tgz

Playwright browsers (required)

After installing, you must install Playwright's Chromium browser:

npx playwright install chromium

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "burgerking": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-burgerking"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "burgerking": {
      "command": "mcp-burgerking"
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Tools

search_menu

Search the Burger King menu by keyword or category.

Parameters:

• query (optional): Search keyword (e.g., "chicken", "burger", "fries")
• category (optional): One of burgers, sides, drinks, desserts, breakfast

Example:

"Search for chicken items on the BK menu"

get_item_details

Get detailed information about a specific menu item including nutrition facts and customization options.

Parameters:

• item_id (required): Item ID from search results (e.g., whopper, fries-md)

Example:

"Get details for the Whopper"

add_to_cart

Add a menu item to the cart with optional customizations.

Parameters:

• item_id (required): Item ID to add
• quantity (optional): Number to add (default: 1)
• customizations (optional): Array of customization strings (e.g., ["no pickles", "extra cheese"])

Example:

"Add 2 Whoppers with no pickles to my cart"

view_cart

View current cart contents with subtotal, estimated tax, and grand total.

Example:

"Show me my cart"

checkout

Proceed to checkout. Attempts browser automation to bk.com; falls back gracefully if bot protection is encountered.

Parameters:

• order_type (required): delivery or pickup
• address (optional): Delivery address (required for delivery)
• location_id (optional): BK location ID for pickup (from find_locations)

Example:

"Checkout for delivery to 123 Main St, San Francisco CA"

get_order_status

Check the status of a placed order.

Parameters:

• order_id (required): Order ID returned by checkout

Example:

"What's the status of order BKA1B2C3?"

find_locations

Find nearby Burger King locations.

Parameters:

• address (required): Address, city, or ZIP code
• radius_miles (optional): Search radius in miles (default: 5)

Example:

"Find BK locations near 10001"

Usage Examples

User: Find me something vegetarian at Burger King
Claude: [calls search_menu with query="vegetarian"] → Returns Impossible Whopper

User: Add an Impossible Whopper with no mayo and a large Coke to my cart
Claude: [calls add_to_cart for impossible-whopper] → Added
         [calls add_to_cart for coke-lg] → Added

User: Show my cart
Claude: [calls view_cart] → Shows items, subtotal $11.27, tax $0.90, total $12.17

User: Checkout for pickup at the downtown location
Claude: [calls find_locations] → Gets location IDs
         [calls checkout with order_type=pickup] → Returns order ID

Notes

• Bot Protection: bk.com uses Akamai/Cloudflare bot protection. The checkout and location tools gracefully fall back to demo/simulated responses when the site blocks automation.
• In-Memory Cart: Cart state is maintained in memory for the duration of the server process. Restarting the server clears the cart.
• Playwright Requirement: Playwright and Chromium must be installed for browser automation features. The server will still function with demo data if Playwright is unavailable.
• Real Orders: Due to bot protection and authentication requirements, actual order placement on bk.com requires signing into a BK account. The checkout tool provides an order reference ID for completing the order manually.

Development

git clone https://github.com/markswendsen-code/mcp-burgerking
cd mcp-burgerking
npm install
npm run build

Run in development mode:

npm run dev

License

MIT - Strider Labs