add_to_watchlist
ChatGPTIdempotently add one movie to the signed-in user's FilmEase watchlist.
check_title_streaming_availability
ChatGPTResolve an exact title and optional year, then return its streaming availability for supplied region and services or the connected account's saved preferences.
clear_my_rating
ChatGPTClear one rating while preserving the review, current status, and watch history.
clear_my_review
ChatGPTDelete one review while preserving the rating, current status, and watch history.
discover_movies
ChatGPTSearch FilmEase for grounded movie candidates using natural-language intent, title anchors, exclusions, metadata filters, streaming preferences, and seen-history exclusions. Returns compact canonical movie records, streaming evidence, authoritative personal state, and attribution tokens. Saved region and services are used when explicit values are omitted. With onlyWatchable enabled, an explicitly empty services list returns no service-matched movies.
get_connected_account
ChatGPTReturn the email address of the FilmEase account connected to the current OAuth session.
get_my_movie
ChatGPTReturn the connected user's rating, review, watchlist status, watch history, and saved-service streaming availability for one canonical FilmEase movie ID.
get_my_streaming_preferences
ChatGPTReturn the connected user's viewer region, saved streaming-service provider keys, and setup-completion status. A completed setup with an empty services list represents an explicit no-subscriptions preference.
get_my_taste_description
ChatGPTReturn the connected user's saved free-text movie likes and dislikes. This is distinct from the rating-derived taste profile.
get_my_taste_profile
ChatGPTReturn a bounded profile derived from the connected user's ratings and reviews. Every returned rated film counts as seen.
get_personalized_recommendations
ChatGPTReturn FilmEase's cached or newly retrieved personalized recommendations, optionally filtered by watchability, taste cluster, mood, or viewing company. The response reports when a rating-derived taste profile is unavailable.
get_streaming_availability
ChatGPTReturn region-specific streaming offers for one canonical FilmEase movie ID, optionally restricted to named services. This operation does not resolve or substitute titles.
list_my_movies
ChatGPTList the connected user's watchlist, rated movies, or reviewed movies with the requested sorting and pagination.
list_my_seen_movies
ChatGPTList movies the connected user has explicitly watched, rated, or reviewed, with personal state and rich media URLs.
list_my_watch_history
ChatGPTList dated FilmEase viewing events and rewatches, including exact watch dates when recorded.
record_movie_card_event
ChatGPTRecord an explicit movie-card selection, negative-feedback choice, or observed 50%-visibility event using the opaque attribution token returned for that movie. A selection is not a watch event; already-seen feedback does not create a watch date or rating.
record_watch
ChatGPTRecord a viewing or rewatch with an optional timestamp, private companion labels, rating, and review. A supplied rating or review replaces the saved value; reviewIsPublic=true publishes the review.
remove_from_watchlist
ChatGPTRemove watchlist membership without deleting ratings, reviews, or watch history.
remove_watch_record
ChatGPTDelete one exact viewing event while preserving the rating, review, and current watched status.
render_movies
ChatGPTRender supplied FilmEase movie data as a movie detail, recommendation carousel, or personal-library view. Missing streaming availability is enriched from the connected account's saved region and services. Supplied streaming evidence, canonical IDs, factual fields, and attribution tokens are preserved.
search_films
ChatGPTResolve an exact movie title and optional release year to canonical FilmEase movie IDs, including disambiguation metadata when more than one match is plausible.
set_my_rating
ChatGPTSet or replace the signed-in user's 1-10 rating. This marks the film watched and preserves any review and watch history.
set_my_review
ChatGPTWrite or replace the signed-in user's review. This preserves the rating and watch history. Reviews remain private unless isPublic is explicitly true; a public review can be read by other FilmEase users.
set_my_streaming_preferences
ChatGPTAtomically replace the connected user's viewer region and complete streaming-services list. Omitted existing services are removed, and watchable recommendation caches are invalidated.
set_my_taste_description
ChatGPTSave or replace the connected user's explicit free-text movie likes and dislikes. Empty text clears only this description; ratings and reviews are preserved.