Crawlora MCP

fever_plans

Read-only

List one page of Fever's local-experience and event catalogue for a city, optionally filtered by Fever's own category id and by a session-date window and ordered by one of Fever's sort values. Returns each plan's id, name, city, timezone, rating, advertised from-price, venue name, next session times and canonical page URL, plus the search index's match count and whether a further page exists. Pass a city_code from fever_top_cities or fever_cities and take whatplanfilter_id from fever_filters; page_size defaults to 20 and is capped at 100, and date_start/date_end are epoch SECONDS with date_start required whenever a window is given. Use fever_plan for one plan's full detail. count is the search index's own total and is not the website's total_plans, and larger pages can include plans from nearby cities, so compare each plan's own city_code with requested_city_code.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "city_code": "<city_code>"
    },
    "name": "fever_plans"
  }
}

Input Schema

Name	Required	Description
`page`	No	1-based page number, default 1. A page just past the end is an honest empty plans array with count unchanged; a very large page number makes the upstream answer 500, which this API reports as an upstream error.
`query`	No	Optional free-text query. Empty means no keyword filter.
`locale`	No	Optional response language for the search index, e.g. en or es. Defaults to en.
`date_end`	No	Optional latest session date as epoch SECONDS. Only valid together with date_start.
`latitude`	No	Optional latitude of the search centre. Supply it together with longitude. Defaults to the centre of city_code when that city is in fever_top_cities; a city outside that list needs an explicit pair.
`city_code`	Yes	Required Fever city code, e.g. NYC or LON. Take it from fever_top_cities or fever_cities. It is the search origin, not a hard filter: an unknown code is not rejected upstream, so a wrong code returns another city's plans.
`longitude`	No	Optional longitude of the search centre. Supply it together with latitude.
`page_size`	No	Plans per page, default 20, maximum 100. Values above 100 are rejected because the upstream silently caps them at 100.
`sort_type`	No	Optional result ordering, one of: popularity, price, rating, closest_session, distance, random, id. Omit for the upstream default. distance also requires a geolocation (always sent here).
`date_start`	No	Optional earliest session date as epoch SECONDS (not milliseconds). Required whenever date_end is set. Milliseconds silently select an empty window.
`whatplanfilter_id`	No	Optional Fever category id, taken from fever_filters (cities differ). Example: 1040 is Music Events in NYC.