Discover TV shows
discover_tvFind TV shows using filters like genre, network, air date, rating, status, and streaming availability instead of text search.
Instructions
Find TV shows by filters instead of text: genres, networks, companies, keywords, air dates, ratings, status, streaming availability.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "discover_tv"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Results page, 1-500. Each page holds up to 20 results. | |
| extra | No | Any other TMDB discover query parameter, passed through as-is, e.g. {"with_release_type": "4|5", "certification_country": "US"} | |
| sort_by | No | Sort order, e.g. popularity.desc (default), vote_average.desc, vote_count.desc, revenue.desc | |
| language | No | Response language as ISO 639-1 with optional ISO 3166-1 region, e.g. en-US or fr-FR. Defaults to TMDB_LANGUAGE. | |
| with_type | No | 0 Documentary, 1 News, 2 Miniseries, 3 Reality, 4 Scripted, 5 Talk Show, 6 Video. Pipe means OR | |
| with_genres | No | Genre IDs from get_genres. Comma means AND, pipe means OR, e.g. "28,12" or "28|12" | |
| with_status | No | 0 Returning Series, 1 Planned, 2 In Production, 3 Ended, 4 Canceled, 5 Pilot. Pipe means OR | |
| air_date_gte | No | Has an episode airing on or after, YYYY-MM-DD | |
| air_date_lte | No | Has an episode airing on or before, YYYY-MM-DD | |
| watch_region | No | ISO 3166-1 country for watch provider filters, e.g. US | |
| include_adult | No | ||
| with_keywords | No | Keyword IDs (search type=keyword). Comma means AND, pipe means OR | |
| with_networks | No | Network IDs, e.g. 213 for Netflix. Pipe means OR | |
| vote_count_gte | No | Minimum number of votes, useful with vote_average sorting | |
| with_companies | No | Production company IDs. Comma means AND, pipe means OR | |
| without_genres | No | Genre IDs to exclude, comma separated | |
| vote_average_gte | No | Minimum average rating | |
| vote_average_lte | No | Maximum average rating | |
| with_runtime_gte | No | Minimum runtime in minutes | |
| with_runtime_lte | No | Maximum runtime in minutes | |
| without_keywords | No | Keyword IDs to exclude | |
| first_air_date_gte | No | First aired on or after, YYYY-MM-DD | |
| first_air_date_lte | No | First aired on or before, YYYY-MM-DD | |
| first_air_date_year | No | Exact first air date year | |
| with_origin_country | No | ISO 3166-1 origin country, e.g. US, KR | |
| with_watch_providers | No | Watch provider IDs (see get_watch_providers). Pipe means OR. Requires watch_region | |
| with_original_language | No | ISO 639-1 original language, e.g. en, ko, ja | |
| with_watch_monetization_types | No | flatrate, free, ads, rent or buy. Pipe means OR |