Resy Booker - MCP Server for AI Restaurant Reservations

Book Resy restaurants through AI assistants like Claude, ChatGPT, and OpenClaw.

No scraping. No data extraction. Just tell your AI agent where and when you want to eat.

Search 1,900+ cities, check real-time availability, book slots, view and cancel reservations. All as conversational tool calls within a single session.

Stateful MCP server running in Apify Standby mode. Authenticate once, session persists across tool calls with no cold starts.

MCP endpoint:

https://clearpath--resy-booker.apify.actor/mcp

 

Resy Suite ➤	Restaurant Scraper	Availability Checker	Booker (MCP)

Restaurant Bookers ➤	Resy (MCP)	OpenTable (MCP)

Tools

6 tools available to connected AI agents:

• search_restaurants

  • Find restaurants with available time slots in any city
  • Inputs:
    • city (string): City name (e.g. "New York", "London", "Athens")
    • cuisine (string, optional): Filter by cuisine type
    • query (string, optional): Restaurant name or keyword
    • date (string, optional): YYYY-MM-DD format (defaults to today)
    • party_size (number, optional): Number of guests (default 2)
    • limit (number, optional): Max restaurants (default 10, max 25)
    • sort (string, optional): "relevance", "rating", "slots", or "name"
  • Returns restaurants with slots. Each slot includes a config_token for booking.
  • ~$0.03 per call

• check_availability

  • Check available time slots for a specific restaurant
  • Inputs:
    • restaurant_url (string): Full Resy URL (e.g. https://resy.com/cities/new-york-ny/carbone)
    • date (string, optional): YYYY-MM-DD format (defaults to today)
    • party_size (number, optional): Number of guests (default 2)
  • ~$0.05 per call

• book_reservation

  • Book a time slot using a config_token from search or availability results
  • Creates a real reservation on your Resy account
  • Inputs:
    • config_token (string): Token from a slot in search/availability results
  • $3.99 per booking

• my_reservations

  • List your current Resy reservations
  • No inputs required
  • Free

• cancel_reservation

  • Cancel a reservation by its resy_token
  • Inputs:
    • resy_token (string): Token from my_reservations or book_reservation results
  • Free

• login

  • Authenticate with Resy credentials (auto-called with pre-configured credentials)
  • Inputs:
    • email (string): Resy account email
    • password (string): Resy account password
  • Free

Quick Start

Search for restaurants

{
    "city": "New York",
    "cuisine": "Italian",
    "date": "2026-03-15",
    "party_size": 4
}

Check a specific restaurant

{
    "restaurant_url": "https://resy.com/cities/new-york-ny/carbone",
    "date": "2026-03-15",
    "party_size": 2
}

Book a slot

{
    "config_token": "rgs://resy/12345/67890/1/2026-03-15/2026-03-15/19:30/2/Dining+Room"
}

How It Works

1. Agent connects to the MCP server endpoint
2. Auto-login with pre-configured Resy credentials (or call login manually)
3. Search for restaurants: search_restaurants(city="New York", cuisine="Italian")
4. Pick a slot from the results (each slot includes a config_token)
5. Book with book_reservation(config_token="rgs://resy/...")
6. Verify with my_reservations()

The agent handles the entire flow conversationally. Ask it "find me an Italian restaurant in NYC for 4 people next Friday" and it chains the right tool calls.

---

Pricing — Pay Per Event (PPE)

You only pay for searches and bookings. Login, viewing, and cancelling are free.

Action	Cost
Search restaurants	$0.03
Check availability	$0.05
Book a reservation	$3.99
Login, view, cancel	Free

---

Configuration

Input Parameters

Credentials are configured in the Apify actor input. Your password is stored encrypted using Apify's secret input handling and never logged or exposed in run output. The server auto-logs in on the first tool call.

Parameter	Type	Description
email	string	Your Resy account email
password	string (secret)	Your Resy account password

The login tool is also available for switching accounts or re-authenticating mid-session.

Replace YOUR_APIFY_TOKEN in all examples below with your Apify API token.

Usage with ChatGPT

ChatGPT supports MCP servers natively (Plus, Pro, Team, Enterprise plans).

1. Open Settings > Connectors > Add connector
2. Set Name to Reddit
3. Set MCP Server URL to:

https://clearpath--resy-booker.apify.actor/mcp

4. Set Authentication to API Key and set the header:
   • Header name: Authorization
   • Value: Bearer YOUR_APIFY_TOKEN
5. Click Save
6. Start a new chat, click + near the composer, select More, choose Reddit

Usage with Claude Desktop

Add to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "resy-booker": {
            "type": "http",
            "url": "https://clearpath--resy-booker.apify.actor/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_APIFY_TOKEN"
            }
        }
    }
}

Restart Claude Desktop after saving.

Usage with Claude Code

claude mcp add --transport http --scope user resy-booker \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN" \
  https://clearpath--resy-booker.apify.actor/mcp

Or add to your project's .mcp.json:

{
    "mcpServers": {
        "resy-booker": {
            "type": "http",
            "url": "https://clearpath--resy-booker.apify.actor/mcp",
            "headers": {
                "Authorization": "Bearer ${APIFY_TOKEN}"
            }
        }
    }
}

Usage with OpenClaw

Add to ~/.openclaw/openclaw.json:

{
  "provider": {
    "mcpServers": {
      "resy-booker": {
        "url": "https://clearpath--resy-booker.apify.actor/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_APIFY_TOKEN"
        }
      }
    }
  }
}

Then message your OpenClaw bot on Telegram, WhatsApp, or Discord:

"Find me a table for 2 in Athens this Saturday"

"What's available at Carbone in New York next Friday?"

"Book the 7:30 PM slot at that restaurant"

The assistant calls the Resy Booker, searches availability, and books the reservation for you.

Other MCP Clients

Any client supporting the Streamable HTTP transport works. Use the MCP endpoint URL with your Apify API token as a Bearer auth header.

---

Try It Out

Once connected, ask your AI assistant:

"Find me a table for 2 in Athens this Saturday"

"What's available at Carbone in New York next Friday?"

"Book the 7:30 PM slot at that restaurant"

---

FAQ

Do I need a Resy account? Yes. You need valid Resy credentials (email + password) configured in the actor input.

Can I use this without an AI assistant? Yes. Any MCP client works. You can also call tools programmatically via any MCP SDK.

What cities are supported? All 1,900+ cities on Resy, including New York, Los Angeles, London, Paris, Athens, Tokyo, and more.

Will it actually book a real reservation? Yes. book_reservation creates a real reservation on your Resy account. Cancel with cancel_reservation.

What happens if a slot is no longer available? The tool returns an error. Search again or try a different time.

How is this different from the Resy Scraper? The scraper extracts restaurant data in bulk. This MCP server is for interactive booking through an AI agent.

---

Support

• Email: max@mapa.slmail.me
• Bugs: Issues tab

Legal

This actor interacts with Resy on behalf of authenticated users. It performs the same actions a user would in the Resy app or website. Users are responsible for complying with Resy's terms of service.

---

Search, book, and manage Resy reservations through AI agents.