QQuickpick

npx add-mcp 'https://qquickpick.com/mcp'

← Back

Connect your AI assistant to QQuickpick

QQuickpick runs a Model Context Protocol (MCP) server, so an AI assistant (Claude, ChatGPT, or any other MCP-capable client) can search for streamable movies and TV shows directly, with real per-country availability, instead of guessing from general knowledge. This page is for a human setting up that connection; an AI reading the site machine-first should use /llms.txt instead.

Endpoint

https://qquickpick.com/mcp

Streamable HTTP transport, stateless (no session id required). Add this URL as a remote MCP server in your client of choice, or use the guided Claude/ChatGPT setup on the homepage.

Developer tools

Using an AI-enabled code editor instead of a chat app? These install directly, no copy-pasting required -- clicking opens the app and asks you to confirm.

Nothing happens when you click? That app isn't installed on this device -- use the endpoint URL above and add it manually instead (Cursor: Settings → MCP; VS Code: Command Palette → "MCP: Add Server").

Tool: search_titles

Finds movies and/or TV shows genuinely available on a subscription streaming service in a specific country, filtered by score, genre, runtime, age rating, release year, required cast members, similarity to a known title, and more. All given filters combine with AND logic. Also works with no filters at all beyond country, for open-ended "suggest something to watch" requests.

Parameter	Type	Description
country	string (required)	ISO 3166-1 alpha-2 code, e.g. "NL", "US", "GB".
type	"movie" | "tv" | "all"	Default "all".
streaming_services	string[]	Names, e.g. ["Netflix", "Disney Plus"]. Any match (OR).
min_score / max_score	number 0-10	Score, 0-10.
genre	string	Genre name, e.g. "Comedy".
exclude_genre	string	Genre name to exclude, e.g. "Horror".
min_runtime_minutes / max_runtime_minutes	number	Runtime (movies) or episode runtime (TV).
year_from / year_to	number	Release year range.
max_age_rating	string	Local rating ceiling for `country`, e.g. "12", "PG-13".
kid_friendly	boolean	Shortcut for the mildest local rating in `country`, resolved per movie/TV. Ignored if max_age_rating is also set.
actors	string[]	Names that must all appear together in the cast (AND). If that combination has zero streamable results, falls back to titles matching any one of them individually, tagged with matched_actors.
awards	string[]	Movies only. Any of "best_picture_winner", "best_picture_nominee", "oscar_winner", "festival_top_prize" (Cannes, Berlin, Venice), "bafta_best_film", "golden_globe_best_picture". Award data is not exhaustive.
based_on_existing_work	boolean	Movies only. Only films adapted from a novel, comic, earlier film, etc.
critics_vs_viewers	string[]	Movies only. Any of "critics_and_viewers_agree", "critics_like_it_more", "viewers_like_it_more". Verdict only, no scores.
franchise	string	Movies only. All streamable films of one franchise in release order, e.g. "The Lord of the Rings". Movie results also include a facts object (awards, source work, franchise).
watched_by	string[]	Only titles watched/reviewed by these notable people on QQuickPick, e.g. ["Martin Scorsese"]. Any match (OR). Small curated list.
review_vibe	string[]	Any of "funny", "unique-take", "harsh", "heartfelt" -- tone of the title's reviews rather than a score. Multiple values are OR (at least one, not all). Experimental, curated sample only.
similar_to	string	Titles similar to this one, e.g. "Inception", ranked by QQuickPick's own similarity signal.
sort / page	"hot" | "new", number	Default "hot", page 1.

Example

Call:

search_titles({
  type: "movie",
  country: "NL",
  genre: "Comedy",
  min_score: 7,
  max_runtime_minutes: 100
})

One result from the response, plus the response-level presentation note:

{
  "results": [{
    "media_type": "movie",
    "id": 803796,
    "title": "KPop Demon Hunters",
    "release_year": 2025,
    "score": 7.999,
    "runtime_minutes": 96,
    "streaming_on": ["Netflix"],
    "watch_link": {
      "url": "https://qquickpick.com/go/watch/movie/803796?region=NL",
      "attribution": "Streaming availability data via JustWatch"
    },
    "site_url": "https://qquickpick.com/movie/803796"
  }],
  "presentation_note": "For each result shown to the user, include its site_url as a link (e.g. \"More info: {site_url}\") so they can see full details on QQuickPick. If a result has a watch_link, also include its url and attribution text so the user can watch immediately."
}

Notes

• There is no separate public REST API -- the MCP server above is the only sanctioned way to access QQuickpick's data programmatically. The /api/* endpoints are internal to the website's own search box and are not a public interface.
• Streaming availability is country-specific and changes as licensing deals change; results reflect what QQuickpick's data source reports at request time.
• Every result with availability carries its own watch_link with a required data-source attribution (see Credits & attribution) -- please preserve that attribution text exactly when relaying results to a user.