Get compact TV show card(s)
get_tv_showsFetch compact summary cards for 1-20 TV shows by TMDB id in one call, showing year, genres, vote average and season/episode counts to quickly compare candidates and spot miniseries without per-title lookups.
Instructions
Get a compact card (name, year, genres, vote average, season/episode counts, and opt-in ratings) for 1-20 TV shows by TMDB id in one call. A quick way to spot short/miniseries shows (low episode count) across many candidates without a per-title get_tv call. Otherwise trimmed: no overview, episode list, networks, certifications, etc. Use it for a single id too when you only need that headline info, not just for checking many at once. Call get_tv 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_tv_shows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | TMDB TV show ids to fetch (1-20). Get them from search_tv/discover_tv/get_similar/get_tv_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 |