Discover movies
discover_moviesFilter movies by genre, cast, crew, companies, keywords, release dates, ratings, runtime, or streaming availability to find titles matching specific criteria without text search.
Instructions
Find movies by filters instead of text: genres, people, companies, keywords, release dates, ratings, runtime, streaming availability. Use get_genres for genre IDs and search for person, company or keyword IDs.
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_movies"
}
}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"} | |
| region | No | ISO 3166-1 country for release date filters | |
| 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_cast | No | Person IDs in the cast. Comma means AND, pipe means OR | |
| with_crew | No | Person IDs in the crew. Comma means AND, 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_people | No | Person IDs in cast or crew. Comma means AND, pipe means OR | |
| 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 | |
| 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 | |
| with_origin_country | No | ISO 3166-1 origin country, e.g. US, KR | |
| primary_release_year | No | Exact primary release year | |
| 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 | |
| primary_release_date_gte | No | Released on or after, YYYY-MM-DD | |
| primary_release_date_lte | No | Released on or before, YYYY-MM-DD | |
| with_watch_monetization_types | No | flatrate, free, ads, rent or buy. Pipe means OR |