@striderlabs/mcp-buffalowildwings 0.1.0

package/src/index.ts

@@ -0,0 +1,798 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { WING_FLAVORS, MENU_ITEMS, CATEGORIES } from "./menu.js";
+import { searchLocations, getLocationById, SAMPLE_LOCATIONS } from "./locations.js";
+import {
+  getSession,
+  updateSession,
+  resetSession,
+  CartItem,
+} from "./session.js";
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+function ok(data: unknown) {
+  return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
+}
+
+function err(message: string, details?: unknown) {
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify({ error: message, ...(details ? { details } : {}) }, null, 2),
+      },
+    ],
+    isError: true,
+  };
+}
+
+function cartTotal(cart: CartItem[]): number {
+  return cart.reduce((sum, item) => sum + item.unitPrice * item.quantity, 0);
+}
+
+function generateOrderId(): string {
+  return "BWW-" + Math.random().toString(36).substring(2, 10).toUpperCase();
+}
+
+// ─── Server Setup ─────────────────────────────────────────────────────────────
+
+const server = new McpServer({
+  name: "buffalowildwings",
+  version: "0.1.0",
+});
+
+// ─── Tool: bww_find_locations ─────────────────────────────────────────────────
+
+server.tool(
+  "bww_find_locations",
+  "Search for Buffalo Wild Wings locations near a city, address, or zip code. Returns a list of nearby restaurants with hours, features, and ordering options.",
+  {
+    query: z.string().describe("City name, state, zip code, or address to search near"),
+    show_all: z.boolean().optional().describe("If true, return all known locations. Default: false"),
+  },
+  async ({ query, show_all }) => {
+    try {
+      const results = show_all ? SAMPLE_LOCATIONS : searchLocations(query);
+      if (results.length === 0) {
+        return ok({
+          message: `No Buffalo Wild Wings locations found near "${query}". Try a major city name or zip code.`,
+          locations: [],
+          tip: "Use show_all: true to see all available locations.",
+        });
+      }
+      return ok({
+        count: results.length,
+        locations: results.map(loc => ({
+          id: loc.id,
+          name: loc.name,
+          address: `${loc.address}, ${loc.city}, ${loc.state} ${loc.zip}`,
+          phone: loc.phone,
+          features: loc.features,
+          supportsPickup: loc.supportsPickup,
+          supportsDelivery: loc.supportsDelivery,
+          supportsReservations: loc.supportsReservations,
+          waitTime: loc.waitTime,
+          deliveryRadius: loc.deliveryRadius ? `${loc.deliveryRadius} miles` : undefined,
+          todayHours: loc.hours.friday, // simplified — real impl would use current day
+        })),
+        tip: "Use bww_set_location to select a restaurant before ordering.",
+      });
+    } catch (e) {
+      return err("Failed to search locations", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_set_location ───────────────────────────────────────────────────
+
+server.tool(
+  "bww_set_location",
+  "Set the active Buffalo Wild Wings location for ordering. Must be called before adding items to cart.",
+  {
+    location_id: z.string().describe("Location ID from bww_find_locations"),
+    order_type: z.enum(["pickup", "delivery"]).describe("How you want to receive your order"),
+    delivery_address: z.string().optional().describe("Street address for delivery orders"),
+  },
+  async ({ location_id, order_type, delivery_address }) => {
+    try {
+      const location = getLocationById(location_id);
+      if (!location) {
+        return err(`Location "${location_id}" not found. Use bww_find_locations to get valid IDs.`);
+      }
+      if (order_type === "delivery" && !location.supportsDelivery) {
+        return err(`${location.name} does not support delivery. Choose pickup or a different location.`);
+      }
+      if (order_type === "delivery" && !delivery_address) {
+        return err("delivery_address is required for delivery orders.");
+      }
+      if (order_type === "pickup" && !location.supportsPickup) {
+        return err(`${location.name} does not support pickup.`);
+      }
+
+      updateSession({
+        locationId: location_id,
+        locationName: location.name,
+        orderType: order_type,
+        deliveryAddress: delivery_address,
+        cart: [], // reset cart when changing location
+      });
+
+      return ok({
+        success: true,
+        location: {
+          id: location.id,
+          name: location.name,
+          address: `${location.address}, ${location.city}, ${location.state} ${location.zip}`,
+          phone: location.phone,
+        },
+        orderType: order_type,
+        deliveryAddress: delivery_address,
+        message: `Location set to ${location.name}. Cart cleared. Ready to order!`,
+        nextStep: "Use bww_view_menu to browse items, then bww_add_to_cart.",
+      });
+    } catch (e) {
+      return err("Failed to set location", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_view_menu ──────────────────────────────────────────────────────
+
+server.tool(
+  "bww_view_menu",
+  "Browse the Buffalo Wild Wings menu. Can filter by category or search for specific items. Includes wing flavors and sauces.",
+  {
+    category: z.string().optional().describe(`Filter by category. Options: ${CATEGORIES.join(", ")}`),
+    search: z.string().optional().describe("Search menu items by name or description"),
+    show_flavors: z.boolean().optional().describe("If true, return detailed wing flavor/sauce list"),
+    heat_level: z.number().min(1).max(5).optional().describe("Filter wing flavors by heat level (1=mild, 5=blazin)"),
+  },
+  async ({ category, search, show_flavors, heat_level }) => {
+    try {
+      if (show_flavors) {
+        let flavors = WING_FLAVORS;
+        if (heat_level !== undefined) {
+          flavors = flavors.filter(f => f.heatLevel === heat_level);
+        }
+        return ok({
+          wingFlavors: flavors.map(f => ({
+            id: f.id,
+            name: f.name,
+            heatLevel: `${"🔥".repeat(f.heatLevel)} (${f.heatLevel}/5)`,
+            description: f.description,
+            ...(f.isNew ? { badge: "NEW" } : {}),
+            ...(f.isLimitedTime ? { badge: "LIMITED TIME" } : {}),
+          })),
+          count: flavors.length,
+          tip: "Use the flavor name when calling bww_add_to_cart.",
+        });
+      }
+
+      let items = MENU_ITEMS;
+      if (category) {
+        items = items.filter(i => i.category.toLowerCase() === category.toLowerCase());
+      }
+      if (search) {
+        const q = search.toLowerCase();
+        items = items.filter(
+          i => i.name.toLowerCase().includes(q) || i.description.toLowerCase().includes(q)
+        );
+      }
+
+      if (items.length === 0) {
+        return ok({
+          message: "No menu items found matching your criteria.",
+          availableCategories: CATEGORIES,
+        });
+      }
+
+      return ok({
+        count: items.length,
+        categories: CATEGORIES,
+        items: items.map(i => ({
+          id: i.id,
+          name: i.name,
+          category: i.category,
+          description: i.description,
+          price: `$${i.basePrice.toFixed(2)}`,
+          calories: i.calories,
+          ...(i.isPopular ? { popular: true } : {}),
+          ...(i.options ? { options: i.options } : {}),
+        })),
+        tip: "Use item ID and sauce name with bww_add_to_cart to add items.",
+      });
+    } catch (e) {
+      return err("Failed to load menu", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_add_to_cart ────────────────────────────────────────────────────
+
+server.tool(
+  "bww_add_to_cart",
+  "Add a menu item to your Buffalo Wild Wings cart. Location must be set first with bww_set_location.",
+  {
+    item_id: z.string().describe("Menu item ID from bww_view_menu"),
+    quantity: z.number().min(1).max(50).describe("Number of items to add"),
+    sauce: z.string().optional().describe("Wing sauce or dry rub name (required for wing items)"),
+    notes: z.string().optional().describe("Special instructions for this item"),
+  },
+  async ({ item_id, quantity, sauce, notes }) => {
+    try {
+      const session = getSession();
+      if (!session.locationId) {
+        return err("No location selected. Use bww_set_location first.");
+      }
+
+      const menuItem = MENU_ITEMS.find(i => i.id === item_id);
+      if (!menuItem) {
+        return err(`Item "${item_id}" not found. Use bww_view_menu to see available items.`);
+      }
+
+      // Validate sauce for wing items
+      if (menuItem.category === "Wings" && !sauce) {
+        return err("Wing items require a sauce or dry rub. Use bww_view_menu with show_flavors: true to see options.");
+      }
+
+      if (sauce) {
+        const validFlavor = WING_FLAVORS.find(
+          f => f.name.toLowerCase() === sauce.toLowerCase() || f.id === sauce.toLowerCase()
+        );
+        if (!validFlavor) {
+          return err(`Sauce "${sauce}" not found. Use bww_view_menu with show_flavors: true to see available sauces.`);
+        }
+      }
+
+      const newItem: CartItem = {
+        itemId: item_id,
+        name: menuItem.name + (sauce ? ` (${sauce})` : ""),
+        quantity,
+        unitPrice: menuItem.basePrice,
+        sauce,
+        notes,
+      };
+
+      // Check if same item+sauce already in cart
+      const existing = session.cart.find(
+        ci => ci.itemId === item_id && ci.sauce === sauce
+      );
+      let updatedCart: CartItem[];
+      if (existing) {
+        updatedCart = session.cart.map(ci =>
+          ci.itemId === item_id && ci.sauce === sauce
+            ? { ...ci, quantity: ci.quantity + quantity }
+            : ci
+        );
+      } else {
+        updatedCart = [...session.cart, newItem];
+      }
+
+      updateSession({ cart: updatedCart });
+
+      return ok({
+        success: true,
+        added: {
+          name: newItem.name,
+          quantity,
+          unitPrice: `$${menuItem.basePrice.toFixed(2)}`,
+          subtotal: `$${(menuItem.basePrice * quantity).toFixed(2)}`,
+        },
+        cart: {
+          itemCount: updatedCart.reduce((s, i) => s + i.quantity, 0),
+          total: `$${cartTotal(updatedCart).toFixed(2)}`,
+        },
+        nextStep: "Use bww_view_cart to review, or bww_checkout to place your order.",
+      });
+    } catch (e) {
+      return err("Failed to add item to cart", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_view_cart ──────────────────────────────────────────────────────
+
+server.tool(
+  "bww_view_cart",
+  "View the current Buffalo Wild Wings cart contents and order summary.",
+  {},
+  async () => {
+    try {
+      const session = getSession();
+      if (!session.locationId) {
+        return ok({
+          cart: [],
+          message: "No location selected. Use bww_set_location to begin.",
+        });
+      }
+      if (session.cart.length === 0) {
+        return ok({
+          location: session.locationName,
+          orderType: session.orderType,
+          cart: [],
+          message: "Your cart is empty. Use bww_add_to_cart to add items.",
+        });
+      }
+
+      const subtotal = cartTotal(session.cart);
+      const tax = subtotal * 0.0875;
+      const deliveryFee = session.orderType === "delivery" ? 3.99 : 0;
+      const total = subtotal + tax + deliveryFee;
+
+      return ok({
+        location: session.locationName,
+        orderType: session.orderType,
+        deliveryAddress: session.deliveryAddress,
+        items: session.cart.map(i => ({
+          name: i.name,
+          quantity: i.quantity,
+          unitPrice: `$${i.unitPrice.toFixed(2)}`,
+          subtotal: `$${(i.unitPrice * i.quantity).toFixed(2)}`,
+          ...(i.notes ? { notes: i.notes } : {}),
+        })),
+        summary: {
+          subtotal: `$${subtotal.toFixed(2)}`,
+          tax: `$${tax.toFixed(2)}`,
+          deliveryFee: session.orderType === "delivery" ? `$${deliveryFee.toFixed(2)}` : "$0.00",
+          estimatedTotal: `$${total.toFixed(2)}`,
+        },
+        nextSteps: "Use bww_checkout to place your order, or bww_remove_from_cart to modify.",
+      });
+    } catch (e) {
+      return err("Failed to load cart", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_remove_from_cart ───────────────────────────────────────────────
+
+server.tool(
+  "bww_remove_from_cart",
+  "Remove an item from the cart or reduce its quantity.",
+  {
+    item_name: z.string().describe("Partial name of the item to remove (case-insensitive)"),
+    quantity: z.number().min(1).optional().describe("Quantity to remove. If omitted, removes the item entirely."),
+  },
+  async ({ item_name, quantity }) => {
+    try {
+      const session = getSession();
+      const q = item_name.toLowerCase();
+      const idx = session.cart.findIndex(i => i.name.toLowerCase().includes(q));
+
+      if (idx === -1) {
+        return err(`No cart item matching "${item_name}" found.`);
+      }
+
+      let updatedCart = [...session.cart];
+      const item = updatedCart[idx];
+
+      if (quantity && quantity < item.quantity) {
+        updatedCart[idx] = { ...item, quantity: item.quantity - quantity };
+      } else {
+        updatedCart.splice(idx, 1);
+      }
+
+      updateSession({ cart: updatedCart });
+
+      return ok({
+        success: true,
+        removed: item.name,
+        cart: {
+          itemCount: updatedCart.reduce((s, i) => s + i.quantity, 0),
+          total: `$${cartTotal(updatedCart).toFixed(2)}`,
+        },
+      });
+    } catch (e) {
+      return err("Failed to remove item", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_checkout ───────────────────────────────────────────────────────
+
+server.tool(
+  "bww_checkout",
+  "Place your Buffalo Wild Wings order. Provide payment details and optionally apply Blazin Rewards. Returns order confirmation.",
+  {
+    name: z.string().describe("Full name for the order"),
+    phone: z.string().describe("Phone number for order notifications"),
+    email: z.string().optional().describe("Email for order confirmation"),
+    payment_method: z.enum(["credit_card", "apple_pay", "google_pay", "rewards_points"]).describe("Payment method"),
+    card_last4: z.string().length(4).optional().describe("Last 4 digits of credit card (for credit_card payment)"),
+    tip_percent: z.number().min(0).max(100).optional().describe("Tip percentage (0-100). Default: 18"),
+    apply_rewards: z.boolean().optional().describe("Apply available Blazin Rewards points to this order"),
+    pickup_time: z.string().optional().describe("Requested pickup time, e.g. 'ASAP' or '6:30 PM'"),
+    confirm: z.boolean().describe("Must be true to actually place the order. Set to false to preview only."),
+  },
+  async ({ name, phone, email, payment_method, card_last4, tip_percent, apply_rewards, pickup_time, confirm }) => {
+    try {
+      const session = getSession();
+
+      if (!session.locationId) {
+        return err("No location selected. Use bww_set_location first.");
+      }
+      if (session.cart.length === 0) {
+        return err("Cart is empty. Add items with bww_add_to_cart first.");
+      }
+      if (payment_method === "credit_card" && !card_last4) {
+        return err("card_last4 is required when payment_method is credit_card.");
+      }
+
+      const subtotal = cartTotal(session.cart);
+      const tax = subtotal * 0.0875;
+      const deliveryFee = session.orderType === "delivery" ? 3.99 : 0;
+      const tipAmount = subtotal * ((tip_percent ?? 18) / 100);
+
+      let rewardsDiscount = 0;
+      if (apply_rewards && session.rewardsPoints && session.rewardsPoints > 0) {
+        rewardsDiscount = Math.min(session.rewardsPoints * 0.01, subtotal * 0.2); // up to 20% off
+      }
+
+      const total = subtotal + tax + deliveryFee + tipAmount - rewardsDiscount;
+      const orderId = generateOrderId();
+      const estimatedTime =
+        session.orderType === "delivery" ? "35-50 minutes" : pickup_time || "20-25 minutes";
+
+      const orderPreview = {
+        orderId,
+        location: session.locationName,
+        orderType: session.orderType,
+        deliveryAddress: session.deliveryAddress,
+        name,
+        phone,
+        email,
+        items: session.cart.map(i => ({
+          name: i.name,
+          quantity: i.quantity,
+          price: `$${(i.unitPrice * i.quantity).toFixed(2)}`,
+        })),
+        pricing: {
+          subtotal: `$${subtotal.toFixed(2)}`,
+          tax: `$${tax.toFixed(2)}`,
+          tip: `$${tipAmount.toFixed(2)}`,
+          deliveryFee: `$${deliveryFee.toFixed(2)}`,
+          rewardsDiscount: rewardsDiscount > 0 ? `-$${rewardsDiscount.toFixed(2)}` : undefined,
+          total: `$${total.toFixed(2)}`,
+        },
+        payment: payment_method === "credit_card" ? `Card ending in ${card_last4}` : payment_method,
+        estimatedTime,
+      };
+
+      if (!confirm) {
+        return ok({
+          preview: true,
+          message: "Order preview (not placed). Set confirm: true to place the order.",
+          ...orderPreview,
+        });
+      }
+
+      // Simulate placing order
+      updateSession({
+        orderId,
+        orderStatus: "confirmed",
+        cart: [],
+      });
+
+      return ok({
+        success: true,
+        message: `Order placed! Your wings are on the way.`,
+        ...orderPreview,
+        status: "confirmed",
+        trackingTip: `Use bww_track_order with order_id: "${orderId}" to check your order status.`,
+      });
+    } catch (e) {
+      return err("Checkout failed", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_track_order ────────────────────────────────────────────────────
+
+server.tool(
+  "bww_track_order",
+  "Track the status of a Buffalo Wild Wings order.",
+  {
+    order_id: z.string().optional().describe("Order ID from checkout confirmation. If omitted, uses most recent order."),
+  },
+  async ({ order_id }) => {
+    try {
+      const session = getSession();
+      const id = order_id || session.orderId;
+
+      if (!id) {
+        return err("No order ID provided and no recent order found in session.");
+      }
+
+      // Simulate order tracking states
+      const statuses = ["confirmed", "preparing", "ready_for_pickup", "out_for_delivery", "delivered"];
+      const simulatedStatus =
+        session.orderId === id ? session.orderStatus || "confirmed" : "confirmed";
+
+      const statusMessages: Record<string, string> = {
+        confirmed: "Order received and confirmed. Kitchen is warming up!",
+        preparing: "Your wings are being sauced and cooked fresh.",
+        ready_for_pickup: "Your order is ready! Head to the pickup counter.",
+        out_for_delivery: "Your order is on its way!",
+        delivered: "Order delivered. Enjoy your wings!",
+      };
+
+      return ok({
+        orderId: id,
+        status: simulatedStatus,
+        message: statusMessages[simulatedStatus] || "Order in progress.",
+        estimatedCompletion: "20-25 minutes from order time",
+        location: session.locationName,
+        note: "This is a simulated status. Live tracking requires BWW app integration.",
+      });
+    } catch (e) {
+      return err("Failed to track order", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_blazin_rewards ─────────────────────────────────────────────────
+
+server.tool(
+  "bww_blazin_rewards",
+  "Manage your Blazin' Rewards account — check points, redeem rewards, view tier status, and link your account.",
+  {
+    action: z.enum(["status", "link", "check_points", "view_perks"]).describe(
+      "Action to perform: status=show account summary, link=connect rewards account, check_points=see point balance, view_perks=see available rewards"
+    ),
+    phone: z.string().optional().describe("Phone number to link/lookup rewards account"),
+    member_id: z.string().optional().describe("Blazin' Rewards member ID"),
+  },
+  async ({ action, phone, member_id }) => {
+    try {
+      const session = getSession();
+
+      if (action === "link") {
+        if (!phone && !member_id) {
+          return err("Provide phone or member_id to link your Blazin' Rewards account.");
+        }
+        // Simulate account lookup
+        const simulatedPoints = Math.floor(Math.random() * 5000) + 200;
+        const tier = simulatedPoints > 3000 ? "Blazin'" : simulatedPoints > 1000 ? "Medium" : "Mild";
+
+        updateSession({
+          rewardsPhone: phone,
+          rewardsMemberId: member_id || "BRW" + Date.now().toString().slice(-8),
+          rewardsPoints: simulatedPoints,
+        });
+
+        return ok({
+          success: true,
+          message: "Blazin' Rewards account linked!",
+          account: {
+            phone: phone || "on file",
+            memberId: session.rewardsMemberId,
+            points: simulatedPoints,
+            tier,
+            pointsValue: `$${(simulatedPoints * 0.01).toFixed(2)} in rewards`,
+          },
+        });
+      }
+
+      if (action === "status" || action === "check_points") {
+        if (!session.rewardsPhone && !session.rewardsMemberId) {
+          return ok({
+            linked: false,
+            message: "No Blazin' Rewards account linked. Use action: 'link' with your phone number.",
+          });
+        }
+        return ok({
+          linked: true,
+          points: session.rewardsPoints || 0,
+          pointsValue: `$${((session.rewardsPoints || 0) * 0.01).toFixed(2)}`,
+          tier: (session.rewardsPoints || 0) > 3000 ? "Blazin'" : (session.rewardsPoints || 0) > 1000 ? "Medium" : "Mild",
+          memberId: session.rewardsMemberId,
+          phone: session.rewardsPhone,
+        });
+      }
+
+      if (action === "view_perks") {
+        return ok({
+          perks: [
+            { name: "Free Wings Birthday Reward", description: "Free 6 wings on your birthday month", tier: "All Members" },
+            { name: "Points per Dollar", description: "Earn 10 pts per $1 spent", tier: "All Members" },
+            { name: "Bonus Points Days", description: "Double points on Tuesdays", tier: "All Members" },
+            { name: "Free Sauce Upgrade", description: "Try any new sauce free", tier: "Medium (1000+ pts)" },
+            { name: "Priority Seating", description: "Skip the wait on game days", tier: "Blazin' (3000+ pts)" },
+            { name: "Monthly Free Wings", description: "6 free traditional wings per month", tier: "Blazin' (3000+ pts)" },
+            { name: "Exclusive Sauce Access", description: "Early access to new limited-time sauces", tier: "Blazin' (3000+ pts)" },
+          ],
+          redeemTip: "Points are worth $0.01 each. Redeem at checkout with apply_rewards: true.",
+        });
+      }
+
+      return err("Unknown action.");
+    } catch (e) {
+      return err("Blazin' Rewards action failed", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_reserve_table ──────────────────────────────────────────────────
+
+server.tool(
+  "bww_reserve_table",
+  "Reserve a table at a Buffalo Wild Wings location that supports reservations. Check bww_find_locations for supportsReservations.",
+  {
+    location_id: z.string().describe("Location ID from bww_find_locations"),
+    date: z.string().describe("Reservation date in YYYY-MM-DD format"),
+    time: z.string().describe("Reservation time, e.g. '7:00 PM'"),
+    party_size: z.number().min(1).max(50).describe("Number of guests"),
+    name: z.string().describe("Name for the reservation"),
+    phone: z.string().describe("Contact phone number"),
+    special_requests: z.string().optional().describe("Special requests, e.g. 'near a TV', 'birthday celebration'"),
+  },
+  async ({ location_id, date, time, party_size, name, phone, special_requests }) => {
+    try {
+      const location = getLocationById(location_id);
+      if (!location) {
+        return err(`Location "${location_id}" not found.`);
+      }
+      if (!location.supportsReservations) {
+        return ok({
+          success: false,
+          message: `${location.name} does not currently accept online reservations.`,
+          suggestion: `Call directly at ${location.phone} to check walk-in availability or make a reservation.`,
+        });
+      }
+
+      // Validate date
+      const reservationDate = new Date(date);
+      if (isNaN(reservationDate.getTime())) {
+        return err("Invalid date format. Use YYYY-MM-DD.");
+      }
+
+      const confirmationId = "RES-" + Math.random().toString(36).substring(2, 8).toUpperCase();
+
+      return ok({
+        success: true,
+        confirmationId,
+        reservation: {
+          location: location.name,
+          address: `${location.address}, ${location.city}, ${location.state} ${location.zip}`,
+          date,
+          time,
+          partySize: party_size,
+          name,
+          phone,
+          specialRequests: special_requests || "None",
+        },
+        message: `Table reserved for ${party_size} at ${location.name} on ${date} at ${time}.`,
+        reminder: "Please arrive 5-10 minutes early. Reservations held for 15 minutes.",
+        cancelPolicy: "Cancel at least 2 hours in advance by calling the restaurant.",
+        restaurantPhone: location.phone,
+      });
+    } catch (e) {
+      return err("Failed to make reservation", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_game_day_specials ──────────────────────────────────────────────
+
+server.tool(
+  "bww_game_day_specials",
+  "View current game day specials, happy hour deals, wing Tuesday promotions, and limited-time offers at Buffalo Wild Wings.",
+  {
+    location_id: z.string().optional().describe("Location ID to check location-specific specials. Omit for general specials."),
+    day: z.string().optional().describe("Day of week to check specials for, e.g. 'tuesday', 'sunday'. Defaults to today."),
+  },
+  async ({ location_id, day }) => {
+    try {
+      const location = location_id ? getLocationById(location_id) : null;
+      const targetDay = (day || new Date().toLocaleDateString("en-US", { weekday: "long" })).toLowerCase();
+
+      const specials: Record<string, unknown[]> = {
+        monday: [
+          { name: "Monday Night Football Special", deal: "$1 off all draft beers during MNF", validDuring: "Game time" },
+          { name: "Boneless Monday", deal: "50¢ boneless wings all day", validDuring: "All day" },
+        ],
+        tuesday: [
+          { name: "Wing Tuesday (National Wing Day!)", deal: "Traditional wings at reduced price — biggest deal of the week", validDuring: "All day", popular: true },
+          { name: "Double Points Tuesday", deal: "Earn 2x Blazin' Rewards points on all orders", validDuring: "All day" },
+        ],
+        wednesday: [
+          { name: "Happy Hour", deal: "$3 domestic drafts, $2 off appetizers", validDuring: "3:00 PM - 7:00 PM" },
+        ],
+        thursday: [
+          { name: "Throwback Thursday", deal: "$10 for 10 traditional wings with any sauce", validDuring: "4:00 PM - close" },
+          { name: "Happy Hour", deal: "$3 domestic drafts, $2 off appetizers", validDuring: "3:00 PM - 7:00 PM" },
+        ],
+        friday: [
+          { name: "TGIF Happy Hour", deal: "$4 craft drafts, $5 select cocktails", validDuring: "3:00 PM - 7:00 PM" },
+          { name: "Game Night Combo", deal: "20 wings + pitcher of beer — $29.99", validDuring: "All evening" },
+        ],
+        saturday: [
+          { name: "College Game Day", deal: "College football specials — $1 off wings during games", validDuring: "During college games" },
+          { name: "Saturday Night Bucket Deal", deal: "50 wings for $44.99", validDuring: "5:00 PM - close", popular: true },
+        ],
+        sunday: [
+          { name: "NFL Sunday Package", deal: "$25 for 20 wings + 2 beers during NFL games", validDuring: "During NFL games", popular: true },
+          { name: "Sunday Funday", deal: "Bottomless tater tots with any wing order — $5 add-on", validDuring: "All day" },
+          { name: "Blazin' Challenge Sunday", deal: "Complete the Blazin' Challenge — free wings + T-shirt + Blazin' Rewards bonus", validDuring: "All day" },
+        ],
+      };
+
+      const todaySpecials = specials[targetDay] || [];
+      const limitedTimeOffers = [
+        {
+          name: "Carolina Reaper Challenge",
+          deal: "Eat 12 Blazin' Carolina Reaper wings in 6 minutes — win a limited-edition shirt",
+          validThrough: "Limited time",
+          sauce: "Blazin' Carolina Reaper",
+        },
+        {
+          name: "Smoky Cheddar BBQ Launch",
+          deal: "Try the new Smoky Cheddar BBQ sauce — free upgrade on any wing order this week",
+          validThrough: "This week only",
+          sauce: "Smoky Cheddar BBQ",
+        },
+        {
+          name: "March Madness Bundle",
+          deal: "50 traditional wings + 2 pitchers — $54.99 during tournament games",
+          validThrough: "March Madness season",
+        },
+      ];
+
+      return ok({
+        day: targetDay.charAt(0).toUpperCase() + targetDay.slice(1),
+        location: location ? `${location.name} — ${location.address}` : "All locations",
+        todaySpecials: todaySpecials.length > 0 ? todaySpecials : [{ message: "No specials today. Check back tomorrow!" }],
+        limitedTimeOffers,
+        alwaysAvailable: [
+          { name: "Happy Hour", deal: "$3 domestics, $4 crafts", validDuring: "Mon–Fri 3:00–7:00 PM" },
+          { name: "Blazin' Challenge", deal: "12 Blazin' wings in 6 min — beat the clock, win glory", validDuring: "Always" },
+          { name: "Rewards Double-Dip", deal: "Earn points + use a special simultaneously", validDuring: "Always with active rewards account" },
+        ],
+        tip: "Link your Blazin' Rewards account with bww_blazin_rewards to maximize deal value.",
+      });
+    } catch (e) {
+      return err("Failed to load specials", String(e));
+    }
+  }
+);
+
+// ─── Tool: bww_session ────────────────────────────────────────────────────────
+
+server.tool(
+  "bww_session",
+  "View or reset the current session — active location, order type, cart, and linked rewards account.",
+  {
+    action: z.enum(["view", "reset"]).describe("view=show current session, reset=clear all session data"),
+  },
+  async ({ action }) => {
+    try {
+      if (action === "reset") {
+        resetSession();
+        return ok({ success: true, message: "Session cleared. Location, cart, and rewards data removed." });
+      }
+
+      const session = getSession();
+      return ok({
+        location: session.locationName || "Not set",
+        locationId: session.locationId || null,
+        orderType: session.orderType || "Not set",
+        deliveryAddress: session.deliveryAddress || null,
+        cartItems: session.cart.length,
+        cartTotal: `$${cartTotal(session.cart).toFixed(2)}`,
+        rewards: session.rewardsMemberId
+          ? { memberId: session.rewardsMemberId, points: session.rewardsPoints || 0 }
+          : "Not linked",
+        lastOrderId: session.orderId || null,
+      });
+    } catch (e) {
+      return err("Session action failed", String(e));
+    }
+  }
+);
+
+// ─── Start ────────────────────────────────────────────────────────────────────
+
+const transport = new StdioServerTransport();
+await server.connect(transport);