Connect AI agents to the Fever MCP server

Vendor MCP

The Fever MCP connector routes your AI agent's tool calls to Fever's own MCP server through Scalekit. Each user signs in to Fever once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 5 tools.

Tools: 5
What they doRead · write · destructive: 5 · 0 · 05 read0 write0 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
Set your credentials
Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```
Create the Fever MCP connection
In AgentKit > Connections, create a Fever MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for Fever MCP server, so you don't need to register an OAuth app.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'fevermcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize Fever MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'fevermcp_search_cinema_showtimes',
27
  toolInput: {},
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "fevermcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Fever MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="fevermcp_search_cinema_showtimes",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

fevermcp_search_cinema_showtimesFind what is showing at US cinemas, by cinema name or chain or by proximity.Read-only
Search Cinema Showtimes
Find what is showing at US cinemas, by cinema name or chain or by proximity. Use it when the user asks what is on at a specific cinema, or for cinemas near them. Returns cinemas, each with the movies it shows (most showtimes first) and their earliest showtimes in the requested window: screen format, ticket prices with Fever's booking fee, a sold-out flag, and a link to choose seats and buy on Fever. A cinema matching the name or id is returned when it has showtimes in the next 14 days, even if none fall in the requested window; no result means no showtimes in the next 14 days. Share links exactly as returned, query parameters included.
Inputs
cinema_idstring
Exact Fever cinema id from an earlier result. Overrides query; location becomes optional.
city_codestring
3-letter Fever city code (e.g. NYC, LAX, CHI), used when there are no coordinates: the search point becomes the city centre.
end_datetimestring
Latest showtime start, ISO 8601, at most 7 days after start_datetime. Without an offset it is the cinema's local time. Defaults to the end of start_datetime's local day.
latitudestring
Latitude of the search point (-90 to 90). Must be provided together with longitude. Required unless city_code or cinema_id is given. Example: 40.758 for Times Square
localestring
Language code of titles and links (e.g. en, es) - same values as other toolsdefault en
longitudestring
Longitude of the search point (-180 to 180). Must be provided together with latitude. Example: -73.9855 for Times Square
max_cinemasinteger
Maximum cinemas to return, 1 to 20 (default 5): best name match, else nearest firstdefault 5
max_movies_per_cinemainteger
Maximum movies per cinema, most showtimes first, 1 to 30 (default 10)default 10
max_showtimes_per_movieinteger
Maximum showtimes per movie, earliest first, 1 to 50 (default 10)default 10
querystring
Cinema name or chain, e.g. 'AMC Empire 25' or 'Regal'. '' for every cinema nearby.default
radiusinteger
Search radius in metres, 1000 to 80000 (default 16000, about 10 miles)default 16000
start_datetimestring
Earliest showtime start, ISO 8601. Without an offset it is the cinema's local time. Defaults to now. Example: '2026-10-24T19:00:00'
fevermcp_search_citiesFind cities where Fever operates and offers events/activities.Read-only
Search Cities
Find cities where Fever operates and offers events/activities. Perfect for location discovery and travel planning.
Inputs
localestringrequired
Language code (en, es, fr, de, pt, it, ar, bg, ca, cs, da, el, et, fi, he, hr, hu, id, ja, ko, lt, lv, nl, pl, ro, sk, sl, sv, th, tr, zh) - affects localization
querystringrequired
City name or search term (use '' for all cities)
city_codestring
Optional 3-letter city code (e.g., MAD, NYC, LON, BCN)
only_suggestedboolean
True returns only top/popular citiesdefault false
fevermcp_search_eventsFind events, activities, and experiences available in a specific city through Fever.Read-only
Search Events
Find events, activities, and experiences available in a specific city through Fever. Perfect for event discovery and travel planning. When the user mentions a time frame (e.g. 'this weekend', 'next Friday', 'in April'), set start_datetime and end_datetime to filter results.
Inputs
city_codestring
3-letter city code (e.g., MAD, NYC, LON, BCN). Required if coordinates not provided. Ignored when coordinates are provided. Use search_cities tool to find valid city codes.
end_datetimestring
End datetime in ISO 8601 format (UTC) to filter events starting at or before this time. Example: '2025-10-17T23:59:59Z'
include_descriptionboolean
If True, includes full plan descriptions in the response. Useful for understanding event details and features. Defaults to False.default false
latitudestring
Latitude for coordinate search (-90 to 90). When provided with longitude, city_code is ignored. Must be used with longitude. Example: 40.4168 for Madrid, 48.8566 for Paris
localestring
Language code (en, es, fr, de, pt, it, ar, bg, ca, cs, da, el, et, fi, he, hr, hu, id, ja, ko, lt, lv, nl, pl, ro, sk, sl, sv, th, tr, zh) - affects content languagedefault en
longitudestring
Longitude for coordinate search (-180 to 180). When provided with latitude, city_code is ignored. Must be used with latitude. Example: -3.7038 for Madrid, 2.3522 for Paris
pageinteger
Page number starting from 0 for paginationdefault 0
page_sizeinteger
Results per page (default 12, max 100). Prefer 6 or 12: the card grid reflows to the surface width, and those divide evenly across the column counts it produces.default 12
querystring
Search term for specific events (optional, '' for all)default
radiusstring
Search radius in meters when using coordinates. Only works with latitude/longitude. Example: 5000 for 5km, 10000 for 10km
sort_bystring
Sort order: 'popularity' (default) 'price', 'rating', 'closest_session', 'distance' (requires coordinates), or 'random'default popularity
start_datetimestring
Start datetime in ISO 8601 format (UTC) to filter events starting at or after this time. Example: '2025-10-17T19:00:00Z'
venue_idstring
Only return events held at this venue. Use search_venues to resolve a venue name into a venue_id, and pass that venue's city_code alongside it.
fevermcp_search_movie_showtimesFind where and when a movie is showing in US cinemas near a location.Read-only
Search Movie Showtimes
Find where and when a movie is showing in US cinemas near a location. Use it when the user asks where or when to watch a film, or which movies are playing nearby. Returns movies, each with the nearest cinemas showing it and their earliest showtimes in the requested window: screen format (IMAX, Dolby Cinema, 3D...), ticket prices with Fever's booking fee, a sold-out flag, and a link to choose seats and buy on Fever. Share links exactly as returned, query parameters included.
Inputs
city_codestring
3-letter Fever city code (e.g. NYC, LAX, CHI), used when there are no coordinates: the search point becomes the city centre.
end_datetimestring
Latest showtime start, ISO 8601, at most 7 days after start_datetime. Without an offset it is the cinema's local time. Defaults to the end of start_datetime's local day.
latitudestring
Latitude of the search point (-90 to 90). Must be provided together with longitude. Required unless city_code is given. Example: 40.758 for Times Square
localestring
Language code of titles and links (e.g. en, es) - same values as other toolsdefault en
longitudestring
Longitude of the search point (-180 to 180). Must be provided together with latitude. Example: -73.9855 for Times Square
max_cinemas_per_movieinteger
Maximum cinemas per movie, nearest first, 1 to 20 (default 5)default 5
max_moviesinteger
Maximum movies to return, 1 to 10 (default 5)default 5
max_showtimes_per_cinemainteger
Maximum showtimes per cinema, earliest first, 1 to 50 (default 20)default 20
movie_idstring
Exact Fever movie id from an earlier result. Overrides query.
querystring
Movie title or part of it, typo-tolerant. '' returns the movies with most showtimes nearby.default
radiusinteger
Search radius in metres, 1000 to 80000 (default 16000, about 10 miles)default 16000
start_datetimestring
Earliest showtime start, ISO 8601. Without an offset it is the cinema's local time. Defaults to now. Example: '2026-12-18T18:00:00'
fevermcp_search_venuesFind venues where Fever runs events - theatres, museums, concert halls, landmarks.Read-only
Search Venues
Find venues where Fever runs events - theatres, museums, concert halls, landmarks. Use for venue-first discovery like 'what is on at the WiZink Center' or 'venues near me', AND for questions about a specific venue itself: whether it has a page on Fever, its address, coordinates, or the link to its Fever page (venue_page_url). Do not use search_events with a venue name as the query for these -- it searches event titles and descriptions, not venues, and will return unrelated results in the same area.
Inputs
country_codestring
Optional ISO 3166-1 alpha-2 country filter, two letters (e.g., ES, US)
latitudestring
Latitude for geolocation search (-90 to 90). Must be provided together with longitude. Example: 40.4168 for Madrid
limitinteger
Maximum venues to return (default 10, max 50)default 10
localestring
Language code (en, es, fr, de, pt, it, ar, bg, ca, cs, da, el, et, fi, he, hr, hu, id, ja, ko, lt, lv, nl, pl, ro, sk, sl, sv, th, tr, zh) - affects content languagedefault en
longitudestring
Longitude for geolocation search (-180 to 180). Must be provided together with latitude. Example: -3.7038 for Madrid
querystring
Venue name or search term (use '' for all venues)default
radiusstring
Search radius in meters. Requires latitude and longitude. Example: 5000 for 5km

Setup

Install the SDK

Set your credentials

Create the Fever MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Search Cinema Showtimes

Inputs

Search Cities

Inputs

Search Events

Inputs

Search Movie Showtimes

Inputs

Search Venues

Inputs

Related: other Search connectors