{
  "markdown": "# What2Watch MCP\n\n**Give Your AI Superpowers for Entertainment Discovery**\n\n[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Live Server](https://img.shields.io/badge/Server-Live-brightgreen)](https://what2watch.live)\n\n---\n\n## Stop Getting Generic Recommendations. Start Discovering What's *Actually On*.\n\nRegular 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:\n\n- **Real-time TV schedules** for 1000+ channels (ABC, CBS, NBC, FOX, ESPN, CNN, HBO, AMC...)\n- **Free streaming (FAST)** channels (Pluto TV, Tubi, Freevee, Roku Channel, Peacock Free, Samsung TV+, Xumo)\n- **All major SVOD services** (Netflix, Prime Video, Disney+, Hulu, HBO Max, Apple TV+, Paramount+)\n- **Truly personalized recommendations** based on your mood, taste, and available time\n- **\"Surprise Me\" mode** to discover hidden gems you'd never find on your own\n\n**Real data. Real-time. Really personalized.**\n\n---\n\n## Quick Start\n\n### Connect via Claude\n\n1. Open Claude → Settings → Connectors\n2. Add Custom Connector: `https://what2watch.live/sse`\n3. Authenticate with email magic link\n4. Ask: *\"What should I watch tonight?\"*\n\n### Connect via ChatGPT\n\n1. Go to [chatgpt.com](https://chatgpt.com) → Settings → Apps & Connectors\n2. Enable Developer Mode in Advanced Settings\n3. Create App with URL: `https://what2watch.live/sse`\n4. Authenticate and start discovering!\n\n---\n\n## Tools\n\nWhat2Watch MCP provides **6 powerful tools** for entertainment discovery.\n\n### `get_recommendation`\n\nGet personalized movie and TV recommendations based on your preferences.\n\n```typescript\ninterface GetRecommendationParams {\n  // Location & Language\n  location?: string;              // Country code (default: \"US\")\n  languages?: string[];           // Preferred languages [\"en\", \"es\"]\n\n  // User Profile\n  gender?: string;                // User's gender\n  age_group?: string;             // \"kids\" | \"teenager\" | \"young adult\" | \"adult\" | \"senior\"\n\n  // Platforms\n  platforms?: string[];           // [\"netflix\", \"prime\", \"disney_plus\", \"hulu\", \"hbo_max\", \"apple_tv_plus\"]\n  channels?: string[];            // Cable/linear TV channels\n\n  // Taste Profile\n  liked_media?: string[];         // Titles they enjoyed [\"Breaking Bad\", \"The Wire\"]\n  disliked_media?: string[];      // Titles to avoid\n  watched_media?: string[];       // Already seen (excluded from results)\n\n  // Filters\n  media_type?: string;            // \"movie\" | \"series\" | \"documentary\"\n  genre?: string;                 // \"comedy\" | \"drama\" | \"action\" | \"thriller\" | \"sci-fi\" | \"horror\" | \"romance\"\n  mood?: string;                  // \"relaxing\" | \"exciting\" | \"thought-provoking\"\n  watch_time?: string;            // \"now\" | \"tonight\" | \"later\"\n\n  // Discovery\n  surprise_me?: boolean;          // Discover underrated hidden gems (default: false)\n  limit?: number;                 // Max results 1-10 (default: 5)\n}\n```\n\n**Example queries:**\n- *\"What should I watch?\"*\n- *\"Recommend something like Breaking Bad\"*\n- *\"I'm in the mood for a relaxing comedy\"*\n- *\"Surprise me with hidden gems\"*\n\n---\n\n### `search_content`\n\nSearch for movies and shows by title, actor, director, or keywords.\n\n```typescript\ninterface SearchContentParams {\n  keywords?: string;              // Text search (title, actor name, plot keywords)\n  genres?: string[];              // Filter by multiple genres\n  min_rating?: number;            // Minimum IMDB score 0-10 (e.g., 7.5)\n  year_from?: number;             // Release year start (e.g., 2020)\n  year_to?: number;               // Release year end (e.g., 2024)\n  location?: string;              // Country code (default: \"US\")\n  languages?: string[];           // Preferred languages\n  platforms?: string[];           // Streaming services filter\n  liked_media?: string[];         // Boosts similar content in ranking\n  disliked_media?: string[];      // Titles to avoid\n  watched_media?: string[];       // Already seen (excluded)\n  media_type?: string;            // \"movie\" | \"series\" | \"episode\" | \"documentary\"\n  genre?: string;                 // Single genre filter\n  mood?: string;                  // \"relaxing\" | \"exciting\" | \"thought-provoking\"\n  limit?: number;                 // Max results 1-10 (default: 5)\n}\n```\n\n**Example queries:**\n- *\"Find Tom Hanks movies\"*\n- *\"Action movies on Netflix rated above 8\"*\n- *\"Sci-fi shows from 2020-2024\"*\n- *\"Search for Dune\"*\n\n---\n\n### `get_content_details`\n\nGet full details about a specific movie or TV show.\n\n```typescript\ninterface GetContentDetailsParams {\n  content_id: string;             // The ID from search/recommendation results\n}\n```\n\n**Returns:** Full details including plot, cast, crew, ratings, trailers, and streaming availability.\n\n**Example queries:**\n- *\"Tell me more about Inception\"*\n- *\"What's The Bear about?\"*\n- *\"Who stars in Severance?\"*\n- *\"Where can I watch Oppenheimer?\"*\n\n---\n\n### `get_schedule`\n\nGet TV broadcast schedule - what's on live TV right now or later.\n\n```typescript\ninterface GetScheduleParams {\n  time_range?: string;            // \"now\" (next 2h) | \"tonight\" (6PM-midnight) | \"today\" | \"tomorrow\"\n  channels?: string[];            // Filter by channel [\"hbo\", \"nbc\", \"espn\", \"abc\", \"cbs\", \"fox\"]\n  location?: string;              // Country code (default: \"US\")\n  liked_media?: string[];         // Boosts similar content\n  disliked_media?: string[];      // Titles to avoid (excluded)\n  watched_media?: string[];       // Already seen (excluded)\n  media_type?: string;            // \"movie\" | \"series\" | \"sports\" | \"news\" | \"documentary\"\n  genre?: string;                 // \"drama\" | \"comedy\" | \"sports\" | \"news\"\n  genres?: string[];              // Multiple genres [\"sports\", \"action\"]\n  min_rating?: number;            // Minimum IMDB score 0-10\n  limit?: number;                 // Max results 1-10 (default: 5)\n}\n```\n\n**Example queries:**\n- *\"What's on TV tonight?\"*\n- *\"What's on ESPN right now?\"*\n- *\"Movies on HBO tonight\"*\n- *\"Sports on TV tomorrow\"*\n\n---\n\n### `get_trending`\n\nSee what's popular and trending right now.\n\n```typescript\ninterface GetTrendingParams {\n  location?: string;              // Country code (default: \"US\")\n  platforms?: string[];           // Filter by streaming service\n  liked_media?: string[];         // For reference/personalization\n  disliked_media?: string[];      // Titles to avoid (excluded)\n  watched_media?: string[];       // Already seen (excluded)\n  media_type?: string;            // \"movie\" | \"series\"\n  genre?: string;                 // Filter by genre\n  time_window?: string;           // \"day\" | \"week\" | \"month\" (default: all time)\n  limit?: number;                 // Max results 1-10 (default: 5)\n}\n```\n\n**Example queries:**\n- *\"What's trending?\"*\n- *\"What's popular on Netflix?\"*\n- *\"Top movies this week\"*\n- *\"What is everyone watching?\"*\n\n---\n\n### `get_available_sources`\n\nList all streaming platforms and TV channels supported.\n\n```typescript\ninterface GetAvailableSourcesParams {\n  location?: string;              // Country code (default: \"US\")\n  include_channels?: boolean;     // Include TV channels with schedules (default: true)\n  include_platforms?: boolean;    // Include streaming platforms (default: true)\n}\n```\n\n**Returns:** Platforms grouped by type (subscription, free, rent, purchase) with content counts; TV channels with schedule availability.\n\n**Example queries:**\n- *\"What platforms do you support?\"*\n- *\"What streaming services are available?\"*\n- *\"Which channels have TV schedules?\"*\n\n---\n\n## Prompts\n\nWhat2Watch MCP provides **19 pre-built prompts** for common entertainment queries.\n\n### Discovery Prompts\n\n| Prompt | Parameters | Description |\n|--------|------------|-------------|\n| `what_to_watch` | `mood?`, `platforms?`, `media_type?` | The go-to prompt for \"I don't know what to watch\" |\n| `surprise_me` | `genre?` | Discover hidden gems and underrated content |\n| `recommend_by_mood` | `mood` (required) | Match your current mood (relaxing, exciting, funny, dark...) |\n| `similar_to` | `title` (required), `media_type?` | Find content similar to something you loved |\n\n### Search Prompts\n\n| Prompt | Parameters | Description |\n|--------|------------|-------------|\n| `find_title` | `title` (required) | Search for a specific movie or show |\n| `find_by_actor` | `actor_name` (required), `media_type?` | Find content featuring a specific actor |\n| `find_by_genre` | `genre` (required), `platforms?` | Find content in a specific genre |\n| `recent_releases` | `media_type?`, `genre?`, `min_rating?` | Find recent releases from the last year |\n\n### Trending Prompts\n\n| Prompt | Parameters | Description |\n|--------|------------|-------------|\n| `whats_trending` | `media_type?` | See what's popular right now |\n| `trending_on_platform` | `platform` (required) | What's popular on a specific service |\n| `top_rated` | `genre?`, `media_type?` | Find the highest-rated content |\n\n### TV Schedule Prompts\n\n| Prompt | Parameters | Description |\n|--------|------------|-------------|\n| `whats_on_tv` | `time_range?` | Check what's on live TV |\n| `whats_on_channel` | `channel` (required), `time_range?` | Schedule for a specific channel |\n\n### Occasion-Based Prompts\n\n| Prompt | Parameters | Description |\n|--------|------------|-------------|\n| `movie_night` | `group?`, `platforms?` | Recommendations for movie night (friends, family, date) |\n| `family_friendly` | `platforms?` | Kid-friendly content for the whole family |\n| `date_night` | `platforms?` | Romantic or date-appropriate picks |\n| `weekend_binge` | `genre?`, `platforms?` | Great series to binge over the weekend |\n| `quick_watch` | `max_minutes?` | Short content when you're limited on time |\n\n### Platform Prompts\n\n| Prompt | Parameters | Description |\n|--------|------------|-------------|\n| `available_platforms` | - | List all supported streaming services and channels |\n| `compare_platforms` | `title` (required) | Find where a specific title is available |\n\n---\n\n## Example Conversations\n\n### Finding Something to Watch\n\n> **User:** I'm in the mood for something dark and psychological, maybe like True Detective\n\n> **AI:** *Uses `get_recommendation` with mood=\"thought-provoking\", liked_media=[\"True Detective\"]*\n\n> Based on your love of True Detective, here are some dark psychological picks:\n> 1. **Mindhunter** (Netflix) - 8.6/10 - FBI agents interview serial killers\n> 2. **Sharp Objects** (HBO Max) - 8.1/10 - Reporter returns to her hometown\n> 3. **The Killing** (Hulu) - 8.3/10 - Detectives investigate a murder\n> ...\n\n### Checking Live TV\n\n> **User:** What's on ESPN tonight?\n\n> **AI:** *Uses `get_schedule` with channels=[\"espn\"], time_range=\"tonight\"*\n\n> Here's what's on ESPN tonight:\n> - 7:00 PM - **NBA Basketball: Lakers vs Celtics**\n> - 10:00 PM - **SportsCenter**\n> - 11:00 PM - **NFL Live**\n> ...\n\n### Discovering Hidden Gems\n\n> **User:** Surprise me with something I've probably never heard of\n\n> **AI:** *Uses `get_recommendation` with surprise_me=true*\n\n> Here are some hidden gems most people haven't discovered:\n> 1. **The Bear** (Hulu) - 8.6/10 - A chef returns to run his family's sandwich shop\n> 2. **Severance** (Apple TV+) - 8.7/10 - Office workers' memories are surgically divided\n> ...\n\n---\n\n## Response Format\n\nAll tools return structured responses with:\n\n```typescript\ninterface ToolResponse {\n  results: ContentItem[];         // Array of movies/shows\n  total_count: number;            // Total matches found\n  filters_applied: object;        // Which filters were used\n  next_steps: string[];           // Contextual follow-up suggestions\n}\n\ninterface ContentItem {\n  id: string;                     // Unique identifier\n  title: string;                  // Display title\n  type: \"movie\" | \"series\";       // Content type\n  year: number;                   // Release year\n  rating: number;                 // IMDB rating 0-10\n  genres: string[];               // Genre tags\n  plot: string;                   // Brief description\n  runtime?: number;               // Minutes (for movies)\n  seasons?: number;               // Season count (for series)\n  availability: Availability[];   // Where to watch\n}\n\ninterface Availability {\n  platform: string;               // \"netflix\", \"hulu\", etc.\n  platform_name: string;          // \"Netflix\", \"Hulu\", etc.\n  type: \"subscription\" | \"free\" | \"rent\" | \"purchase\";\n  link?: string;                  // Direct watch link\n  price?: number;                 // For rent/purchase\n}\n```\n\n---\n\n## Supported Platforms\n\n### Streaming Services (SVOD)\nNetflix, Amazon Prime Video, Disney+, Hulu, HBO Max, Apple TV+, Paramount+, Peacock, AMC+, Starz, Showtime, Britbox, Crunchyroll, and more.\n\n### Free Streaming (FAST)\nPluto TV, Tubi, Amazon Freevee, The Roku Channel, Peacock Free, Samsung TV Plus, Xumo, Plex, and more.\n\n### Live TV Channels\nABC, 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.\n\n---\n\n## Technical Details\n\n- **Protocol:** [Model Context Protocol (MCP)](https://modelcontextprotocol.io)\n- **Transport:** Server-Sent Events (SSE)\n- **Authentication:** OAuth 2.1 with PKCE\n- **Endpoint:** `https://what2watch.live/sse`\n\n---\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n## Links\n\n- **Live Server:** https://what2watch.live\n- **MCP Specification:** https://modelcontextprotocol.io\n\n---\n\n*Making AI Actually Useful for Entertainment*\n",
  "bytes": 13687,
  "sha": "7b3c27660f0fb8ba2a0872f84777493fc9505be25f117213ad4afe93a034da5a",
  "repo_slug": "lio1204/what2watch-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lio1204_what2watch_mcp_313b1764/readme"
}