search_titles
Find movies and/or TV shows that are genuinely available on a subscription streaming service in a specific country, filtered by score, genre, runtime, age rating, release year, country of origin, required cast members, notable people's own watch history, review tone, and similarity to a title the user already knows. All given filters combine with AND logic (except where noted). Use this instead of guessing streaming availability from general knowledge, which is frequently wrong or outdated -- catalogs change constantly and vary by country. Also use this tool for completely open-ended requests with no stated criteria at all, e.g. "suggest something to watch" or "I don't know what I want to watch" -- call it with just the country and no other filters to get QQuickPick's currently popular streamable picks, rather than answering from general knowledge alone. Movie results also carry a "facts" object (or null when unknown): Best Picture winner/nominee, Oscars won ("at least" -- the source is not exhaustive, so never state it as an exact count), festival top prizes, the work it is based on, and its franchise with all films in order. Use the awards / based_on_existing_work / franchise filters (movies only) to answer questions like "Oscar winners based on a novel I can stream tonight" or "all films of a franchise available to me". Use similar_to for "something like X" requests instead of guessing similar titles from general knowledge. Use origin_countries for requests like "an Asian film" or "a French series" -- do not guess specific titles from general knowledge for this. Each result includes a site_url (QQuickPick detail page) and, where available, a watch_link with required attribution -- include these links when presenting results to the user, not just the raw facts. The response also carries a top-level available_filters hint listing filters on this tool that were not used in this call -- consider offering ONE of them as a natural follow-up question, not all of them, and only when it fits the conversation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| sort | No | "hot" = most popular first, "new" = newest releases first. | hot |
| type | No | Search movies, TV shows, or both. | all |
| genre | No | Genre name, e.g. "Action", "Comedy", "Documentary". | |
| actors | No | Require all of these actors to appear together in the cast (AND logic) -- use this for "a film starring both X and Y". If, and only if, that combination has no streamable results at all, the response automatically falls back to titles matching any one of them individually, each tagged with a matched_actors field -- mention that distinction to the user rather than presenting it as if they all appeared together. | |
| awards | No | Movies only. Multiple values are OR logic -- keep films with at least one (not all) of these honours: best_picture_winner, best_picture_nominee (includes winners), oscar_winner (won any Oscar), festival_top_prize (Palme d'Or, Golden Bear, Golden Lion or the Cannes Grand Prix), bafta_best_film (BAFTA for Best Film), golden_globe_best_picture (Golden Globe for Best Motion Picture, drama or musical/comedy). The underlying data is not exhaustive (it knows roughly 40% of BAFTA/Golden Globe winners), so a missing honour does not prove a film did not win it. Sorted by score. | |
| country | Yes | ISO 3166-1 alpha-2 country code (e.g. "NL", "US", "GB") for the streaming region -- determines which subscriptions and age ratings apply. This cannot be detected automatically: an MCP server only sees its host infrastructure, never the end user's real location. If the user's country has not been stated in this conversation, ASK the user before calling this tool -- do not guess or default to one, since a wrong country returns streaming availability that does not apply to them. | |
| year_to | No | ||
| franchise | No | Movies only. Return the films of one franchise / film series in release order, e.g. "The Lord of the Rings", "Dune", "Harry Potter". Only films that are streamable in the given country are returned. | |
| max_score | No | ||
| min_score | No | Minimum TMDB score, 0-10. | |
| year_from | No | ||
| similar_to | No | Find titles similar to this one, e.g. "Inception" or "The Office", ranked by QQuickPick's own similarity signal rather than a guess from general knowledge. Resolves the given title first (use the type filter to disambiguate a movie vs TV show sharing a name); if type is "all", both a similar movie and a similar TV show are looked up independently. Combines with the other filters as normal (AND logic). | |
| watched_by | No | Only titles watched/reviewed by at least one of these notable people on QQuickPick (directors, critics, actors curating their own watch history), e.g. ["Martin Scorsese"]. OR logic across multiple names. Unknown names are ignored with a warning -- this is a small curated list of profiles, not a general "who has seen this" lookup. | |
| review_vibe | No | Filter by the tone of the title's reviews rather than a numeric score: funny, unique-take (an unusual angle), harsh (critical), or heartfelt. Multiple values are OR logic -- a title matches if it has at least one review with any of the given vibes, not all of them (e.g. ["funny","heartfelt"] returns titles that are either, not both at once -- a serious drama with one heartfelt review can appear here). Experimental -- runs on a curated sample of reviews, not the full catalog, so absence of a result does not mean no title has that vibe. | |
| kid_friendly | No | If true, only keep titles rated for general/family audiences in the target country (resolved to that country's own mildest local rating, e.g. G/U/AL). A convenient shortcut for max_age_rating when the exact local rating string is unknown -- do not set both; if both are given max_age_rating wins and kid_friendly is ignored with a warning. Not applied together with awards, based_on_existing_work, franchise, watched_by, review_vibe or similar_to (ignored there too, with a warning). | |
| exclude_genre | No | Genre name to exclude, e.g. "Horror" for "anything but horror". Opposite of genre. | |
| max_age_rating | No | Maximum age/content rating in the target country's own local rating system, e.g. "12", "PG-13", "16". | |
| origin_countries | No | ISO 3166-1 alpha-2 country/countries the title was originally produced in (e.g. "KR", "JP", "IN") -- NOT the streaming region. Multiple values are OR logic, e.g. ["KR","JP","IN"] for "an Asian film". Use this instead of guessing specific titles from general knowledge when the user asks for films/shows from a region rather than a specific country. | |
| critics_vs_viewers | No | Movies only. Keep only films where professional critics and ordinary viewers agree, where critics like the film more than viewers do, or where viewers like it more than critics. Only the verdict is available, never the underlying scores; films without enough critic data are left out. | |
| streaming_services | No | Require the title to be on at least one of these subscription streaming services, e.g. ["Netflix", "Disney Plus"]. Omit to allow any subscription service in that country. | |
| max_runtime_minutes | No | ||
| min_runtime_minutes | No | Minimum runtime in minutes (movies) or minimum episode runtime (TV). | |
| based_on_existing_work | No | Movies only. If true, keep only films adapted from an existing work (novel, comic, earlier film, ...). |