What2Watch MCP

Give Your AI Superpowers for Entertainment Discovery

Stop Getting Generic Recommendations. Start Discovering What's Actually On.

Regular AI assistants search the web and return the same "trending on Netflix" lists from 2023. What2Watch MCP plugs directly into your AI, giving it access to:

• Real-time TV schedules for 1000+ channels (ABC, CBS, NBC, FOX, ESPN, CNN, HBO, AMC...)
• Free streaming (FAST) channels (Pluto TV, Tubi, Freevee, Roku Channel, Peacock Free, Samsung TV+, Xumo)
• All major SVOD services (Netflix, Prime Video, Disney+, Hulu, HBO Max, Apple TV+, Paramount+)
• Truly personalized recommendations based on your mood, taste, and available time
• "Surprise Me" mode to discover hidden gems you'd never find on your own

Real data. Real-time. Really personalized.

Quick Start

Connect via Claude

1. Open Claude → Settings → Connectors
2. Add Custom Connector: https://what2watch.live/sse
3. Authenticate with email magic link
4. Ask: "What should I watch tonight?"

Connect via ChatGPT

1. Go to chatgpt.com → Settings → Apps & Connectors
2. Enable Developer Mode in Advanced Settings
3. Create App with URL: https://what2watch.live/sse
4. Authenticate and start discovering!

Tools

What2Watch MCP provides 6 powerful tools for entertainment discovery.

get_recommendation

Get personalized movie and TV recommendations based on your preferences.

interface GetRecommendationParams {
  // Location & Language
  location?: string;              // Country code (default: "US")
  languages?: string[];           // Preferred languages ["en", "es"]

  // User Profile
  gender?: string;                // User's gender
  age_group?: string;             // "kids" | "teenager" | "young adult" | "adult" | "senior"

  // Platforms
  platforms?: string[];           // ["netflix", "prime", "disney_plus", "hulu", "hbo_max", "apple_tv_plus"]
  channels?: string[];            // Cable/linear TV channels

  // Taste Profile
  liked_media?: string[];         // Titles they enjoyed ["Breaking Bad", "The Wire"]
  disliked_media?: string[];      // Titles to avoid
  watched_media?: string[];       // Already seen (excluded from results)

  // Filters
  media_type?: string;            // "movie" | "series" | "documentary"
  genre?: string;                 // "comedy" | "drama" | "action" | "thriller" | "sci-fi" | "horror" | "romance"
  mood?: string;                  // "relaxing" | "exciting" | "thought-provoking"
  watch_time?: string;            // "now" | "tonight" | "later"

  // Discovery
  surprise_me?: boolean;          // Discover underrated hidden gems (default: false)
  limit?: number;                 // Max results 1-10 (default: 5)
}

Example queries:

• "What should I watch?"
• "Recommend something like Breaking Bad"
• "I'm in the mood for a relaxing comedy"
• "Surprise me with hidden gems"

search_content

Search for movies and shows by title, actor, director, or keywords.

interface SearchContentParams {
  keywords?: string;              // Text search (title, actor name, plot keywords)
  genres?: string[];              // Filter by multiple genres
  min_rating?: number;            // Minimum IMDB score 0-10 (e.g., 7.5)
  year_from?: number;             // Release year start (e.g., 2020)
  year_to?: number;               // Release year end (e.g., 2024)
  location?: string;              // Country code (default: "US")
  languages?: string[];           // Preferred languages
  platforms?: string[];           // Streaming services filter
  liked_media?: string[];         // Boosts similar

... [View full README on GitHub](https://github.com/lio1204/what2watch-mcp#readme)