Pizza Hut MCP server for AI agents

Let Claude, ChatGPT or your own agent read Pizza Hut: 5 typed functions through one MCP server. No Pizza Hut API key needed.

Functions
5
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Pizza Hut

An MCP server for Pizza Hut alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/pizzahut
Every site

One MCP server for Pizza Hut and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 5
  • findStoresFinds the Pizza Hut stores that serve a given address or ZIP.

    Arguments

    NameTypeRequired
    wherestring | { address?: string; address2?: string; city?: string; state?: string; zip?: string; latitude?: number; longitude?: number }Yes
    options{ fulfillment?: "carryout" | "delivery"; limit?: number }No

    Returns PizzahutStore[]

    interface PizzahutStore {
      storeNumber: string;
      storeId: string;
      address: string;
      address2: string | null;
      city: string;
      state: string;
      zip: string;
      country: string;
      phone: string | null;
      landmark: string | null;
      latitude: number | null;
      longitude: number | null;
      distanceMiles: number | null;
      onlineStatus: string;
      fulfillment: PizzahutFulfillmentOption[];
      deliveryFeeCents: number | null;
      hours: PizzahutHours[];
      timezone: string;
      allowsFutureOrders: boolean;
      futureOrderDays: number | null;
      localizationToken: string;
    }
    
    interface PizzahutFulfillmentOption {
      type: "CARRYOUT" | "DELIVERY";
      name: string;
      serviceTimeMinutes: number | null;
      minOrderCents: number | null;
      maxOrderCents: number | null;
      allowsTip: boolean;
    }
    
    interface PizzahutHours {
      fulfillment: "CARRYOUT" | "DELIVERY";
      days: number[];   // ISO weekday, 1 = Monday … 7 = Sunday
      opensAt: string;  // "HH:MM:SS", store-local
      duration: string; // "HH:MM:SS" from opensAt, the site expresses closing as a duration
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pizzahut/findStores

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pizzahut.findStores("90210", { limit: 5 });
  • getDealsReads the deals, coupons and bundle offers Pizza Hut is running at a store right now.

    Arguments

    NameTypeRequired
    args{ storeNumber: string }Yes

    Returns PizzahutDealsForRender

    // ── getDeals ──────────────────────────────────────────────────────────────
    // Mirrors the public types declared at the top of this file (PizzahutDeals,
    // PizzahutDeal, PizzahutDealImage, PizzahutDealScope), copied here so the
    // rendered get_library blurb and the catalog signature are types the
    // gateway can resolve. The exported shapes are the source of truth.
    type PizzahutDealScopeForRender = "all" | { storeNumbers: string[] };
    
    interface PizzahutDealImageForRender {
      url: string;
      title: string | null;
    }
    
    interface PizzahutDealForRender {
      position: number | null;
      code: string;
      name: string;
      description: string | null;
      legalText: string | null;
      appImage: PizzahutDealImageForRender | null;
      webImage: PizzahutDealImageForRender | null;
    }
    
    interface PizzahutDealsForRender {
      storeNumber: string;
      deals: PizzahutDealForRender[];
      sources: { name: string; scope: PizzahutDealScopeForRender }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pizzahut/getDeals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pizzahut.getDeals({ storeNumber: "026196" });
  • getMenuReads a store's menu, the items Pizza Hut is actually selling at that location, by category (pizza, wings, pasta, sides, desserts, drinks, dips…

    Arguments

    NameTypeRequired
    args{ storeNumber: string }Yes

    Returns PizzahutMenu

    interface PizzahutMenuVariant {
      variantCode: string;
      name: string | null;
      priceCents: number;
      attributes: string[];  // e.g. ["Original Pan® Pizza", "Personal Pan"]
    }
    
    interface PizzahutMenuListItem {
      productCode: string;
      name: string | null;
      description: string | null;
      categoryCode: string;
      categoryName: string;
      currency: string;
      variants: PizzahutMenuVariant[];
    }
    
    interface PizzahutMenuCategory {
      categoryCode: string;
      categoryName: string;
      items: PizzahutMenuListItem[];
    }
    
    interface PizzahutMenu {
      storeNumber: string;
      currency: string;
      categories: PizzahutMenuCategory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pizzahut/getMenu

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pizzahut.getMenu({ storeNumber: "026196" });
  • getMenuItemReads one menu item in full for a store, by NAME ("Pepperoni Pizza") since the sibling getMenu that would hand out a productCode is still a stub.

    Arguments

    NameTypeRequired
    args{ storeNumber: string; item: string; category?: string }Yes

    Returns PizzahutMenuItem

    // ── getMenuItem ───────────────────────────────────────────────────────────
    interface PizzahutMenuItem {
      storeNumber: string;
      productCode: string;   // pass this + a variantCode below to priceOrder
      name: string | null;
      description: string | null;
      category: string | null;
      currency: string;
      variants: PizzahutMenuItemVariant[];
    }
    
    interface PizzahutMenuItemVariant {
      variantCode: string;   // the priced configuration, size and crust are IN this code
      name: string | null;
      priceCents: number;    // this variant's OWN starting price
      attributes: string[];  // e.g. ["Original Pan® Pizza", "Personal Pan"]
      slots: PizzahutMenuItemSlot[];
      servingSize: { quantity: number; unit: string } | null;
      allergens: { allergen: string; presence: string }[];
    }
    
    interface PizzahutMenuItemSlot {
      slotCode: string;                    // e.g. "slot_pizza_cheese", "slot_toppings"
      name: string | null;
      minAllowedSelections: number;
      maxAllowedSelections: number | null; // null = no cap the site publishes
      modifiers: PizzahutMenuItemModifier[];
    }
    
    interface PizzahutMenuItemModifier {
      modifierCode: string;
      name: string | null;
      weights: PizzahutMenuItemWeight[];   // portion/intensity choices for this modifier
    }
    
    interface PizzahutMenuItemWeight {
      modifierWeightCode: string;  // pass slotCode + modifierCode + this to priceOrder's modifiers
      name: string | null;         // e.g. "Light", "Regular", "Extra"
      priceCents: number;          // what THIS option costs on THIS variant, varies by size
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pizzahut/getMenuItem

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pizzahut.getMenuItem({ storeNumber: "026196", item: "Supreme Pizza" });
  • priceOrderPrices a configured basket at a store WITHOUT placing it.

    Arguments

    NameTypeRequired
    order{ storeNumber: string; items: { productCode: string; variantCode: string; quantity?: number; modifiers?: { slotCode: string; modifierCode: string; modifierWeightCode: string }[]; specialInstructions?: string }[]; fulfillment?: "carryout" | "delivery"; deliveryAddress?: { address: string; address2?: string; city: string; state: string; zip: string; deliveryInstructions?: string; phone?: string }; requestedTime?: string; promoCode?: string }Yes

    Returns PizzahutPricedOrder

    interface PizzahutPricedOrder {
      storeNumber: string;
      fulfillment: "CARRYOUT" | "DELIVERY";
      currency: string;
      lineItems: PizzahutPricedLineItem[];
      subtotalCents: number;          // after promotions, before tax and fees
      originalSubtotalCents: number;  // at menu price
      taxes: { name: string; amountCents: number }[];
      fees: { name: string; type: string; amountCents: number }[];  // type e.g. "DELIVERY_FEE"
      totalCents: number;             // the site's own total, not summed here
      promotions: { name: string; code: string | null; amountCents: number }[];
      deliveryProvider: string | null;
      estimatedPromisedTime: string | null;
      siteNotes: string[];            // always includes the payment one
      blockers: string[];             // what still stands between this and an order
    }
    
    interface PizzahutPricedLineItem {
      name: string | null;
      productCode: string | null;
      variantCode: string | null;
      quantity: number;
      priceCents: number;
      originalPriceCents: number;
      specialInstructions: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pizzahut/priceOrder

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pizzahut.priceOrder({
      storeNumber: "026196",
      items: [
        {
          productCode: "CLSS140SC|PROD475BQ",
          variantCode: "variant_CLSS140_475BQ_SIZE407EC_BASE610H1",
          quantity: 2
        }
      ]
    });

Use it from code