Search movies
search_moviesSearch TMDB movies by title to get compact summaries, TMDB IDs for other movie tools, and pagination info. Filter by year, exact release year, language, and adult results.
Instructions
Search TMDB movies by title; returns compact summaries with the TMDB id that the other movie tools (get_movie, get_movie_credits, …) require, plus pagination info. Use this over search_multi when you already know the result is a movie. year/release_date are the original (primary) release, as everywhere except get_movie_releases, which shows the chosen country's 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": {
"query": "<query>"
},
"name": "search_movies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number for pagination (TMDB returns up to 20 results per page, max 500). | |
| year | No | Bias results toward this release year. Soft by default: it matches any of a movie's release dates, so re-releases and older films still appear (checked live: 'alien' with year 2003 ranks the 1979 Alien first). Set exact_year to match only the original release year. | |
| query | Yes | Movie title to search for. | |
| 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 |
| exact_year | No | Match `year` against the original (primary) release year only, dropping movies first released in another year. Requires `year`. | |
| include_adult | No | Include adult (NSFW) results. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| results | Yes | ||
| total_pages | Yes | ||
| total_results | Yes |