Give Your AI Superpowers for Entertainment Discovery
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.
- Open Claude → Settings → Connectors
- Add Custom Connector:
https://what2watch.live/sse - Authenticate with email magic link
- Ask: "What should I watch tonight?"
- Go to chatgpt.com → Settings → Apps & Connectors
- Enable Developer Mode in Advanced Settings
- Create App with URL:
https://what2watch.live/sse - Authenticate and start discovering!
What2Watch MCP provides 6 powerful tools for entertainment discovery.
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 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 content in ranking
disliked_media?: string[]; // Titles to avoid
watched_media?: string[]; // Already seen (excluded)
media_type?: string; // "movie" | "series" | "episode" | "documentary"
genre?: string; // Single genre filter
mood?: string; // "relaxing" | "exciting" | "thought-provoking"
limit?: number; // Max results 1-10 (default: 5)
}Example queries:
- "Find Tom Hanks movies"
- "Action movies on Netflix rated above 8"
- "Sci-fi shows from 2020-2024"
- "Search for Dune"
Get full details about a specific movie or TV show.
interface GetContentDetailsParams {
content_id: string; // The ID from search/recommendation results
}Returns: Full details including plot, cast, crew, ratings, trailers, and streaming availability.
Example queries:
- "Tell me more about Inception"
- "What's The Bear about?"
- "Who stars in Severance?"
- "Where can I watch Oppenheimer?"
Get TV broadcast schedule - what's on live TV right now or later.
interface GetScheduleParams {
time_range?: string; // "now" (next 2h) | "tonight" (6PM-midnight) | "today" | "tomorrow"
channels?: string[]; // Filter by channel ["hbo", "nbc", "espn", "abc", "cbs", "fox"]
location?: string; // Country code (default: "US")
liked_media?: string[]; // Boosts similar content
disliked_media?: string[]; // Titles to avoid (excluded)
watched_media?: string[]; // Already seen (excluded)
media_type?: string; // "movie" | "series" | "sports" | "news" | "documentary"
genre?: string; // "drama" | "comedy" | "sports" | "news"
genres?: string[]; // Multiple genres ["sports", "action"]
min_rating?: number; // Minimum IMDB score 0-10
limit?: number; // Max results 1-10 (default: 5)
}Example queries:
- "What's on TV tonight?"
- "What's on ESPN right now?"
- "Movies on HBO tonight"
- "Sports on TV tomorrow"
See what's popular and trending right now.
interface GetTrendingParams {
location?: string; // Country code (default: "US")
platforms?: string[]; // Filter by streaming service
liked_media?: string[]; // For reference/personalization
disliked_media?: string[]; // Titles to avoid (excluded)
watched_media?: string[]; // Already seen (excluded)
media_type?: string; // "movie" | "series"
genre?: string; // Filter by genre
time_window?: string; // "day" | "week" | "month" (default: all time)
limit?: number; // Max results 1-10 (default: 5)
}Example queries:
- "What's trending?"
- "What's popular on Netflix?"
- "Top movies this week"
- "What is everyone watching?"
List all streaming platforms and TV channels supported.
interface GetAvailableSourcesParams {
location?: string; // Country code (default: "US")
include_channels?: boolean; // Include TV channels with schedules (default: true)
include_platforms?: boolean; // Include streaming platforms (default: true)
}Returns: Platforms grouped by type (subscription, free, rent, purchase) with content counts; TV channels with schedule availability.
Example queries:
- "What platforms do you support?"
- "What streaming services are available?"
- "Which channels have TV schedules?"
What2Watch MCP provides 19 pre-built prompts for common entertainment queries.
| Prompt | Parameters | Description |
|---|---|---|
what_to_watch |
mood?, platforms?, media_type? |
The go-to prompt for "I don't know what to watch" |
surprise_me |
genre? |
Discover hidden gems and underrated content |
recommend_by_mood |
mood (required) |
Match your current mood (relaxing, exciting, funny, dark...) |
similar_to |
title (required), media_type? |
Find content similar to something you loved |
| Prompt | Parameters | Description |
|---|---|---|
find_title |
title (required) |
Search for a specific movie or show |
find_by_actor |
actor_name (required), media_type? |
Find content featuring a specific actor |
find_by_genre |
genre (required), platforms? |
Find content in a specific genre |
recent_releases |
media_type?, genre?, min_rating? |
Find recent releases from the last year |
| Prompt | Parameters | Description |
|---|---|---|
whats_trending |
media_type? |
See what's popular right now |
trending_on_platform |
platform (required) |
What's popular on a specific service |
top_rated |
genre?, media_type? |
Find the highest-rated content |
| Prompt | Parameters | Description |
|---|---|---|
whats_on_tv |
time_range? |
Check what's on live TV |
whats_on_channel |
channel (required), time_range? |
Schedule for a specific channel |
| Prompt | Parameters | Description |
|---|---|---|
movie_night |
group?, platforms? |
Recommendations for movie night (friends, family, date) |
family_friendly |
platforms? |
Kid-friendly content for the whole family |
date_night |
platforms? |
Romantic or date-appropriate picks |
weekend_binge |
genre?, platforms? |
Great series to binge over the weekend |
quick_watch |
max_minutes? |
Short content when you're limited on time |
| Prompt | Parameters | Description |
|---|---|---|
available_platforms |
- | List all supported streaming services and channels |
compare_platforms |
title (required) |
Find where a specific title is available |
User: I'm in the mood for something dark and psychological, maybe like True Detective
AI: Uses
get_recommendationwith mood="thought-provoking", liked_media=["True Detective"]
Based on your love of True Detective, here are some dark psychological picks:
- Mindhunter (Netflix) - 8.6/10 - FBI agents interview serial killers
- Sharp Objects (HBO Max) - 8.1/10 - Reporter returns to her hometown
- The Killing (Hulu) - 8.3/10 - Detectives investigate a murder ...
User: What's on ESPN tonight?
AI: Uses
get_schedulewith channels=["espn"], time_range="tonight"
Here's what's on ESPN tonight:
- 7:00 PM - NBA Basketball: Lakers vs Celtics
- 10:00 PM - SportsCenter
- 11:00 PM - NFL Live ...
Discovering Hidden Gems
User: Surprise me with something I've probably never heard of
AI: Uses
get_recommendationwith surprise_me=true
Here are some hidden gems most people haven't discovered:
- The Bear (Hulu) - 8.6/10 - A chef returns to run his family's sandwich shop
- Severance (Apple TV+) - 8.7/10 - Office workers' memories are surgically divided ...
All tools return structured responses with:
interface ToolResponse {
results: ContentItem[]; // Array of movies/shows
total_count: number; // Total matches found
filters_applied: object; // Which filters were used
next_steps: string[]; // Contextual follow-up suggestions
}
interface ContentItem {
id: string; // Unique identifier
title: string; // Display title
type: "movie" | "series"; // Content type
year: number; // Release year
rating: number; // IMDB rating 0-10
genres: string[]; // Genre tags
plot: string; // Brief description
runtime?: number; // Minutes (for movies)
seasons?: number; // Season count (for series)
availability: Availability[]; // Where to watch
}
interface Availability {
platform: string; // "netflix", "hulu", etc.
platform_name: string; // "Netflix", "Hulu", etc.
type: "subscription" | "free" | "rent" | "purchase";
link?: string; // Direct watch link
price?: number; // For rent/purchase
}Netflix, Amazon Prime Video, Disney+, Hulu, HBO Max, Apple TV+, Paramount+, Peacock, AMC+, Starz, Showtime, Britbox, Crunchyroll, and more.
Pluto TV, Tubi, Amazon Freevee, The Roku Channel, Peacock Free, Samsung TV Plus, Xumo, Plex, and more.
ABC, CBS, NBC, FOX, ESPN, ESPN2, CNN, MSNBC, Fox News, HBO, Showtime, AMC, FX, TNT, TBS, USA, Bravo, HGTV, Food Network, Discovery, History, A&E, Lifetime, Comedy Central, MTV, VH1, BET, Nickelodeon, Disney Channel, Cartoon Network, and 1000+ more.
- Protocol: Model Context Protocol (MCP)
- Transport: Server-Sent Events (SSE)
- Authentication: OAuth 2.1 with PKCE
- Endpoint:
https://what2watch.live/sse
MIT License - see LICENSE for details.
- Live Server: https://what2watch.live
- MCP Specification: https://modelcontextprotocol.io
Making AI Actually Useful for Entertainment