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.

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

Connect

Just OpenTable

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/opentable
Every site

One MCP server for OpenTable 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 5
  • 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

    NameTypeRequired
    restaurantIdnumber
    From a search row.
    Yes
    datestring
    "YYYY-MM-DD", default tomorrow (UTC).
    No
    timestring
    "HH:mm" 24h local, default "19:00".
    No
    partySizenumber
    1-20, default 2.
    No

    Returns OpenTableAvailability

    interface 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/checkAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    args{ code: string }Yes

    Returns OpenTableBooking

    interface 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/confirmBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    args{ reservationUrl: string }Yes

    Returns OpenTableBookingStatus

    interface 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/getBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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 OpenTableMyReservations

    interface 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/listMyReservations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.opentable.listMyReservations();
Act 2
  • cancelBookingCancels a reservation from its OpenTable confirmation page: Cancel, then Confirm cancellation.

    Arguments

    NameTypeRequired
    args{ reservationUrl: string }Yes

    Returns OpenTableCancellation

    interface OpenTableCancellation {
      canceled: boolean;
      pageText: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/opentable/cancelBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    restaurantIdnumber
    From a search row.
    Yes
    dateTimestring
    "YYYY-MM-DDTHH:mm", a slots[].dateTime from checkAvailability.
    Yes
    partySizenumber
    1-20.
    Yes
    dinerOpenTableDinerYes
    specialRequeststringNo
    seatingstring
    E.g. "Outdoor"; only some restaurants ask.
    No

    Returns OpenTableBookingStarted

    interface 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/startBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.opentable.startBooking({
      restaurantId: 1,
      dateTime: "<dateTime>",
      partySize: 1,
      diner: {}
    });

Use it from code