add_item
ChatGPTAdd a new item to the library. For best results, use lookup_item first to get the external_id. IMPORTANT: Use anime (not show) for ALL Japanese animation including series, movies, OVAs.
add_item
ChatGPTAdd a new item to the library. For best results, use lookup_item first to get the external_id. IMPORTANT: Use anime (not show) for ALL Japanese animation including series, movies, OVAs.
bulk_update_status
ChatGPTUpdate status for multiple items at once.
bulk_update_status
ChatGPTUpdate status for multiple items at once.
delete_item
ChatGPTDelete an item from the library.
delete_item
ChatGPTDelete an item from the library.
edit_item
ChatGPTEdit metadata (title, creator, external ID). Use new_external_id to re-link to correct database entry, then call re_enrich to fetch correct metadata.
edit_item
ChatGPTEdit metadata (title, creator, external ID). Use new_external_id to re-link to correct database entry, then call re_enrich to fetch correct metadata.
expand_research_scope
ChatGPTAdd an item to the current research corpus (focused research mode only).
expand_research_scope
ChatGPTAdd an item to the current research corpus (focused research mode only).
get_by_rating
ChatGPTGet items filtered by user rating range.
get_by_rating
ChatGPTGet items filtered by user rating range.
get_by_status
ChatGPTGet items filtered by status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, watched, abandoned. Albums: unheard, listening, played, saved.
get_by_status
ChatGPTGet items filtered by status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, watched, abandoned. Albums: unheard, listening, played, saved.
get_context
ChatGPTGet user context for adaptive conversation. Returns lifecycle stage and behavioral signals.
get_context
ChatGPTGet user context for adaptive conversation. Returns lifecycle stage and behavioral signals.
get_details
ChatGPTGet FULL details of an item FROM THE USER'S COLLECTION including AI analysis, user notes, rating, timeline, and all metadata. For albums: includes track list with durations. For box sets: lists ALL contained albums. Use this to answer specific questions about items the user owns.
get_details
ChatGPTGet FULL details of an item FROM THE USER'S COLLECTION including AI analysis, user notes, rating, timeline, and all metadata. For albums: includes track list with durations. For box sets: lists ALL contained albums. Use this to answer specific questions about items the user owns.
get_scope_info
ChatGPTGet information about the current research scope.
get_scope_info
ChatGPTGet information about the current research scope.
get_signals
ChatGPTGet behavioral signals: theme repetition, consumption gaps, and recent activity.
get_signals
ChatGPTGet behavioral signals: theme repetition, consumption gaps, and recent activity.
get_stats
ChatGPTGet collection statistics including progress, rating distribution, genre/theme breakdown, and timeline. If no media_type specified, returns combined stats.
get_stats
ChatGPTGet collection statistics including progress, rating distribution, genre/theme breakdown, and timeline. If no media_type specified, returns combined stats.
get_timeline
ChatGPTGet timeline showing items started and finished over time.
get_timeline
ChatGPTGet timeline showing items started and finished over time.
get_track_previews
ChatGPTGet playable 30-second audio previews for tracks from an album IN THE USER'S LIBRARY.
get_track_previews
ChatGPTGet playable 30-second audio previews for tracks from an album IN THE USER'S LIBRARY.
get_user_profile
ChatGPTGet the persistent profile built from past conversations. Shows taste patterns, key facts, cross-media connections, and preferences.
get_user_profile
ChatGPTGet the persistent profile built from past conversations. Shows taste patterns, key facts, cross-media connections, and preferences.
lookup_item
ChatGPTSearch EXTERNAL databases (NOT the user's collection) to find items BEFORE adding them. Use search/get_details for items the user already owns. Data sources: Books=OpenLibrary, Movies/Shows=TMDB, Albums=Discogs, Anime=AniList. Use anime (not show) for Japanese animation.
lookup_item
ChatGPTSearch EXTERNAL databases (NOT the user's collection) to find items BEFORE adding them. Use search/get_details for items the user already owns. Data sources: Books=OpenLibrary, Movies/Shows=TMDB, Albums=Discogs, Anime=AniList. Use anime (not show) for Japanese animation.
preview_album
ChatGPTPreview any album from Apple Music WITHOUT adding to library. Use this to sample before committing to add. Returns playable 30-second previews.
preview_album
ChatGPTPreview any album from Apple Music WITHOUT adding to library. Use this to sample before committing to add. Returns playable 30-second previews.
random_pick
ChatGPTPick random item(s) for serendipitous discovery.
random_pick
ChatGPTPick random item(s) for serendipitous discovery.
re_enrich
ChatGPTRe-fetch all metadata from external sources. Use when item has wrong data.
re_enrich
ChatGPTRe-fetch all metadata from external sources. Use when item has wrong data.
read_book_section
ChatGPTRead a specific section of an uploaded book by line numbers.
read_book_section
ChatGPTRead a specific section of an uploaded book by line numbers.
save_insight
ChatGPTSave a lasting insight about the user to their persistent profile. Use when you discover meaningful patterns, preferences, personal connections to media, or cross-media themes.
save_insight
ChatGPTSave a lasting insight about the user to their persistent profile. Use when you discover meaningful patterns, preferences, personal connections to media, or cross-media themes.
search
ChatGPTSearch the USER'S COLLECTION by title, creator, genre, or theme. Returns items they own with status, ratings, and for box sets, the list of contained albums. Use this to answer questions about what the user has.
search
ChatGPTSearch the USER'S COLLECTION by title, creator, genre, or theme. Returns items they own with status, ratings, and for box sets, the list of contained albums. Use this to answer questions about what the user has.
search_book_content
ChatGPTSemantic search within an uploaded book (EPUB/PDF). Uses AI embeddings to find relevant passages.
search_book_content
ChatGPTSemantic search within an uploaded book (EPUB/PDF). Uses AI embeddings to find relevant passages.
search_conversations
ChatGPTSearch past conversations with this user. Supports semantic search - finds conceptually related conversations, not just keyword matches.
search_conversations
ChatGPTSearch past conversations with this user. Supports semantic search - finds conceptually related conversations, not just keyword matches.
search_youtube
ChatGPTSearch YouTube for relevant videos (interviews, trailers, analysis, music videos).
search_youtube
ChatGPTSearch YouTube for relevant videos (interviews, trailers, analysis, music videos).
show_item
ChatGPTALWAYS use this tool when users say "show me", "open", "go to", "take me to", or "pull up" an item. This navigates them to the item's detail page. Works on ALL clients (web app, iOS app, Claude Desktop) - triggers navigation or returns clickable URL. Do NOT just describe the item when they want to SEE it.
show_item
ChatGPTALWAYS use this tool when users say "show me", "open", "go to", "take me to", or "pull up" an item. This navigates them to the item's detail page. Works on ALL clients (web app, iOS app, Claude Desktop) - triggers navigation or returns clickable URL. Do NOT just describe the item when they want to SEE it.
update_notes
ChatGPTAdd or update personal notes for an item.
update_notes
ChatGPTAdd or update personal notes for an item.
update_rating
ChatGPTSet or update user rating (1-5 stars).
update_rating
ChatGPTSet or update user rating (1-5 stars).
update_status
ChatGPTUpdate status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, watched, abandoned. Albums: unheard, listening, played, saved.
update_status
ChatGPTUpdate status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, watched, abandoned. Albums: unheard, listening, played, saved.