Get TV season
get_tv_seasonFetch one TV season by show ID and season number to get its overview and episode list with air dates, runtimes, and TMDB vote averages; caps at 50 episodes and reports the total count.
Instructions
Get one season of a TV show (by show id + season number): overview and the episode list with air dates, runtimes and TMDB vote averages, capped at 50 episodes (episode_count reports the true total). Per-episode vote_average is TMDB's own 0-10 user score, not the IMDb/RT/Metacritic scores get_movie/get_tv return as ratings, which are whole-show only; this tool makes no OMDb call, and TMDB's season payload carries no per-episode IMDb ids either, so call get_tv_episode when you need one episode's imdb_id for get_ratings. Season 0 is usually specials, which can run to hundreds of bonus clips on a long-running show. Use get_tv with expand_episodes=true instead if you need every season's episodes in one call. Get the show id from search_tv.
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": {
"id": "<id>",
"season_number": "<season_number>"
},
"name": "get_tv_season"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | TMDB TV show id (from search_tv). | |
| season_number | Yes | Season number (0 = specials). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| air_date | Yes | ||
| episodes | Yes | ||
| overview | Yes | ||
| poster_url | Yes | ||
| episode_count | Yes | ||
| season_number | Yes |