Achriom

Edit metadata (title, creator, external ID). Use new_external_id to re-link to correct database entry, then call re_enrich to fetch correct metadata.

Add an item to the current research corpus (focused research mode only).

Get items filtered by user rating range.

Get items filtered by status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, watched, abandoned. Albums: unheard, listening, played, saved.

Get user context for adaptive conversation. Returns lifecycle stage and behavioral signals.

Get 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 information about the current research scope.

Get behavioral signals: theme repetition, consumption gaps, and recent activity.

Get collection statistics including progress, rating distribution, genre/theme breakdown, and timeline. If no media_type specified, returns combined stats.

Get timeline showing items started and finished over time.

Get playable 30-second audio previews for tracks from an album IN THE USER'S LIBRARY.

Get the persistent profile built from past conversations. Shows taste patterns, key facts, cross-media connections, and preferences.

Log a completion or a re-watch/re-read/re-listen with a date. Use when the user mentions finishing something again ("watched Heat again last night", "reread Dune"). The first finish is tracked by status; this records repeats so they show in history and stats.

Search 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 any album from Apple Music WITHOUT adding to library. Use this to sample before committing to add. Returns playable 30-second previews.

Pick random item(s) for serendipitous discovery.

Re-fetch all metadata from external sources. Use when item has wrong data.

Read a specific section of an uploaded book by line numbers.

Save 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 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.

Semantic search within an uploaded book (EPUB/PDF). Uses AI embeddings to find relevant passages.

Search past conversations with this user. Supports semantic search - finds conceptually related conversations, not just keyword matches.

Semantic search across the user's entire library by meaning, theme, or vibe. Searches every book/movie/album/show/anime as one corpus. Use for cross-media or thematic questions like "things about grief" or "noir mood". For specific title/creator lookups, use the keyword `search` tool instead.

Search YouTube for relevant videos (interviews, trailers, analysis, music videos).

Set how a book was read: print, ebook, audiobook, or ereader.

Set the priority of an item in the collection. High = want this next, normal = standard backlog, low = speculative or distant.

Update how far the user is through an in-progress item. Books: current page. Shows: current season + episode. Anime: episodes watched.

ALWAYS 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.

Add or update personal notes for an item.

Set or update user rating. Supports half-stars: 0.5 to 5.0 in 0.5 increments (e.g. 3.5).

Update status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, watched, abandoned. Albums: unheard, listening, played, saved.