Integrate Fever's global event catalog into your applications and AI assistants.
Connect Claude, Cursor, or any MCP-compatible client directly to Fever's event catalog. Search cities, discover events, no extra setup required.
1. Configure your MCP client
Add the Fever MCP server to your client configuration. For Claude Desktop, add the following to your claude_desktop_config.json:
{
"mcpServers": {
"fever": {
"url": "https://data-search.apigw.feverup.com/mcp/"
}
}
}2. Authenticate via OAuth 2.0
On first use, your MCP client will open a browser window to log in. After that, everything is handled automatically.
3. Start using it
Ask your AI assistant to search for cities or events on Fever and it will use the MCP tools automatically.
Search for events, activities, and experiences available in a specific city through Fever. Filter by date range, sort by popularity or price, and paginate through results.
Ideal for building event discovery features, recommendation engines, or letting AI assistants help users find things to do.
| Parameter | Type | Required | Description |
|---|---|---|---|
city_code | string | null | Required if no coordinates | 3-letter city code (e.g. MAD, NYC). Can be obtained via search_cities. Ignored when latitude/longitude are provided |
latitude | number | null | Required if no city_code | Latitude (-90 to 90). Must be used together with longitude. When provided, city_code is ignored. Example: 40.4168 for Madrid |
longitude | number | null | Required if no city_code | Longitude (-180 to 180). Must be used together with latitude. Example: -3.7038 for Madrid |
radius | integer | null | Optional | Search radius in meters. Only works with coordinates. Example: 5000 for 5 km. Default: no limit |
query | string | Optional | Search term for specific events (default: "" for all) |
sort_by | enum | Optional | popularity (default), price, rating, closest_session, distance (requires coordinates) |
locale | string | Optional | Language code affecting content language (e.g. en, es). Default: en |
page | integer | Optional | Page number starting from 0 (default: 0) |
page_size | integer | Optional | Results per page, max 1000 (default: 15) |
start_datetime | string | null | Optional | ISO 8601 datetime (any timezone offset). Only sessions starting at or after this time are returned. Example: 2025-10-17T19:00:00Z |
end_datetime | string | null | Optional | ISO 8601 datetime (any timezone offset). Only sessions starting at or before this time are returned. Example: 2025-10-17T23:59:59Z |
include_description | boolean | Optional | If true, includes keywords and description per event. Useful for discovering event features and typology (default: false) |
id, name — Event identifier and titlerating — Formatted string, e.g. "4.8/5 (1250 reviews)"price — Formatted string, e.g. "From 25.00 EUR" or "Free"location — Venue and city, e.g. "Teatro Real, Madrid"availability — Sessions within the requested interval as a formatted string (or next upcoming sessions if no date filter is applied)url — Direct link to the event on Feverkeywords, description — Only included if include_description=truecount, next, previous — Pagination infoFind cities where Fever operates and offers events/activities. Useful for discovering available markets, looking up city codes for use with search_events, or browsing Fever's global presence.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Required | City name or search term. Use '' for all cities |
locale | string | Required | Language code affecting localization (e.g. en, es) |
city_code | string | null | Optional | 3-letter city code (e.g. MAD, NYC, LON, BCN) |
only_suggested | boolean | Optional | If true, returns only top/popular cities (default: false) |
extra_metadata | boolean | Optional | If true, includes additional fields: hidden and location_id (default: false) |
city_id, city_code — Unique ID and 3-letter code (e.g. MAD, NYC)city_name — Localized city namelocation — Full location string, e.g. "Madrid, Spain"is_top_city — Whether the city is a major market with high inventoryhas_results — Whether there are actual search results (vs static suggestions)Getting Started
Usage
search_cities to find cities where Fever operates, and search_events to discover events, activities, and experiences in those cities. You can search by keyword, location, coordinates, date range, and more.
Support