Movie Night

get_profile

Read the household profile. Returns member preferences, shared tastes, genres to avoid, streaming services, and movie night context. Always call this first to understand the household.

get_watch_history

Get the household's watch history. Returns recently watched movies with ratings, notes, and who watched. Use to avoid re-recommending movies and to understand taste patterns.

search_movies

Search for movies by title or keywords using TMDB. Returns a list of matching movies with basic info (title, year, overview, TMDB rating).

get_movie_details

Get detailed info about a specific movie including Rotten Tomatoes scores, Metacritic rating, IMDB rating, runtime, genres, and full overview. Call this for your top candidates before making final recommendations.

discover_movies

Discover movies by filtering on genre, year range, minimum rating, and sort order. Great for finding movies in a specific genre or era. Use TMDB genre IDs: 28=Action, 12=Adventure, 16=Animation, 35=Comedy, 80=Crime, 99=Documentary, 18=Drama, 10751=Family, 14=Fantasy, 36=History, 27=Horror, 10402=Music, 9648=Mystery, 10749=Romance, 878=Sci-Fi, 53=Thriller, 10752=War, 37=Western.

get_similar_movies

Get movies similar to a specific movie. Useful when the user says 'more like X' or when you want to find movies in a similar vein.

log_movie

Log a watched movie to the household's watch history. Include the TMDB ID, title, year, who watched, rating (1-5), and optional notes.

update_rating

Update the household or personal ratings for a movie already in watch history. Use when the user wants to correct or add ratings after the fact.

present_recommendations

Present exactly 3 movie recommendations to the user. Always use this tool to deliver recommendations — never list them as plain text. Returns the presented tmdb_ids so you know not to recommend them again this session. Do not recommend any tmdb_id that appeared in a prior present_recommendations result.

manage_passlist

Manage the household's pass list — movies they've actively decided to skip. Check this before recommending. Actions: 'list' to view, 'add' to add a movie, 'remove' to remove by TMDB ID.

save_profile

Save or update the household profile. Call this after gathering enough information about the household's preferences, members, streaming services, and movie night context. The profile should be a complete markdown document.

manage_watchlist

Manage the household's movie watchlist (movies they want to see). Actions: 'list' to view, 'add' to add a movie, 'remove' to remove by TMDB ID, 'update' to modify an existing entry.

rank_watchlist

Rank the household's existing watchlist for tonight using the household profile, watch history context, and TMDB/OMDb metadata. Use this when the user wants to see their saved watchlist ordered by best fit, or wants a recommendation drawn only from movies already on the watchlist.