OpenTable MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on OpenTable: 7 typed functions through one MCP server. No OpenTable API key needed.
- Site
- opentable.com
- Functions
- 7
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for OpenTable 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/opentableOne MCP server for OpenTable 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.
checkAvailabilityReads one restaurant's open reservation times around a time on a date for a party size, the same times its OpenTable page offers, each with…Arguments
Name Type Required restaurantIdnumberFrom a search row.Yes datestring"YYYY-MM-DD", default tomorrow (UTC).No timestring"HH:mm" 24h local, default "19:00".No partySizenumber1-20, default 2.No Returns
OpenTableAvailabilityinterface OpenTableSlot { dateTime: string; // local start time, "YYYY-MM-DDTHH:mm", restaurant's own timezone type: string | null; // OpenTable's seating type, e.g. "Standard" | "Experience" bookingUrl: string; // OpenTable's own booking page for exactly this time // The handoff: give the person checkout.url (bookingUrl, typed) and stop. They // reserve on OpenTable themselves; Bowmark never books. Null if the link is unusable. checkout: { status: string; url: string; urlKind: string; account: { site: string; hint: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null }[]; total: string | null; currency: string; dates?: { start: string; end?: string }; guests?: number }; warnings: string[] } | null; } interface OpenTableRestaurant { restaurantId: number; // what checkAvailability takes name: string; profileUrl: string; address: string | null; city: string | null; neighborhood: string | null; cuisine: string | null; priceBand: string | null; // e.g. "$31 to $50" rating: number | null; // 0-5 reviewCount: number | null; maxPartySize: number | null; latitude: number | null; longitude: number | null; } // A fast read of a restaurant a search already named carries the SEARCH row's fields: // address, cuisine, priceBand, rating, reviewCount and maxPartySize may then be null. // slots are always read live. interface OpenTableAvailability extends OpenTableRestaurant { date: string; time: string; partySize: number; slots: OpenTableSlot[]; // open times around `time`; [] = nothing open for that party }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/opentable/checkAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.opentable.checkAvailability({ restaurantId: 1935, date: { $daysFromNow: 7 }, time: "19:00", partySize: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.opentable.checkAvailability({ "restaurantId": 1935, "date": {"$daysFromNow": 7}, "time": "19:00", "partySize": 2 }))curl -X POST https://api.bowmark.ai/v1/sites/opentable/checkAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"restaurantId":1935,"date":{"$daysFromNow":7},"time":"19:00","partySize":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.opentable.checkAvailability({ restaurantId: 1935, date: { $daysFromNow: 7 }, time: "19:00", partySize: 2 });confirmBookingFinishes the booking startBooking began in the same session: enters the texted code, fills the diner's name, phone and email, completes the…Arguments
Name Type Required args{ code: string }Yes Returns
OpenTableBookinginterface OpenTableBooking { restaurantId: number; restaurantName: string | null; dateTime: string; partySize: number; confirmationNumber: string | null; reservationUrl: string; // OpenTable's page for this reservation; cancelBooking takes it confirmationText: string; // the confirmation page's own first lines }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/opentable/confirmBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.opentable.confirmBooking({ code: "000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.opentable.confirmBooking({"code": "000000"}))curl -X POST https://api.bowmark.ai/v1/sites/opentable/confirmBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"code":"000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.opentable.confirmBooking({ code: "000000" });getBookingReads a reservation back from its OpenTable page link, from any later session: whether it still stands or was cancelled, the restaurant and the…Arguments
Name Type Required args{ reservationUrl: string }Yes Returns
OpenTableBookingStatusinterface OpenTableBookingStatus { status: "confirmed" | "canceled"; restaurantName: string | null; confirmationNumber: string | null; reservationUrl: string; pageText: string; // the reservation page's own first lines }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/opentable/getBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.opentable.getBooking({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.opentable.getBooking({}))curl -X POST https://api.bowmark.ai/v1/sites/opentable/getBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.opentable.getBooking({});listMyReservationsLists the signed-in diner's own reservations from the dining dashboard, upcoming and past, newest first: restaurant, date and time, party size…Arguments
None.
Returns
OpenTableMyReservationsinterface OpenTableMyReservation { confirmationNumber: string | null; restaurantId: number | null; restaurantName: string | null; dateTime: string | null; // local start time, restaurant's own timezone partySize: number | null; status: string | null; // OpenTable's own state, verbatim, the site's own labels, read the values off a result, never guess one from prose cancelled: boolean; upcoming: boolean; // starts after now reservationUrl: string | null; // pass to getBooking / cancelBooking } interface OpenTableMyReservations { /** Newest first, furthest-out upcoming first, oldest past last. Empty when there are none. */ reservations: OpenTableMyReservation[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/opentable/listMyReservationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.opentable.listMyReservations();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.opentable.listMyReservations())curl -X POST https://api.bowmark.ai/v1/sites/opentable/listMyReservations \ -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.opentable.listMyReservations();searchFinds restaurants on OpenTable for a name, cuisine or dish: a restaurant's name through OpenTable's own search-box suggestions (id, neighborhood…Arguments
Name Type Required argsstring | OpenTableSearchArgsYes interface OpenTableSearchArgs { query: string; // a restaurant name, cuisine or dish, e.g. "Kokkari Estiatorio" | "italian" date?: string; // "YYYY-MM-DD", default tomorrow (UTC) time?: string; // "HH:mm" 24h, local to the restaurants, default "19:00" partySize?: number; // 1-20, default 2 latitude?: number; // where to search around; orders same-name restaurants nearest first longitude?: number; }Returns
OpenTableSearchResultinterface OpenTableRestaurant { restaurantId: number; // what checkAvailability takes name: string; profileUrl: string; address: string | null; city: string | null; neighborhood: string | null; cuisine: string | null; priceBand: string | null; // e.g. "$31 to $50" rating: number | null; // 0-5 reviewCount: number | null; maxPartySize: number | null; latitude: number | null; longitude: number | null; } interface OpenTableSearchResult { query: string; date: string; time: string; partySize: number; restaurants: OpenTableRestaurant[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/opentable/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.opentable.search({ query: "Kokkari Estiatorio", date: { $daysFromNow: 7 }, latitude: 37.7749, longitude: -122.4194 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.opentable.search({ "query": "Kokkari Estiatorio", "date": {"$daysFromNow": 7}, "latitude": 37.7749, "longitude": -122.4194 }))curl -X POST https://api.bowmark.ai/v1/sites/opentable/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Kokkari Estiatorio","date":{"$daysFromNow":7},"latitude":37.7749,"longitude":-122.4194}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.opentable.search({ query: "Kokkari Estiatorio", date: { $daysFromNow: 7 }, latitude: 37.7749, longitude: -122.4194 });
cancelBookingCancels a reservation from its OpenTable confirmation page: Cancel, then Confirm cancellation.Arguments
Name Type Required args{ reservationUrl: string }Yes Returns
OpenTableCancellationinterface OpenTableCancellation { canceled: boolean; pageText: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/opentable/cancelBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.opentable.cancelBooking({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.opentable.cancelBooking({}))curl -X POST https://api.bowmark.ai/v1/sites/opentable/cancelBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.opentable.cancelBooking({});startBookingStarts a guest reservation for one open time: clicks the time on the restaurant's page, accepts the restaurant's terms, presses Complete reservation…Arguments
Name Type Required restaurantIdnumberFrom a search row.Yes dateTimestring"YYYY-MM-DDTHH:mm", a slots[].dateTime from checkAvailability.Yes partySizenumber1-20.Yes dinerOpenTableDinerYes specialRequeststringNo seatingstringE.g. "Outdoor"; only some restaurants ask.No Returns
OpenTableBookingStartedinterface OpenTableBookingStarted { status: "code_sent"; restaurantId: number; dateTime: string; partySize: number; codeSentTo: string; // masked phone, e.g. "***-***-5219" holdExpiresAt: string; // ISO; OpenTable holds the table 5 minutes seating?: string; // the seating option booked, when the restaurant asked for one seatingOptions?: string[]; // every seating option it offered at that time }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/opentable/startBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.opentable.startBooking({ restaurantId: 1, dateTime: "<dateTime>", partySize: 1, diner: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.opentable.startBooking({ "restaurantId": 1, "dateTime": "<dateTime>", "partySize": 1, "diner": {} }))curl -X POST https://api.bowmark.ai/v1/sites/opentable/startBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"restaurantId":1,"dateTime":"<dateTime>","partySize":1,"diner":{}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.opentable.startBooking({ restaurantId: 1, dateTime: "<dateTime>", partySize: 1, diner: {} });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/opentable/<function> - OpenAPI
/v1/sites/opentable/openapi.json