What2Watch

io.github.lio1204Published by GitHub account lio1204v1.0.0Updated Nov 2, 2026

Real-time TV schedules, streaming availability, and personalized recommendations.

The publisher's own server: watch.diy – DIY Store Finder

VerifiedSSEWeb executableLocation & LifestyleMedia & Design

Overview

AI-generated overview

Remote MCP server that gives an assistant live TV schedules, streaming availability, and personalized movie and show recommendations.

What you can do
  • Recommend movies and series by mood, genre, platform, age group, or titles already liked or watched, including a surprise-me discovery mode
  • Search titles, actors, directors, or keywords with filters for genre, IMDB rating, year, language, and platform
  • Fetch full details for a title, including plot, cast, crew, ratings, trailers, and where to watch
  • Check live TV schedules for 1000+ channels by time range, channel, genre, or rating
  • Show what is trending by platform, genre, and time window
  • List supported streaming services and channels, grouped by subscription, free, rent, or purchase
When to use it
Useful when someone wants help deciding what to watch, checking what is on live TV now or tonight, finding where a specific title streams, or getting recommendations tuned to mood, taste, and available time.
Requirements
A remote SSE endpoint; no local package or runtime. The README describes connecting through Claude connectors or ChatGPT apps and signing in with an email magic link (OAuth 2.1 with PKCE).
Before you install
Sign-in uses an email magic link, so the account email is shared with the service. Recommendation and search calls accept personal profile details such as age group, gender, location, and viewing history, which are sent to the remote server. Results include rent and purchase prices and watch links; the server itself does not appear to buy or play anything.

Installation

In SourceWeft

  1. Open What2Watch in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via SSE. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.lio1204%2Fwhat2watch-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "what2watch": {
      "type": "sse",
      "url": "https://what2watch.live/sse"
    }
  }
}

README

What2Watch MCP

Give Your AI Superpowers for Entertainment Discovery

[MCP Compatible] [License: MIT] [Live Server]


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.

typescript
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.

typescript
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_content_details

Get full details about a specific movie or TV show.

typescript
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_schedule

Get TV broadcast schedule - what's on live TV right now or later.

typescript
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"

get_trending

See what's popular and trending right now.

typescript
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?"

get_available_sources

List all streaming platforms and TV channels supported.

typescript
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?"

Prompts

What2Watch MCP provides 19 pre-built prompts for common entertainment queries.

Discovery Prompts

PromptParametersDescription
what_to_watchmood?, platforms?, media_type?The go-to prompt for "I don't know what to watch"
surprise_megenre?Discover hidden gems and underrated content
recommend_by_moodmood (required)Match your current mood (relaxing, exciting, funny, dark...)
similar_totitle (required), media_type?Find content similar to something you loved

Search Prompts

PromptParametersDescription
find_titletitle (required)Search for a specific movie or show
find_by_actoractor_name (required), media_type?Find content featuring a specific actor
find_by_genregenre (required), platforms?Find content in a specific genre
recent_releasesmedia_type?, genre?, min_rating?Find recent releases from the last year

Trending Prompts

PromptParametersDescription
whats_trendingmedia_type?See what's popular right now
trending_on_platformplatform (required)What's popular on a specific service
top_ratedgenre?, media_type?Find the highest-rated content

TV Schedule Prompts

PromptParametersDescription
whats_on_tvtime_range?Check what's on live TV
whats_on_channelchannel (required), time_range?Schedule for a specific channel

Occasion-Based Prompts

PromptParametersDescription
movie_nightgroup?, platforms?Recommendations for movie night (friends, family, date)
family_friendlyplatforms?Kid-friendly content for the whole family
date_nightplatforms?Romantic or date-appropriate picks
weekend_bingegenre?, platforms?Great series to binge over the weekend
quick_watchmax_minutes?Short content when you're limited on time

Platform Prompts

PromptParametersDescription
available_platforms-List all supported streaming services and channels
compare_platformstitle (required)Find where a specific title is available

Example Conversations

Finding Something to Watch

User: I'm in the mood for something dark and psychological, maybe like True Detective

AI: Uses get_recommendation with mood="thought-provoking", liked_media=["True Detective"]

Based on your love of True Detective, here are some dark psychological picks:

  1. Mindhunter (Netflix) - 8.6/10 - FBI agents interview serial killers
  2. Sharp Objects (HBO Max) - 8.1/10 - Reporter returns to her hometown
  3. The Killing (Hulu) - 8.3/10 - Detectives investigate a murder ...

Checking Live TV

User: What's on ESPN tonight?

AI: Uses get_schedule with 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_recommendation with surprise_me=true

Here are some hidden gems most people haven't discovered:

  1. The Bear (Hulu) - 8.6/10 - A chef returns to run his family's sandwich shop
  2. Severance (Apple TV+) - 8.7/10 - Office workers' memories are surgically divided ...

Response Format

All tools return structured responses with:

typescript
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}

Supported Platforms

Streaming Services (SVOD)

Netflix, Amazon Prime Video, Disney+, Hulu, HBO Max, Apple TV+, Paramount+, Peacock, AMC+, Starz, Showtime, Britbox, Crunchyroll, and more.

Free Streaming (FAST)

Pluto TV, Tubi, Amazon Freevee, The Roku Channel, Peacock Free, Samsung TV Plus, Xumo, Plex, and more.

Live TV Channels

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.


Technical Details

  • Protocol: Model Context Protocol (MCP)
  • Transport: Server-Sent Events (SSE)
  • Authentication: OAuth 2.1 with PKCE
  • Endpoint: https://what2watch.live/sse

License

MIT License - see LICENSE for details.


Links


Making AI Actually Useful for Entertainment

Source: README.md at commit 05e2f35

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Watch integrations