Resy API and MCP server Let your AI agent handle your Resy bookings.

ToolWhat it doesAccess

• search_venues Find Resy restaurants in a city by name, cuisine or neighborhood, with open times for a date and party size. read

  Returns restaurants in the order Resy shows them for the search, each with its venue_id, name, neighborhood, cuisine and the open times Resy shows for that date and party size. A restaurant with no open time is still listed, with an empty list, so you can set a Notify alert there. Some restaurants on Resy take bookings through Tock; those show no times here.

  MCP callresy_read → search_venues

  REST endpointGET https://cotlet.dev/api/v1/resy/venues/search

  Parameters

  Parameters: search_venues

  Name	Type	Description
  query string	string	Restaurant name, cuisine or neighborhood, for example "Italian" or "West Village".
  location string required	string	City as Resy lists it, for example "New York" or "Los Angeles".
  date string required	string	Date as YYYY-MM-DD.
  party_size integer required	integer	Number of guests.

  Example input

  {
    "location": "location",
    "date": "date",
    "party_size": 1
  }

  Example response

  {
    "date": "2026-10-30",
    "party_size": 4,
    "venues": [
      {
        "venue_id": "v_58231",
        "name": "Trattoria Esempio",
        "neighborhood": "West Village",
        "cuisine": "Italian",
        "times": [
          "19:00",
          "20:15"
        ]
      },
      {
        "venue_id": "v_61907",
        "name": "Osteria Campione",
        "neighborhood": "West Village",
        "cuisine": "Italian",
        "times": []
      }
    ]
  }

• get_venue Read one restaurant's Resy page: address, cuisine, price range, description and booking notes. read

  Returns what the restaurant shows on its Resy page: address, neighborhood, cuisine, price range, description and the notes it adds about booking. It changes nothing and reaches no one.

  MCP callresy_read → get_venue

  REST endpointGET https://cotlet.dev/api/v1/resy/venues/{venue_id}

  Parameters

  Parameters: get_venue

  Name	Type	Description
  venue_id string required	string	A venue_id from search_venues.

  Example input

  {
    "venue_id": "venue_8c41d2"
  }

  Example response

  {
    "venue_id": "v_58231",
    "name": "Trattoria Esempio",
    "address": "12 Example Street, New York, NY",
    "neighborhood": "West Village",
    "cuisine": "Italian",
    "price_range": "$$$",
    "notes": "Reservations open 14 days ahead."
  }

• get_availability List the bookable times at one restaurant for a date and party size, with each slot's table type and cancellation policy. read

  Returns each open slot with its slot_id, time, table type such as Dining Room or Bar, and the cancellation policy the restaurant set for it. Each call reads Resy once; the tool does not repeat itself to wait for a table, so for a full restaurant use add_notify. Slots change fast, so book soon after reading them.

  MCP callresy_read → get_availability

  REST endpointGET https://cotlet.dev/api/v1/resy/venues/{venue_id}/availability

  Parameters

  Parameters: get_availability

  Name	Type	Description
  venue_id string required	string	A venue_id from search_venues.
  date string required	string	Date as YYYY-MM-DD.
  party_size integer required	integer	Number of guests.

  Example input

  {
    "venue_id": "venue_8c41d2",
    "date": "date",
    "party_size": 1
  }

  Example response

  {
    "venue_id": "v_58231",
    "date": "2026-10-30",
    "party_size": 4,
    "slots": [
      {
        "slot_id": "sl_9f2c41",
        "time": "19:00",
        "table_type": "Dining Room",
        "cancellation_policy": "Cancel by 2 pm the day before or pay 25 USD per guest."
      },
      {
        "slot_id": "sl_9f2c58",
        "time": "20:15",
        "table_type": "Bar",
        "cancellation_policy": "Cancel by 2 pm the day before or pay 25 USD per guest."
      }
    ]
  }

ToolWhat it doesAccess

• list_reservations List your upcoming or past Resy reservations. read

  Returns the reservations from Reservations in your Resy profile, soonest first for upcoming ones, each with its reservation_id, restaurant, date, time and party size. Bookings made through Tock for a restaurant listed on Resy are not in your Resy account and do not show up.

  MCP callresy_read → list_reservations

  REST endpointGET https://cotlet.dev/api/v1/resy/reservations

  Parameters

  Parameters: list_reservations

  Name	Type	Description
  status string	string	upcoming or past. Defaults to upcoming.

  Example response

  {
    "reservations": [
      {
        "reservation_id": "r_70412",
        "venue": "Trattoria Esempio",
        "date": "2026-10-30",
        "time": "19:00",
        "party_size": 4
      },
      {
        "reservation_id": "r_70388",
        "venue": "Bistro Modello",
        "date": "2026-10-31",
        "time": "20:30",
        "party_size": 2
      },
      {
        "reservation_id": "r_70355",
        "venue": "Sushi Campione",
        "date": "2026-11-04",
        "time": "18:45",
        "party_size": 6
      }
    ]
  }

• get_reservation Read one reservation with its address, table type, special request and cancellation policy. read

  Returns what Manage Reservation shows: restaurant, address and phone, date, time, party size, table type, your special request and the cancellation policy with its deadline and fee per guest. The restaurant sets the policy, and Resy points questions about fees to the restaurant.

  MCP callresy_read → get_reservation

  REST endpointGET https://cotlet.dev/api/v1/resy/reservations/{reservation_id}

  Parameters

  Parameters: get_reservation

  Name	Type	Description
  reservation_id string required	string	A reservation_id from list_reservations.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "r_70412",
    "venue": "Trattoria Esempio",
    "address": "12 Example Street, New York, NY",
    "date": "2026-10-30",
    "time": "19:00",
    "party_size": 4,
    "table_type": "Dining Room",
    "special_request": "Birthday dinner",
    "cancellation_policy": {
      "deadline": "2026-10-29T14:00:00-04:00",
      "fee_per_guest": 25,
      "currency": "USD"
    }
  }

