Resy MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Resy: 8 typed functions through one MCP server. No Resy API key needed.

Functions
8
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Resy

An MCP server for Resy 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/resy
Every site

One MCP server for Resy 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

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

Read 5
  • checkAvailabilityReads real-time open reservation slots for one venue, one date and a party size.

    Arguments

    NameTypeRequired
    args{ venueId: number; day: string; partySize?: number }Yes

    Returns ResyAvailability

    interface ResySlot {
      startsAt: string;
      seatingType: string | null;
      token: string | null;
    }
    
    interface ResyAvailability {
      venueId: number;
      name: string;
      urlSlug: string;
      citySlug: string;
      timeZone: string;
      day: string;
      partySize: number;
      slots: ResySlot[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/resy/checkAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.resy.checkAvailability({ venueId: 8189, day: { $daysFromNow: 7 }, partySize: 2 });
  • confirmBookingFinishes the booking startBooking began in the same session: signs the diner in with the texted code (and the account email when Resy asks for it)…

    Arguments

    NameTypeRequired
    args{ code: string; email?: string }Yes

    Returns ResyBooking

    interface ResyBooking {
      venueId: number;
      venueName: string;
      startsAt: string;
      partySize: number;
      seatingType: string | null;
      reservationId: number | null;
      resyToken: string;            // cancelBooking takes it
      cancellationPolicy: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/resy/confirmBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.resy.confirmBooking({ code: "000000" });
  • confirmSignInAnswers the texted code (and the account email when Resy asks), signing the diner in for this session.

    Arguments

    NameTypeRequired
    args{ code: string; email?: string }Yes

    Returns ResySignedIn

    interface ResySignedIn {
      status: "signed_in";
      firstName: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/resy/confirmSignIn

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.resy.confirmSignIn({ code: "000000" });
  • listBookingsLists the signed-in diner's upcoming Resy reservations with the resyToken cancelBooking takes.

    Arguments

    None.

    Returns ResyUpcomingBooking[]

    interface ResyUpcomingBooking {
      reservationId: number | null;
      resyToken: string;            // cancelBooking takes it
      venueId: number | null;
      day: string | null;           // "YYYY-MM-DD"
      time: string | null;          // "HH:mm", local
      partySize: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/resy/listBookings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.resy.listBookings();
Act 3
  • cancelBookingCancels one of the diner's reservations by its resyToken, under the diner's sign-in in this session (the booking's own, or startSignIn +…

    Arguments

    NameTypeRequired
    args{ resyToken: string }Yes

    Returns ResyCancellation

    interface ResyCancellation {
      canceled: true;
      resyToken: string;
      refunded: boolean | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.resy.cancelBooking({});
  • startBookingStarts booking one open time for a diner with a Resy account: checks the time is open, reads the slot's terms and refuses any slot that charges or…

    Arguments

    NameTypeRequired
    venueIdnumber
    From a search row.
    Yes
    daystring
    "YYYY-MM-DD", the venue's calendar.
    Yes
    timestring
    "HH:mm", 24-hour local, the time part of a slots[].startsAt.
    Yes
    partySizenumberYes
    phonestring
    The diner's mobile, the one on their Resy account; Resy texts the code to it.
    Yes
    seatingTypestring
    E.g. "Dining Room" when the time has several; default the first.
    No

    Returns ResyBookingStarted

    interface ResyBookingStarted {
      status: "code_sent";
      venueId: number;
      venueName: string;
      startsAt: string;
      partySize: number;
      seatingType: string | null;
      codeSentTo: string;           // masked, e.g. "***-***-5219"
      cancellationPolicy: string[]; // Resy's own words
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/resy/startBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.resy.startBooking({
      venueId: 1,
      day: "<day>",
      time: "<time>",
      partySize: 1,
      phone: "<phone>"
    });
  • startSignInTexts the diner a Resy code to sign them back in to their own account in a later session.

    Arguments

    NameTypeRequired
    args{ phone: string }Yes

    Returns ResySignInStarted

    interface ResySignInStarted {
      status: "code_sent";
      codeSentTo: string;           // masked, e.g. "***-***-5219"
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/resy/startSignIn

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.resy.startSignIn({});

Use it from code