Skip to content
Crowdly

MCP server + API

Give your agent New York's hardest tables

Ask your agent where to eat and get the right answer: the restaurants people are actually fighting for, what's hot or just opened, near you and right for your diet, each with the next open table and a link to book. Built on Crowdly's own tracking of real reservation demand.

Works with Claude, ChatGPT, Cursor, Instinct and any agent that speaks MCP or HTTP.

Connect in one minute

Create a key above, then pick your agent. The key goes in the Authorization header, or in the URL for apps that only take a URL.

Any MCP client (URL only)

Claude, ChatGPT connectors, Instinct and other apps that ask for a server URL

https://crowdly.tech/api/mcp?key=YOUR_KEY

Claude Code

claude mcp add --transport http crowdly https://crowdly.tech/api/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor, Windsurf, Claude Desktop (mcp.json)

{
  "mcpServers": {
    "crowdly": {
      "url": "https://crowdly.tech/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

ChatGPT actions, LangChain, any OpenAPI agent

Import the spec, auth = API key, Bearer

https://crowdly.tech/api/v1/openapi.json

Paste into any personal agent

For agents that just read instructions and call URLs

When I ask where to eat in New York, call:
GET https://crowdly.tech/api/v1/recommend?key=YOUR_KEY&near=<my neighborhood>&when=<tonight|tomorrow|this_week|YYYY-MM-DD>&party=<1-4>&diet=<no_pork,vegetarian,...>
Show me the top 3 with why, the next table and the booking_url. Data is from Crowdly's latest check: remind me to confirm on the booking page.

curl

curl "https://crowdly.tech/api/v1/recommend?near=West%20Village&when=tonight&party=2" \
  -H "Authorization: Bearer YOUR_KEY"

Pricing

Crowdly Premium

$4.50/month

1,000 API calls a month, plus the Crowdly Index and unlimited searches, alerts and lists in the app. $45/year also works.

Pay as you go

  • $5 for 500 calls ($0.01 a call)
  • $20 for 2,500 calls ($0.008 a call)

No subscription. Calls never expire. Every account starts with 10 free calls to test.

One call = one tool call or request. Only successful calls count; errors are free. 60 calls a minute per key. The account tool is always free.

Tools

The same tools over MCP (https://crowdly.tech/api/mcp) and REST (GET with query params or POST JSON). OpenAPI spec.

recommend · GET /api/v1/recommend

The best restaurants in New York the user can actually get into: ranked by real demand (how booked out, how many tables taken in the last 24h, new openings), distance and diet fit, each with its next open table and a booking link. Use this first when someone asks where to eat.

  • near: Where the user is: a neighborhood ("West Village", "Williamsburg", "LES") or "lat,lng".
  • when: tonight, tomorrow, this_week, any (next 30 days), or a date YYYY-MM-DD. Default any.
  • after: Earliest seating, 24h or 12h, e.g. "19:00" or "7pm" (Eastern time).
  • before: Latest seating, 24h or 12h, e.g. "19:00" or "7pm" (Eastern time).
  • party: Number of people (1 to 4). Tables are tracked for 2 and 4.
  • diet: Diet needs. vegan, kosher and halal only return places that state it; no_pork, vegetarian and gluten_free rank by menu evidence.
  • cuisine: Cuisine to match, e.g. "italian", "japanese".
  • price_max: Max price level, 1 ($) to 4 ($$$$).
  • vibe: hot: most booked right now. hard_to_book: booked out most nights. new: opened in the last 6 months. climbing: getting harder to book this week.
  • max_km: Max distance in km when near is given. Default 3.
  • limit

find_tables · GET /api/v1/tables

Restaurants with an open table on a given date, hardest to book first, with seating times (next 7 days) and booking links. Filter by time, part of the city, price and cuisine.

  • date: YYYY-MM-DD, today through the next 30 days. Default today (Eastern time).
  • party: Number of people (1 to 4). Tables are tracked for 2 and 4.
  • after: Earliest seating, 24h or 12h, e.g. "19:00" or "7pm" (Eastern time).
  • before: Latest seating, 24h or 12h, e.g. "19:00" or "7pm" (Eastern time).
  • area: Part of the city.
  • price_max
  • cuisine
  • limit

get_restaurant · GET /api/v1/restaurants/{restaurant}

One restaurant by name or slug: how hard it is to book, its next open table for 2 and for 4, when it releases new dates, how long cancellations last, press, the team behind it, diet evidence from its menu, website, map and booking links.

  • restaurant: Name or slug, e.g. "Don Angie" or "don-angie".

crowdly_index · GET /api/v1/crowdly-index

Crowdly's rankings: index (the Crowdly 100, the hardest restaurants to book in New York, re-ranked every Monday, no tasting menus), climbing (getting harder to book this week), hot (most tables taken in the last 24h), new (opened in the last 6 months). Each with its next open table.

  • list
  • area: Part of the city.
  • price_max
  • party
  • limit

rare_openings · GET /api/v1/openings

Tables open right now at restaurants that are booked out most nights (70%+): the cancellations worth grabbing. Gone fast; confirm on the booking page.

upcoming_drops · GET /api/v1/drops

The next moments hard-to-book restaurants release new dates (Eastern time), which date opens, and the booking link to be ready on. Useful to set a reminder for the user.

  • limit

account · GET /api/v1/account

Free. How many API calls this key has left (Premium plan, prepaid calls, free trial calls) and where to buy more.

Free endpoints (no key)

Release timing and cancellation odds for booking agents, open CORS, cached 10 minutes.

  • GET /api/v1/preflight/{slug}?date=YYYY-MM-DD&party=2: the exact moment that date's tables open, fees to get approved, sell-out speed and a checklist. Without a slug, every tracked restaurant.
  • GET /api/v1/predict/{slug}?date=YYYY-MM-DD&party=2&from=19:00&to=21:30: cancellation odds for a time window, with sample sizes.

Good to know

  • Crowdly never books for anyone. Agents hand the user a booking link; the reservation is made on Resy with the user's own account.
  • Tables come from Crowdly's latest check, not live. Confirm on the booking page before promising a table.
  • Diet answers are only as good as the restaurant's own menu: vegan, kosher and halal are only returned when the restaurant states it.