Get movies in or coming to cinemas
get_movie_releasesList movies in cinemas now or opening soon by country to check what's playing in theaters or what releases next.
Instructions
List movies in cinemas now (list='now_playing') or opening soon (list='upcoming') in one country, for 'what's playing in theaters' or 'what comes out next month'. Use get_trending for overall popularity regardless of release, discover_movies for an arbitrary date range. region filters to movies with a theatrical release in that country inside the window (a different set per country, not just a re-sort; an unrecognized code such as 'ZZ' returns an empty page, but 'XX' is a real TMDB pseudo-region). Each row's release_date is that country's release date, which can predate the window for a re-release (e.g. a 2014 film re-released this month). The window comes from TMDB and is returned as dates {minimum, maximum} (YYYY-MM-DD; same for every region; roughly the last six weeks for now_playing, the next three weeks for upcoming). TMDB's own order: roughly most popular first, not by date.
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": {
"list": "<list>"
},
"name": "get_movie_releases"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list | Yes | 'now_playing' = in cinemas now; 'upcoming' = opening soon. | |
| page | No | 1-based page number for pagination (TMDB returns up to 20 results per page, max 500). Adult/softcore titles are dropped from this list, so a page can come back shorter, even empty, while total_pages/total_results stay TMDB's own; keep paging up to total_pages. | |
| region | No | The user's country (pass it when known), whose cinemas to list. | US |
| language | No | Response language (ISO-639-1, optionally with a region), e.g. 'ru-RU' or 'en-US'; pass the user's language when it isn't the default. Localizes titles/overviews/genre names. A well-formed code TMDB has no translation for (e.g. 'xx') is not an error: overviews come back null, movies/shows keep their original-language title, and episodes get a generic 'Episode N' name. | en-US |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| dates | Yes | ||
| results | Yes | ||
| total_pages | Yes | ||
| total_results | Yes |