Get compact movie card(s)
get_moviesFetch compact cards for 1–20 movies by TMDB ID in one call, including title, year, genres, vote average, and optional ratings. Use it when you need headline info only; request full details separately.
Instructions
Get a compact card (title, year, genres, vote average, and opt-in ratings) for 1-20 movies by TMDB id in one call. Trimmed: no overview, cast, budget, certifications, production companies, etc. Use it for a single id too when you only need that headline info, not just for checking many at once. Call get_movie instead for the full details of a title (including region-specific certification). An id that fails to load (unknown, or hit by an upstream error such as a rate limit) never fails the whole call: that entry comes back {id, found:false, reason} instead, in the same order as ids; read reason before concluding the id doesn't exist.
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": {
"ids": "<ids>"
},
"name": "get_movies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | TMDB movie ids to fetch (1-20). Get them from search_movies/discover_movies/get_similar/get_movie_recommendations/etc. | |
| 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 |
| include_ratings | No | Add compact IMDb/Rotten Tomatoes/Metacritic ratings from OMDb to every card (requires OMDB_API_KEY). Costs one extra OMDb lookup per id, so a large batch means a burst of OMDb calls; mind OMDb's own rate limit. Off by default here, unlike get_movie/get_tv. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | Yes |