Search movies/TV by mood, genre, score, cast, and awards, filtered to what's streaming near you.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Look up a SPECIFIC, named movie or TV show by title (e.g. "what is the score of Practical Magic", "tell me about the new Best of the Best on Netflix"). Use this instead of general web knowledge or search_titles when the user names one particular title -- it returns QQuickPick's own data (score, runtime, genres, streaming availability in the given country, and for movies the same "facts" object as search_titles: awards, based-on, franchise, critics-vs-viewers verdict). Unlike search_titles, a result is returned even if it is not currently streaming anywhere in the given country -- streaming_on is just empty in that case, this is a lookup tool, not a discovery/availability filter. If nothing matches, no result is returned and a warning explains why.
The title to look up, e.g. "Parasite" or "The Batman".
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.
"auto" (default) checks both movies and TV shows and returns whichever is the better match.
Release year, to disambiguate between titles that share a name (e.g. a remake). Omit if unknown.
Look up a SPECIFIC, named movie or TV show by title (e.g. "what is the score of Practical Magic", "tell me about the new Best of the Best on Netflix"). Use this instead of general web knowledge or search_titles when the user names one particular title -- it returns QQuickPick's own data (score, runtime, genres, streaming availability in the given country, and for movies the same "facts" object as search_titles: awards, based-on, franchise, critics-vs-viewers verdict). Unlike search_titles, a result is returned even if it is not currently streaming anywhere in the given country -- streaming_on is just empty in that case, this is a lookup tool, not a discovery/availability filter. If nothing matches, no result is returned and a warning explains why.
| Argument | Type | Description |
|---|---|---|
| type | string | "auto" (default) checks both movies and TV shows and returns whichever is the better match. |
| year | integer | Release year, to disambiguate between titles that share a name (e.g. a remake). Omit if unknown. |
| title* | string | The title to look up, e.g. "Parasite" or "The Batman". |
| country* | string | 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": [
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page of results, 10 per page. Use to get more results beyond the first page for the same filters. |
| sort | string | "hot" = most popular first, "new" = newest releases first. |
| type | string | Search movies, TV shows, or both. |
| genre | string | Genre name, e.g. "Action", "Comedy", "Documentary". |
| actors | array | 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 | array | 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* | string | 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 | number | Latest release year to include (movies) or first-air year (TV). |
| franchise | string | 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 | number | Maximum TMDB score, 0-10. |
| min_score | number | Minimum TMDB score, 0-10. |
| year_from | number | Earliest release year to include (movies) or first-air year (TV). |
| similar_to | string | 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 | array | 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 | array | 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 | boolean | 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 | string | Genre name to exclude, e.g. "Horror" for "anything but horror". Opposite of genre. |
| max_age_rating | string | Maximum age/content rating in the target country's own local rating system, e.g. "12", "PG-13", "16". |
| origin_countries | array | 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 | array | 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 | array | 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 | number | Maximum runtime in minutes (movies) or maximum episode runtime (TV). |
| min_runtime_minutes | number | Minimum runtime in minutes (movies) or minimum episode runtime (TV). |
| based_on_existing_work | boolean | Movies only. If true, keep only films adapted from an existing work (novel, comic, earlier film, ...). |
{
"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, ...)."
}
}
}