add_to_watchlist
ChatGPTAdd a show or movie to the user's watchlist. Requires a TMDB ID (found via search_show) and the type ('tv' or 'movie'). The show is added with 'plan_to_watch' status by default. Use update_watch_status to change the status after adding.
get_discover
ChatGPTGet trending and popular shows right now. Returns 4 sections: trending TV, trending movies, popular TV, and popular movies (10 items each). No parameters needed. Use this when the user asks 'what should I watch?', 'what's popular?', or wants browsing recommendations.
get_ratings
ChatGPTGet the user's ratings and community ratings for a show. Returns both the user's personal rating and aggregate community ratings. showId accepts either the Watchr show ID or a TMDB ID.
get_recommendations
ChatGPTGet personalized show recommendations based on the user's watch history and ratings. No parameters needed — uses the authenticated user's data to suggest new shows.
get_season_details
ChatGPTGet the episode list for a specific season of a TV show. Returns episode numbers, titles, overviews, air dates, and runtime. Requires a TMDB ID (found via search_show) and a season number. Use this when the user wants to see all episodes of a specific season.
get_show_details
ChatGPTGet detailed information about a show including seasons, episodes, cast, genres, and ratings. Requires a TMDB ID (found via search_show). Use this to get show details before rating, commenting, or tracking episodes.
get_similar_shows
ChatGPTGet AI-powered similar show recommendations based on a given show. Returns a list of similar shows with explanations of why they are similar. showId accepts either the Watchr show ID or a TMDB ID. Use this when the user asks 'what else is like X?' or 'if I liked X, what should I watch next?'.
get_stats
ChatGPTGet the authenticated user's watching statistics including total episodes watched, total hours, current streak, top genres, and recent activity. No parameters needed.
get_unwatched_episodes
ChatGPTGet all unwatched episodes for shows in the user's watchlist. Returns episodes already aired (continue watching) and optionally upcoming, grouped by show. Pass includeUpcoming=true to also list future episodes. Each show includes unwatchedEpisodes with season, episode, name, airDate, and an 'aired' flag (true if already broadcast, false if upcoming). Pass type='movie' to list unwatched movies instead.
get_upcoming
ChatGPTGet upcoming episodes for shows in the user's watchlist. Returns episodes grouped by time period: today, this week, next week, and later. No parameters needed — uses the authenticated user's watchlist.
get_watch_progress
ChatGPTGet the user's watch progress for a specific show — how many episodes watched, total episodes, current season/episode, and percentage. showId accepts either the Watchr show ID or a TMDB ID. Use this when the user asks 'where am I in show X?' or 'how far along am I?'.
list_favorites
ChatGPTList the user's favorite shows and movies with pagination. Optionally filter by type ('tv' or 'movie'). Favorites are separate from the watchlist — use list_watchlist to see tracked shows. Use toggle_favorite to add or remove a favorite.
list_watchlist
ChatGPTList the shows and movies in the user's watchlist with pagination. Each item includes watch status, progress, and last watched episode. Use page and limit for pagination (default 20 items per page).
mark_episodes_up_to
ChatGPTMark all episodes up to and including a specific season/episode as watched. Useful for catching up after watching multiple episodes. Requires showId, season, and episode. Set includePrevious to true (default) to also mark all earlier seasons. showId accepts either the Watchr show ID or a TMDB ID.
rate_show
ChatGPTRate a show or a specific episode from 1 to 5 stars. The 'value' field is required (integer 1-5). Optionally include a 'review' text, and season/episode to rate a specific episode instead of the whole show. showId accepts either the Watchr show ID or a TMDB ID. This does NOT post a comment — use add_comment for that. Use unrate_show to remove a rating.
remove_from_watchlist
ChatGPTRemove a show or movie from the user's watchlist entirely. This deletes the tracking entry, ratings are preserved. showId accepts either the Watchr show ID or a TMDB ID. This is irreversible.
search_show
ChatGPTSearch for TV shows and movies by title. Returns a list of matches with TMDB IDs, titles, posters, and release years. Use this first to find a show before using other tools that need a showId or tmdbId.
toggle_episode
ChatGPTMark a single specific episode as watched or unwatched. Requires showId, season number, episode number, and a boolean 'watched'. showId accepts either the Watchr show ID or a TMDB ID. Use mark_episodes_up_to to mark multiple episodes at once.
toggle_favorite
ChatGPTAdd or remove a show from the user's favorites. Set 'favorite' to true to add, false to remove. Favorites are separate from the watchlist — this does NOT add the show to the watchlist. showId accepts either the Watchr show ID or a TMDB ID. Use list_favorites to see current favorites.
unrate_show
ChatGPTRemove the user's rating for a show or a specific episode. If season and episode are omitted, removes the show-level rating. showId accepts either the Watchr show ID or a TMDB ID. This does NOT delete comments — use delete_comment for that.
update_watch_status
ChatGPTChange the watch status of a show already in the user's watchlist. Status options: 'watching', 'completed', 'plan_to_watch', 'dropped'. Setting status to 'completed' automatically marks all episodes as watched. showId accepts either the Watchr show ID or a TMDB ID. This does NOT rate the show — use rate_show for that.
add_to_watchlist
Claudeget_discover
Claudeget_ratings
Claudeget_recommendations
Claudeget_season_details
Claudeget_show_details
Claudeget_similar_shows
Claudeget_stats
Claudeget_unwatched_episodes
Claudeget_upcoming
Claudeget_watch_progress
Claudelist_favorites
Claudelist_watchlist
Claudemark_episodes_up_to
Clauderate_show
Clauderemove_from_watchlist
Claudesearch_show
Claudetoggle_episode
Claudetoggle_favorite
Claudeunrate_show
Claudeupdate_watch_status
Claude
