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.
- Site
- pizzahut.com
- Functions
- 5
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/pizzahutOne 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/mcpSet it up in your clientBoth 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.
findStoresFinds the Pizza Hut stores that serve a given address or ZIP.Arguments
Name Type Required 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/findStoresCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pizzahut.findStores("90210", { limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pizzahut.findStores("90210", {"limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/pizzahut/findStores \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"where":"90210","options":{"limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getDealsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pizzahut.getDeals({ storeNumber: "026196" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pizzahut.getDeals({"storeNumber": "026196"}))curl -X POST https://api.bowmark.ai/v1/sites/pizzahut/getDeals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"storeNumber":"026196"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ storeNumber: string }Yes Returns
PizzahutMenuinterface 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/getMenuCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pizzahut.getMenu({ storeNumber: "026196" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pizzahut.getMenu({"storeNumber": "026196"}))curl -X POST https://api.bowmark.ai/v1/sites/pizzahut/getMenu \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"storeNumber":"026196"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getMenuItemCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pizzahut.getMenuItem({ storeNumber: "026196", item: "Supreme Pizza" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pizzahut.getMenuItem({"storeNumber": "026196", "item": "Supreme Pizza"}))curl -X POST https://api.bowmark.ai/v1/sites/pizzahut/getMenuItem \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"storeNumber":"026196","item":"Supreme Pizza"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pizzahut.getMenuItem({ storeNumber: "026196", item: "Supreme Pizza" });priceOrderPrices a configured basket at a store WITHOUT placing it.Arguments
Name Type Required 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
PizzahutPricedOrderinterface 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/priceOrderCall 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 } ] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pizzahut.priceOrder({ "storeNumber": "026196", "items": [ { "productCode": "CLSS140SC|PROD475BQ", "variantCode": "variant_CLSS140_475BQ_SIZE407EC_BASE610H1", "quantity": 2 } ] }))curl -X POST https://api.bowmark.ai/v1/sites/pizzahut/priceOrder \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"order":{"storeNumber":"026196","items":[{"productCode":"CLSS140SC|PROD475BQ","variantCode":"variant_CLSS140_475BQ_SIZE407EC_BASE610H1","quantity":2}]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pizzahut.priceOrder({ storeNumber: "026196", items: [ { productCode: "CLSS140SC|PROD475BQ", variantCode: "variant_CLSS140_475BQ_SIZE407EC_BASE610H1", quantity: 2 } ] });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/pizzahut/<function> - OpenAPI
/v1/sites/pizzahut/openapi.json