QQuickpick

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['title', 'country'], 'properties': {'type': {'enum': ['movie', 'tv', 'auto'], 'type': 'string', 'default': 'auto', 'description': '"auto" (default) checks both movies and TV shows and returns whichever is the better match.'}, 'year': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1870, 'description': 'Release year, to disambiguate between titles that share a name (e.g. a remake). Omit if unknown.'}, 'title': {'type': 'string', 'maxLength': 200, 'description': 'The title to look up, e.g. "Parasite" or "The Batman".'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "NL", "US", "GB") for streaming availability. This cannot be detected automatically -- if the user\'s country has not been stated in this conversation, ASK the user before calling this tool rather than guessing.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['country'], 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 500, 'minimum': 1, 'description': 'Page of results, 10 per page. Use to get more results beyond the first page for the same filters.'}, 'sort': {'enum': ['hot', 'new'], 'type': 'string', 'default': 'hot', 'description': '"hot" = most popular first, "new" = newest releases first.'}, 'type': {'enum': ['movie', 'tv', 'all'], 'type': 'string', 'default': 'all', 'description': 'Search movies, TV shows, or both.'}, 'genre': {'type': 'string', 'maxLength': 40, 'description': 'Genre name, e.g. "Action", "Comedy", "Documentary".'}, 'actors': {'type': 'array', 'items': {'type': 'string', 'maxLength': 80}, 'maxItems': 5, 'description': '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': {'type': 'array', 'items': {'enum': ['best_picture_winner', 'best_picture_nominee', 'oscar_winner', 'festival_top_prize', 'bafta_best_film', 'golden_globe_best_picture'], 'type': 'string'}, 'maxItems': 6, 'description': "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': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': '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': {'type': 'number', 'description': 'Latest release year to include (movies) or first-air year (TV).'}, 'franchise': {'type': 'string', 'maxLength': 80, 'description': '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': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Maximum TMDB score, 0-10.'}, 'min_score': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Minimum TMDB score, 0-10.'}, 'year_from': {'type': 'number', 'description': 'Earliest release year to include (movies) or first-air year (TV).'}, 'similar_to': {'type': 'string', 'maxLength': 200, 'description': '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': {'type': 'array', 'items': {'type': 'string', 'maxLength': 80}, 'maxItems': 5, 'description': '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': {'type': 'array', 'items': {'enum': ['funny', 'unique-take', 'harsh', 'heartfelt'], 'type': 'string'}, 'maxItems': 4, 'description': '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': {'type': 'boolean', 'description': "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': {'type': 'string', 'maxLength': 40, 'description': 'Genre name to exclude, e.g. "Horror" for "anything but horror". Opposite of genre.'}, 'max_age_rating': {'type': 'string', 'maxLength': 10, 'description': 'Maximum age/content rating in the target country\'s own local rating system, e.g. "12", "PG-13", "16".'}, 'origin_countries': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}, 'maxItems': 10, 'description': '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': {'type': 'array', 'items': {'enum': ['critics_and_viewers_agree', 'critics_like_it_more', 'viewers_like_it_more'], 'type': 'string'}, 'maxItems': 3, 'description': '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': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60}, 'maxItems': 10, 'description': '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': {'type': 'number', 'minimum': 0, 'description': 'Maximum runtime in minutes (movies) or maximum episode runtime (TV).'}, 'min_runtime_minutes': {'type': 'number', 'minimum': 0, 'description': 'Minimum runtime in minutes (movies) or minimum episode runtime (TV).'}, 'based_on_existing_work': {'type': 'boolean', 'description': 'Movies only. If true, keep only films adapted from an existing work (novel, comic, earlier film, ...).'}}}