Slice MCP server for AI agents

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

Functions
14
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Slice

An MCP server for Slice 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/slice
Every site

One MCP server for Slice 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 that need a login use the person's own account: how sign-in works.

Functions

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

Read 14
  • checkDeliveryChecks whether a pizzeria delivers to an address and, if it does, the delivery fee, minimum order and whether delivery is available right now.

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes
    addressstringYes

    Returns SliceDeliveryCheck

    interface SliceDeliveryCheck {
      deliversTo: boolean;         // false means the address is outside the delivery zone
      availableNow: boolean;       // only meaningful when deliversTo -- the shop may be closed
      minimumOrder: number | null; // dollars; null outside the zone
      deliveryFeeFlat: number | null;    // dollars; null outside the zone or priced by percent
      deliveryFeePercent: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/checkDelivery

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.checkDelivery("oh/kirtland/44094/biga-wood-fired-pizzeria", "8658 Mentor Ave, Mentor, OH 44060");
  • getDeliveryEstimateGets the delivery fee and pickup/dropoff times a third-party courier (Uber Direct, DoorDash Drive and similar) would charge for an order from a…

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes
    addressstringYes
    subtotalnumberYes

    Returns SliceDeliveryEstimate

    interface SliceDeliveryEstimate {
      thirdPartyCourier: boolean;  // false: the shop delivers itself, no courier quote
      provider: string | null;     // e.g. "uber_direct"
      fee: number | null;          // dollars
      pickupTime: string | null;   // ISO instant
      dropoffTime: string | null;  // ISO instant
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/getDeliveryEstimate

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.getDeliveryEstimate(35712, "8100 Euclid Chardon Rd, Kirtland, OH 44094", 18);
  • getHoursGets when a pizzeria takes delivery and pickup orders over the coming days, as open/close windows, plus any pause it is in right now.

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes

    Returns SliceSchedule

    interface SliceScheduleWindow {
      from: string;                // ISO instant, UTC
      to: string;                  // ISO instant, UTC
    }
    
    interface SliceSchedule {
      delivery: SliceScheduleWindow[];
      pickup: SliceScheduleWindow[];
      pausedForDelivery: SliceScheduleWindow[];
      pausedForPickup: SliceScheduleWindow[];
      timezone: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/getHours

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.getHours("oh/kirtland/44094/biga-wood-fired-pizzeria");
  • getLoyaltyProgramGets a pizzeria's Slice rewards program, if it runs one: points per dollar and the reward milestones.

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes

    Returns SliceLoyaltyProgram

    interface SliceLoyaltyReward {
      itemId: number | null;
      name: string;
      sizeId: number | null;       // the size id priceCart takes
      sizeName: string | null;
    }
    
    interface SliceLoyaltyMilestone {
      id: string;
      name: string;
      pointsRequired: number;
      rewards: SliceLoyaltyReward[];
    }
    
    interface SliceLoyaltyProgram {
      enabled: boolean;            // the shop runs a Slice rewards program
      pointsPerDollar: number | null; // null when no program runs
      milestones: SliceLoyaltyMilestone[]; // may be empty even when enabled
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/getLoyaltyProgram

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.getLoyaltyProgram(35712);
  • getMenuGets a pizzeria's full menu: categories, items with descriptions, photos and best-seller flags, and every size with its price -- the door for the…

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes

    Returns SliceMenu

    interface SliceMenuSize {
      id: number;                // what getMenuItemOptions takes as sizeId
      name: string;               // e.g. "12""
      price: number;               // dollars
    }
    
    interface SliceMenuItem {
      id: number;
      name: string;
      description: string | null;
      image: string | null;
      isBestSeller: boolean;
      sizes: SliceMenuSize[];
    }
    
    interface SliceMenuCategory {
      id: number;
      name: string;
      items: SliceMenuItem[];
    }
    
    interface SliceMenu {
      shopId: number | null;
      categories: SliceMenuCategory[]; // hidden "Non Display Products" categories dropped
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.getMenu(35712);
  • getMenuItemOptionsGets the choices for one menu item and size: required and optional add-on groups (sauce, cheese, toppings) with each option's price and the min/max a…

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes
    sizeIdnumberYes

    Returns SliceAddonGroup[]

    interface SliceAddonPrice {
      id: number;                // what priceCart takes as a selection id
      price: number;               // dollars
    }
    
    interface SliceAddonSelection {
      id: number;
      name: string;
      prices: SliceAddonPrice[];  // >1 entry means the site prices this choice by coverage
    }
    
    interface SliceAddonGroup {
      id: number;
      name: string;                // e.g. "Choose Sauce Option"
      required: boolean;
      limit: number | null;        // how many selections this group allows
      selections: SliceAddonSelection[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/getMenuItemOptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.getMenuItemOptions(35712, 21819494);
  • getPizzeriaGets one pizzeria's details from its Slice menu URL, web slug or shop id: name, address and coordinates, phone, open now for delivery and pickup…

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes

    Returns SlicePizzeriaDetail

    // getPizzeria, getMenu, getMenuItemOptions and getHours all take "pizzeria": a
    // Slice menu URL, the full web slug, or a numeric shop id -- whatever
    // searchPizzerias/listPizzeriasInCity returned.
    interface SlicePizzeriaDetail {
      id: string;               // shop uuid
      shopId: number;
      name: string;
      webSlug: string | null;
      menuUrl: string | null;
      address: string | null;
      city: string | null;
      state: string | null;
      zip: string | null;
      latitude: number | null;
      longitude: number | null;
      phone: string | null;
      isOpenForDelivery: boolean;
      isOpenForPickup: boolean;
      nextOpeningDelivery: string | null; // ISO instant
      nextOpeningPickup: string | null;
      deliveryMinutes: { min: number; max: number } | null;
      pickupMinutes: { min: number; max: number } | null;
      deliveryMinimum: number | null;     // dollars
      pickupMinimum: number | null;       // dollars
      deliveryProvider: string | null;    // e.g. "uber_direct"; null when the shop drives
      serviceFeeFlat: number | null;      // dollars
      serviceFeePercent: number | null;
      acceptsCash: boolean;
      acceptsCards: boolean;
      cuisines: string[];
      holidays: unknown;
      timezone: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/getPizzeria

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.getPizzeria("oh/kirtland/44094/biga-wood-fired-pizzeria");
  • getRecommendedAddOnsGets the add-ons a pizzeria suggests for what is already in the cart ("add garlic knots?").

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes
    items{ itemId: number; sizeId: number; quantity?: number }[]Yes

    Returns { addOns: SliceRecommendedAddOn[] }

    interface SliceRecommendedAddOn {
      itemId: number;
      name: string;
      description: string | null;
      price: number | null;        // dollars
      image: string | null;
      sizeIds: number[];           // the size ids priceCart takes
      isBestSeller: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/getRecommendedAddOns

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.getRecommendedAddOns(35712, [{ itemId: 11457535, sizeId: 14429626 }]);
  • getReviewsLists a pizzeria's customer reviews, newest first -- star rating, text, date and the reviewer's first name only -- with the overall rating and count.

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes

    Returns { reviews: SliceReview[] } & SliceRatingSummary

    interface SliceReview {
      id: number;
      rating: number;
      body: string | null;
      reviewerFirstName: string | null; // never the reviewer's email or last name
      orderedItemNames: string[];
      createdAt: string | null;    // ISO instant
    }
    
    interface SliceRatingSummary {
      rating: number | null;       // null when the shop has too few reviews to show one
      ratingCount: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/getReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.getReviews("oh/kirtland/44094/biga-wood-fired-pizzeria");
  • listPizzeriasInCityLists the Slice pizzerias in a city ("Brooklyn, NY"), the site's city pages: name, address, cuisines, rating and shop id, with no street address…

    Arguments

    NameTypeRequired
    citystring
    "Brooklyn".
    Yes
    statestring
    Two-letter code, "NY".
    Yes
    limitnumber
    1-50, default 20.
    No
    offsetnumberNo

    Returns SlicePizzeriaPage

    interface SlicePizzeria {
      id: string;              // shop uuid
      shopId: number | null;   // numeric shop id, what getPizzeria and getMenu take
      name: string;
      webSlug: string | null;  // "<st>/<city>/<zip>/<slug>", what getHours takes
      menuUrl: string | null;
      address: string | null;
      city: string | null;
      state: string | null;
      zip: string | null;
      latitude: number | null;
      longitude: number | null;
      phone: string | null;
      cuisineStyle: string | null;
      cuisines: string[];
      chain: string | null;
      rating: number | null;   // out of 5
      ratingCount: number | null;
      isOpenForDelivery: boolean;
      isOpenForPickup: boolean;
      nextOpeningDelivery: string | null; // ISO instant
      nextOpeningPickup: string | null;
      deliversToAddress: boolean | null;  // set by an address search only
      deliveryFee: number | null;         // dollars
      deliveryMinimum: number | null;     // dollars
      deliveryMinutes: { min: number; max: number } | null;
      pickupMinutes: { min: number; max: number } | null;
      deliveryProvider: string | null;    // e.g. "uber_direct"; null when the shop drives
      acceptsScheduledOrders: boolean;
      timezone: string | null;
    }
    
    interface SlicePizzeriaPage {
      pizzerias: SlicePizzeria[];
      total: number | null;    // every match the site counted, across all pages
      offset: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/listPizzeriasInCity

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.listPizzeriasInCity({ city: "Brooklyn", state: "NY", limit: 5 });
  • priceCartPrices an order before checkout -- items with sizes and add-on choices, delivery or pickup, an optional tip, and (silently ignored if invalid -- use…

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes
    shippingType"delivery" | "pickup"Yes
    itemsSliceCartItem[]Yes
    deliveryAddressstring
    Required when shippingType is "delivery".
    No
    tipAmountnumber
    Dollars.
    No
    promoCodestring
    Silently has no effect if invalid -- check with validatePromoCode first.
    No

    Returns SliceCartPrice

    interface SliceCartReceipt {
      subtotal: number;
      tax: number;
      deliveryFee: number;
      serviceFeeAmount: number;
      serviceFeePercent: number | null;
      shopDiscount: number;
      couponDiscount: number;
      promoCodeDiscount: number;
      tipAmount: number;
      total: number;
    }
    
    interface SliceCartValidationIssue {
      code: string;                // e.g. "menu_item_addon_required", "shipping_type_unavailable"
      message: string;             // the site's own sentence
    }
    
    interface SliceCartPrice {
      receipt: SliceCartReceipt | null;
      issues: SliceCartValidationIssue[]; // empty means the order is placeable as priced
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/priceCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.priceCart({
      pizzeria: 35712,
      shippingType: "pickup",
      items: [
        {
          sizeId: 14429934,
          selectionIds: [307101877, 307101881, 307101883]
        }
      ]
    });
  • resolveAddressTurns an address a caller typed ("8658 Mentor Ave, Mentor, OH") into Slice's own geocode: formatted address, latitude/longitude, city, state and ZIP…

    Arguments

    NameTypeRequired
    addressstringYes

    Returns SliceLocation

    interface SliceLocation {
      address: string;         // the geocoder's formatted address
      latitude: number;
      longitude: number;
      street: string | null;
      city: string | null;
      state: string | null;
      zip: string | null;
      precision: string | null; // e.g. "ROOFTOP"
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/resolveAddress

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.resolveAddress("8658 Mentor Ave, Mentor, OH");
  • searchPizzeriasFinds the Slice pizzerias that deliver to an address (or are near it, for pickup): name, address, cuisine style, rating, open-now for delivery and…

    Arguments

    NameTypeRequired
    addressstring
    A street address, "8658 Mentor Ave, Mentor, OH".
    Yes
    mode"delivery" | "pickup"
    Delivery (default): shops that deliver there; pickup: shops within ~10 miles.
    No
    sort"recommended" | "nearby" | "rating" | "delivery_estimate"No
    limitnumber
    1-50, default 20.
    No
    offsetnumberNo

    Returns SlicePizzeriaPage & { location: SliceLocation }

    interface SliceLocation {
      address: string;         // the geocoder's formatted address
      latitude: number;
      longitude: number;
      street: string | null;
      city: string | null;
      state: string | null;
      zip: string | null;
      precision: string | null; // e.g. "ROOFTOP"
    }
    
    interface SlicePizzeria {
      id: string;              // shop uuid
      shopId: number | null;   // numeric shop id, what getPizzeria and getMenu take
      name: string;
      webSlug: string | null;  // "<st>/<city>/<zip>/<slug>", what getHours takes
      menuUrl: string | null;
      address: string | null;
      city: string | null;
      state: string | null;
      zip: string | null;
      latitude: number | null;
      longitude: number | null;
      phone: string | null;
      cuisineStyle: string | null;
      cuisines: string[];
      chain: string | null;
      rating: number | null;   // out of 5
      ratingCount: number | null;
      isOpenForDelivery: boolean;
      isOpenForPickup: boolean;
      nextOpeningDelivery: string | null; // ISO instant
      nextOpeningPickup: string | null;
      deliversToAddress: boolean | null;  // set by an address search only
      deliveryFee: number | null;         // dollars
      deliveryMinimum: number | null;     // dollars
      deliveryMinutes: { min: number; max: number } | null;
      pickupMinutes: { min: number; max: number } | null;
      deliveryProvider: string | null;    // e.g. "uber_direct"; null when the shop drives
      acceptsScheduledOrders: boolean;
      timezone: string | null;
    }
    
    interface SlicePizzeriaPage {
      pizzerias: SlicePizzeria[];
      total: number | null;    // every match the site counted, across all pages
      offset: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/searchPizzerias

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.searchPizzerias({ address: "8658 Mentor Ave, Mentor, OH", limit: 5 });
  • validatePromoCodeChecks whether a promo code works at a pizzeria for a given order, and what it takes off.

    Arguments

    NameTypeRequired
    pizzeriastring | numberYes
    promoCodestringYes
    itemsSliceCartItem[]Yes
    shippingType"delivery" | "pickup"Yes
    interface SliceCartItem {
      sizeId: number;              // from getMenu's item.sizes[].id
      quantity?: number;           // default 1
      selectionIds?: number[];     // add-on selection ids from getMenuItemOptions
    }

    Returns SlicePromoCodeResult

    interface SlicePromoCodeResult {
      valid: boolean;
      reason: string | null;       // the site's own words, when valid is false
      flatAmount: number | null;   // dollars, when the code takes a flat amount off
      percent: number | null;      // when the code takes a percentage off
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/slice/validatePromoCode

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.slice.validatePromoCode(35712, "PIZZA10", [
      {
        sizeId: 14429934,
        selectionIds: [307101877, 307101881, 307101883]
      }
    ], "pickup");

Use it from code