Toast MCP server for AI agents

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

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

Connect

Just Toast

An MCP server for Toast 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/toast
Every site

One MCP server for Toast 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 10
  • getMenuReads a restaurant's online-ordering menu: menus, groups, and items with name, description, price, image and availability, and the item guids…

    Arguments

    NameTypeRequired
    refToastRestaurantRefYes
    // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid.
    type ToastRestaurantRef = string;

    Returns ToastMenu

    interface ToastMenu {
      restaurantGuid: string;
      menus: Array<{ guid: string; name: string; description: string | null; groups: ToastMenuGroup[] }>;
    }
    
    interface ToastMenuGroup { guid: string; name: string; description: string | null; items: ToastMenuItemSummary[]; }
    
    interface ToastMenuItemSummary {
      guid: string;              // what getMenuItem and addToCart take
      groupGuid: string;
      name: string;
      description: string | null;
      price: number | null;      // dollars, the lowest when there are several
      prices: number[];
      outOfStock: boolean;
      hasModifiers: boolean;     // true = sizes or add-ons; getMenuItem lists them
      imageUrl: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.toast.getMenu("bombaytandoor");
  • getMenuItemReads one menu item with everything ordering it needs: sizes, modifier groups (required and optional, min and max), each option's price, and the…

    Arguments

    NameTypeRequired
    refToastRestaurantRefYes
    itemGuidstringYes
    itemGroupGuidstringNo
    // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid.
    type ToastRestaurantRef = string;

    Returns ToastMenuItemDetail

    interface ToastMenuItemDetail {
      guid: string;
      itemGroupGuid: string;
      name: string;
      description: string | null;
      price: number | null;      // dollars, the lowest when there are several
      prices: number[];
      outOfStock: boolean;
      calories: number | null;
      imageUrl: string | null;
      modifierGroups: ToastModifierGroup[]; // sizes and add-on choices, e.g. "Spice Level"
    }
    
    interface ToastModifierGroup {
      guid: string;
      name: string;
      minSelections: number;
      maxSelections: number;
      required: boolean;         // minSelections > 0
      modifiers: ToastModifier[];
    }
    
    interface ToastModifier {
      guid: string;               // the item guid addToCart takes for this choice
      itemGroupGuid: string | null;
      name: string;
      price: number;              // dollars, added to the item's own price
      isDefault: boolean;
      outOfStock: boolean;
      allowsDuplicates: boolean;
      modifierGroups: ToastModifierGroup[]; // add-ons unlocked once this modifier is chosen
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.toast.getMenuItem("bombaytandoor", "0fdcf679-8e3f-4f81-9831-92599c9a4b9f", "9002864c-a652-445d-9327-104e8212bbd7");
  • getOrderingOptionsSays how a restaurant takes online orders right now: takeout, delivery and catering on or off, the ASAP estimate, the future pickup and delivery…

    Arguments

    NameTypeRequired
    refToastRestaurantRefYes
    daysAheadnumberNo
    // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid.
    type ToastRestaurantRef = string;

    Returns ToastOrderingOptions

    interface ToastOrderingOptions {
      guid: string;
      timeZone: string | null;   // "America/New_York"
      onlineOrderingEnabled: boolean;
      toastLocalEnabled: boolean;
      deliveryAvailable: boolean;
      asapTakeout: boolean;
      asapDelivery: boolean;
      todaysHours: { takeout: ToastServicePeriod[]; delivery: ToastServicePeriod[] };
      diningOptions: ToastDiningOption[]; // the guid here is what setFulfillment takes
      schedule: Array<{ behavior: string; days: Array<{ date: string; note: string | null; periods: ToastServicePeriod[] }> }>;
    }
    
    interface ToastServicePeriod { start: string; end: string; }
    
    interface ToastDiningOption {
      guid: string;
      behavior: string;          // "TAKE_OUT", "DELIVERY", …
      asapAvailable: boolean;
      futureTimes: Array<{ date: string; times: string[] }>; // the pickup/delivery slots on offer
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/toast/getOrderingOptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.toast.getOrderingOptions("bombaytandoor");
  • getPopularItemsLists a restaurant's most-ordered items with price and guid.

    Arguments

    NameTypeRequired
    refToastRestaurantRefYes
    // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid.
    type ToastRestaurantRef = string;

    Returns ToastPopularItem[]

    interface ToastPopularItem {
      guid: string;               // what getMenuItem and addToCart take
      name: string;
      price: number | null;       // dollars, the lowest when there are several
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/toast/getPopularItems

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.toast.getPopularItems("bombaytandoor");
  • getReservationAvailabilityReads a Toast Tables restaurant's open reservation times for a party size across a date and time window, with the seating areas offered and any…

    Arguments

    NameTypeRequired
    refToastRestaurantRefYes
    args.partySizenumberYes
    args.startstring
    ISO date-time, the window's start.
    Yes
    args.hoursnumber
    Window length, default 4, max 24.
    No
    // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid.
    type ToastRestaurantRef = string;

    Returns ToastReservationAvailability

    interface ToastReservationAvailability {
      restaurantGuid: string;
      onTables: boolean;          // false: the restaurant takes no Toast reservations at all
      minPartySize: number | null;
      maxPartySize: number | null;
      onlineReservationsBlocked: boolean;
      blockedReason: string | null;
      slots: Array<{
        datetime: string;         // ISO instant
        serviceAreas: Array<{
          id: string;
          group: { id: string; name: string } | null;
          payment: { type: string | null; amount: number | null; currency: string | null; policy: string | null; refundableTimeframe: string | null } | null; // deposit or card hold; null when none
        }>;
      }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/toast/getReservationAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.toast.getReservationAvailability("gupshup-115-e-18-street", { partySize: 2, start: { $daysFromNow: 3 }, hours: 24 });
  • getRestaurantReads one Toast restaurant by its toast.app URL, slug ("bombaytandoor") or guid: name, cuisine, address, phone, whether online ordering, delivery…

    Arguments

    NameTypeRequired
    refToastRestaurantRefYes
    // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid.
    type ToastRestaurantRef = string;

    Returns ToastRestaurant

    interface ToastRestaurant {
      guid: string;              // the id every other toast function takes
      shortUrl: string | null;   // the slug in toast.app/r/<slug>
      url: string | null;
      name: string;
      description: string | null;
      cuisine: string | null;
      address: ToastAddress;
      phone: string | null;
      onlineOrderingEnabled: boolean;
      deliveryOffered: boolean;
      reservationsEnabled: boolean;
      waitlistEnabled: boolean;
      websiteUrl: string | null;
      logoUrl: string | null;
      rating: { average: number; count: number } | null;
    }
    
    interface ToastAddress {
      line1: string | null;
      line2: string | null;
      city: string | null;
      state: string | null;
      zip: string | null;
      country: string | null;
      latitude: number | null;
      longitude: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/toast/getRestaurant

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.toast.getRestaurant("bombaytandoor");
  • listCitiesLists the ~400 US cities Toast's restaurant directory covers (toast.app/cities): name, two-letter state, and the city slug listCityRestaurants takes.

    Arguments

    None.

    Returns ToastCity[]

    interface ToastCity {
      slug: string;              // "richmond-va", what listCityRestaurants takes
      name: string;
      state: string;             // two-letter
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/toast/listCities

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.toast.listCities();
  • listCityRestaurantsLists the Toast restaurants in a city ("richmond-va"), optionally by cuisine (pizza, sushi, thai...), the way toast.app's city pages do: name…

    Arguments

    NameTypeRequired
    citystring
    A slug from listCities, e.g. "richmond-va".
    Yes
    cuisinestring
    "pizza", "sushi", "middle-eastern"… (toast.app's cuisine pages).
    No

    Returns ToastCityRestaurant[]

    interface ToastCityRestaurant {
      shortUrl: string;          // the slug getRestaurant takes
      url: string;
      name: string;
      cuisine: string | null;
      neighborhood: string | null; // the card's place line
      priceTier: string | null;  // "$" … "$$$$"
      rating: { average: number; count: number } | null;
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/toast/listCityRestaurants

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.toast.listCityRestaurants({ city: "richmond-va" });
  • searchMenuSearches one restaurant's menu by words ("paneer") and returns the matching items with price and guid.

    Arguments

    NameTypeRequired
    refToastRestaurantRefYes
    querystringYes
    limitnumberNo
    // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid.
    type ToastRestaurantRef = string;

    Returns ToastMenuSearchItem[]

    interface ToastMenuSearchItem {
      guid: string;               // what getMenuItem and addToCart take
      name: string;
      description: string | null;
      price: number | null;
      outOfStock: boolean;
      imageUrl: string | null;
      group: { guid: string; name: string } | null; // the item's menu group, if it has one
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/toast/searchMenu

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.toast.searchMenu("bombaytandoor", "paneer");
  • searchRestaurantsFinds Toast restaurants near a latitude/longitude, nearest first, optionally by free text, cuisine, or for delivery, pickup or reservations: name…

    Arguments

    NameTypeRequired
    latnumber
    One latitude and one longitude are required; the runtime reads each under any of these names.
    No
    latitudenumberNo
    lngnumberNo
    lonnumberNo
    longitudenumberNo
    querystring
    Free text, e.g. "pizza" or a restaurant name.
    No
    cuisinestring | string[]
    "pizza", "middle-eastern", "bbq"… (toast.app's cuisine list).
    No
    context"delivery" | "pickup" | "reservations"No
    limitnumber
    1-100, default 20.
    No

    Returns ToastSearchResult[]

    interface ToastAddress {
      line1: string | null;
      line2: string | null;
      city: string | null;
      state: string | null;
      zip: string | null;
      country: string | null;
      latitude: number | null;
      longitude: number | null;
    }
    
    interface ToastSearchResult {
      guid: string;
      shortUrl: string | null;
      url: string | null;
      name: string;
      cuisine: string | null;
      distanceMiles: number | null;
      address: ToastAddress;
      imageUrl: string | null;
      priceTier: { label: string | null; range: string | null } | null;
      rating: { average: number; count: number } | null;
      onlineOrderingEnabled: boolean;
      deliveryOffered: boolean;
      asapDelivery: boolean;
      asapTakeout: boolean;
      minimumDeliveryMinutes: number | null;
      minimumTakeoutMinutes: number | null;
      deliveryPromotion: string | null;
      reservationsEnabled: boolean;
      waitlistEnabled: boolean;
      managementSetGuid: string | null; // shared by a restaurant group's sister locations
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/toast/searchRestaurants

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.toast.searchRestaurants({
      lat: 39.04372,
      lng: -77.48749,
      cuisine: "pizza",
      limit: 5
    });

Use it from code