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.
- Site
- toasttab.com
- Functions
- 10
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/toastOne MCP server for Toast 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 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.
getMenuReads a restaurant's online-ordering menu: menus, groups, and items with name, description, price, image and availability, and the item guids…Arguments
Name Type Required refToastRestaurantRefYes // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid. type ToastRestaurantRef = string;Returns
ToastMenuinterface 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/getMenuCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.toast.getMenu("bombaytandoor");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.toast.getMenu("bombaytandoor"))curl -X POST https://api.bowmark.ai/v1/sites/toast/getMenu \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"bombaytandoor"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required refToastRestaurantRefYes itemGuidstringYes itemGroupGuidstringNo // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid. type ToastRestaurantRef = string;Returns
ToastMenuItemDetailinterface 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/getMenuItemCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.toast.getMenuItem("bombaytandoor", "0fdcf679-8e3f-4f81-9831-92599c9a4b9f", "9002864c-a652-445d-9327-104e8212bbd7");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.toast.getMenuItem("bombaytandoor", "0fdcf679-8e3f-4f81-9831-92599c9a4b9f", "9002864c-a652-445d-9327-104e8212bbd7"))curl -X POST https://api.bowmark.ai/v1/sites/toast/getMenuItem \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"bombaytandoor","itemGuid":"0fdcf679-8e3f-4f81-9831-92599c9a4b9f","itemGroupGuid":"9002864c-a652-445d-9327-104e8212bbd7"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required refToastRestaurantRefYes daysAheadnumberNo // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid. type ToastRestaurantRef = string;Returns
ToastOrderingOptionsinterface 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/getOrderingOptionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.toast.getOrderingOptions("bombaytandoor");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.toast.getOrderingOptions("bombaytandoor"))curl -X POST https://api.bowmark.ai/v1/sites/toast/getOrderingOptions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"bombaytandoor"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.toast.getOrderingOptions("bombaytandoor");getPopularItemsLists a restaurant's most-ordered items with price and guid.Arguments
Name Type Required 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/getPopularItemsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.toast.getPopularItems("bombaytandoor");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.toast.getPopularItems("bombaytandoor"))curl -X POST https://api.bowmark.ai/v1/sites/toast/getPopularItems \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"bombaytandoor"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required refToastRestaurantRefYes args.partySizenumberYes args.startstringISO date-time, the window's start.Yes args.hoursnumberWindow 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
ToastReservationAvailabilityinterface 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/getReservationAvailabilityCall 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 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.toast.getReservationAvailability("gupshup-115-e-18-street", {"partySize": 2, "start": {"$daysFromNow": 3}, "hours": 24}))curl -X POST https://api.bowmark.ai/v1/sites/toast/getReservationAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"gupshup-115-e-18-street","args":{"partySize":2,"start":{"$daysFromNow":3},"hours":24}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required refToastRestaurantRefYes // A toast.app URL ("https://toast.app/r/bombaytandoor"), a slug ("bombaytandoor") or a guid. type ToastRestaurantRef = string;Returns
ToastRestaurantinterface 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/getRestaurantCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.toast.getRestaurant("bombaytandoor");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.toast.getRestaurant("bombaytandoor"))curl -X POST https://api.bowmark.ai/v1/sites/toast/getRestaurant \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"bombaytandoor"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listCitiesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.toast.listCities();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.toast.listCities())curl -X POST https://api.bowmark.ai/v1/sites/toast/listCities \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required citystringA 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/listCityRestaurantsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.toast.listCityRestaurants({ city: "richmond-va" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.toast.listCityRestaurants({"city": "richmond-va"}))curl -X POST https://api.bowmark.ai/v1/sites/toast/listCityRestaurants \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"city":"richmond-va"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchMenuCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.toast.searchMenu("bombaytandoor", "paneer");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.toast.searchMenu("bombaytandoor", "paneer"))curl -X POST https://api.bowmark.ai/v1/sites/toast/searchMenu \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"bombaytandoor","query":"paneer"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required latnumberOne latitude and one longitude are required; the runtime reads each under any of these names.No latitudenumberNo lngnumberNo lonnumberNo longitudenumberNo querystringFree 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 limitnumber1-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/searchRestaurantsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.toast.searchRestaurants({ lat: 39.04372, lng: -77.48749, cuisine: "pizza", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.toast.searchRestaurants({ "lat": 39.04372, "lng": -77.48749, "cuisine": "pizza", "limit": 5 }))curl -X POST https://api.bowmark.ai/v1/sites/toast/searchRestaurants \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"lat":39.04372,"lng":-77.48749,"cuisine":"pizza","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.toast.searchRestaurants({ lat: 39.04372, lng: -77.48749, cuisine: "pizza", limit: 5 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/toast/<function> - OpenAPI
/v1/sites/toast/openapi.json