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.
- Site
- resy.com
- Functions
- 8
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/resyOne MCP server for Resy 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
Open a function to see its arguments, what it returns and how to call it.
checkAvailabilityReads real-time open reservation slots for one venue, one date and a party size.Arguments
Name Type Required args{ venueId: number; day: string; partySize?: number }Yes Returns
ResyAvailabilityinterface 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/checkAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.resy.checkAvailability({ venueId: 8189, day: { $daysFromNow: 7 }, partySize: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.resy.checkAvailability({ "venueId": 8189, "day": {"$daysFromNow": 7}, "partySize": 2 }))curl -X POST https://api.bowmark.ai/v1/sites/resy/checkAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"venueId":8189,"day":{"$daysFromNow":7},"partySize":2}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ code: string; email?: string }Yes Returns
ResyBookinginterface 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/confirmBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.resy.confirmBooking({ code: "000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.resy.confirmBooking({"code": "000000"}))curl -X POST https://api.bowmark.ai/v1/sites/resy/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.resy.confirmBooking({ code: "000000" });confirmSignInAnswers the texted code (and the account email when Resy asks), signing the diner in for this session.Arguments
Name Type Required args{ code: string; email?: string }Yes Returns
ResySignedIninterface ResySignedIn { status: "signed_in"; firstName: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/resy/confirmSignInCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.resy.confirmSignIn({ code: "000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.resy.confirmSignIn({"code": "000000"}))curl -X POST https://api.bowmark.ai/v1/sites/resy/confirmSignIn \ -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.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/listBookingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.resy.listBookings();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.resy.listBookings())curl -X POST https://api.bowmark.ai/v1/sites/resy/listBookings \ -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.resy.listBookings();searchFinds Resy venues matching a restaurant name, ranked by Resy's own relevance and optionally biased by caller-supplied coordinates.Arguments
Name Type Required querystring | { query: string; latitude?: number; longitude?: number }Yes Returns
ResyVenueRow[]interface ResyVenueRow { venueId: number; name: string; urlSlug: string; citySlug: string; locality: string; region: string; country: string; cuisine: string[]; priceRangeId: number | null; rating: { average: number; count: number } | null; maxPartySize: number | null; distanceKm: number | null; // from { latitude, longitude } when passed, else null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/resy/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.resy.search("Paco Meralgo");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.resy.search("Paco Meralgo"))curl -X POST https://api.bowmark.ai/v1/sites/resy/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"Paco Meralgo"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.resy.search("Paco Meralgo");
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
Name Type Required args{ resyToken: string }Yes Returns
ResyCancellationinterface ResyCancellation { canceled: true; resyToken: string; refunded: boolean | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/resy/cancelBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.resy.cancelBooking({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.resy.cancelBooking({}))curl -X POST https://api.bowmark.ai/v1/sites/resy/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.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
Name Type Required venueIdnumberFrom 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 phonestringThe diner's mobile, the one on their Resy account; Resy texts the code to it.Yes seatingTypestringE.g. "Dining Room" when the time has several; default the first.No Returns
ResyBookingStartedinterface 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/startBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.resy.startBooking({ venueId: 1, day: "<day>", time: "<time>", partySize: 1, phone: "<phone>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.resy.startBooking({ "venueId": 1, "day": "<day>", "time": "<time>", "partySize": 1, "phone": "<phone>" }))curl -X POST https://api.bowmark.ai/v1/sites/resy/startBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"venueId":1,"day":"<day>","time":"<time>","partySize":1,"phone":"<phone>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ phone: string }Yes Returns
ResySignInStartedinterface ResySignInStarted { status: "code_sent"; codeSentTo: string; // masked, e.g. "***-***-5219" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/resy/startSignInCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.resy.startSignIn({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.resy.startSignIn({}))curl -X POST https://api.bowmark.ai/v1/sites/resy/startSignIn \ -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.resy.startSignIn({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/resy/<function> - OpenAPI
/v1/sites/resy/openapi.json