• book_reservation Book an open slot from get_availability for your Resy account. writeasks first

  Books the table under your name and returns the reservation_id; Resy then sends its usual confirmation email from noreply@resy.com. Restaurants with a cancellation fee need a card on file, and the slot's cancellation policy applies from the moment you book. A slot someone else took in the meantime fails the call without booking. By default you confirm each call; you can switch that off for this tool.

  MCP callresy_write → book_reservation

  REST endpointPOST https://cotlet.dev/api/v1/resy/slots/{slot_id}/reservations

  Parameters

  Parameters: book_reservation

  Name	Type	Description
  slot_id string required	string	A slot_id from get_availability.
  special_request string	string	A note for the restaurant, for example "Birthday dinner".

  Example input

  {
    "slot_id": "slot_8c41d2"
  }

  Example response

  {
    "reservation_id": "r_70412",
    "status": "confirmed",
    "venue": "Trattoria Esempio",
    "date": "2026-10-30",
    "time": "19:00",
    "party_size": 4
  }

• change_reservation Move a reservation to another open slot at the same restaurant: date, time or party size. writeasks first

  Does what Change Reservation does in Resy and returns the reservation as it is after the change. The new slot's cancellation policy replaces the old one. If the new slot is gone, the call fails and the old reservation stays. By default you confirm each call; you can switch that off for this tool.

  MCP callresy_write → change_reservation

  REST endpointPATCH https://cotlet.dev/api/v1/resy/slots/{slot_id}/reservations/{reservation_id}

  Parameters

  Parameters: change_reservation

  Name	Type	Description
  reservation_id string required	string	A reservation_id from list_reservations.
  slot_id string required	string	The new slot_id from get_availability for the new date, time or party size.

  Example input

  {
    "reservation_id": "reservation_8c41d2",
    "slot_id": "slot_8c41d2"
  }

  Example response

  {
    "reservation_id": "r_70388",
    "status": "confirmed",
    "venue": "Bistro Modello",
    "date": "2026-10-31",
    "time": "21:30",
    "party_size": 2
  }

• cancel_reservation Cancel one of your reservations, showing any cancellation fee first. writeasks first

  Cancels the booking the way Cancel does in Manage Reservation. When you cancel after the restaurant's deadline, its policy can charge a fee per guest, and the approval shows that fee before you confirm. A cancelled reservation cannot be restored; the table goes back to other diners. By default you confirm each call; you can switch that off for this tool.

  MCP callresy_write → cancel_reservation

  REST endpointPOST https://cotlet.dev/api/v1/resy/reservations/{reservation_id}/cancel

  Parameters

  Parameters: cancel_reservation

  Name	Type	Description
  reservation_id string required	string	A reservation_id from list_reservations.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "r_70355",
    "status": "cancelled",
    "venue": "Sushi Campione",
    "fee_charged": false
  }

ToolWhat it doesAccess

• list_notify List your active Notify alerts: restaurant, date, time range and party size. read

  Returns the Notify requests Resy shows next to your reservations, each with its notify_id. A Notify alert is not a reservation: Resy sends a push or email when a matching table opens, and the table still has to be booked.

  MCP callresy_read → list_notify

  REST endpointGET https://cotlet.dev/api/v1/resy/notifies

  Parameters

  No parameters.

  Example response

  {
    "notify": [
      {
        "notify_id": "n_3301",
        "venue": "Torrisi",
        "date": "2026-10-30",
        "time_from": "19:00",
        "time_to": "21:00",
        "party_size": 2
      },
      {
        "notify_id": "n_3297",
        "venue": "Torrisi",
        "date": "2026-10-24",
        "time_from": "19:00",
        "time_to": "21:00",
        "party_size": 2
      }
    ]
  }

• add_notify Join a restaurant's Notify list for a date, time range and party size. write

  Sets the same alert as the Notify button in Resy and returns its notify_id. Resy, not the agent, watches for an opening and alerts you by push or email; it books nothing. Eligible American Express Card Members with Global Dining Access get Priority Notify and are alerted first. The alert reaches no one and remove_notify undoes it, so it runs without asking you.

  MCP callresy_write → add_notify

  REST endpointPOST https://cotlet.dev/api/v1/resy/venues/{venue_id}/notifies

  Parameters

  Parameters: add_notify

  Name	Type	Description
  venue_id string required	string	A venue_id from search_venues.
  date string required	string	Date as YYYY-MM-DD.
  time_from string required	string	Start of the time range, HH:MM.
  time_to string required	string	End of the time range, HH:MM.
  party_size integer required	integer	Number of guests.

  Example input

  {
    "venue_id": "v_44102",
    "date": "2026-10-30",
    "time_from": "19:00",
    "time_to": "21:00",
    "party_size": 2
  }

  Example response

  {
    "notify_id": "n_3301",
    "venue": "Torrisi",
    "date": "2026-10-30",
    "time_from": "19:00",
    "time_to": "21:00",
    "party_size": 2
  }

• remove_notify Take yourself off a restaurant's Notify list. write

  Removes one Notify request and returns it as removed. It touches only your own alert and add_notify sets it again, so it runs without asking you. Your reservations stay as they are.

  MCP callresy_write → remove_notify

  REST endpointDELETE https://cotlet.dev/api/v1/resy/notifies/{notify_id}

  Parameters

  Parameters: remove_notify

  Name	Type	Description
  notify_id string required	string	A notify_id from list_notify.

  Example input

  {
    "notify_id": "notify_8c41d2"
  }

  Example response

  {
    "notify_id": "n_3297",
    "status": "removed"
  }