Achriom
Server Details
The media memory layer for AI agents and their humans. Your AI client can search your collection, add and log what you've finished, update ratings and lists, and find patterns across everything you've read, watched, played, and listened to.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- Achriom
- Claude
- –
TDQS
Scored across 85 tools
There are many overlapping pathways: add vs add_item vs bulk_add_items vs add_to_list/add_to_shelf; remove vs delete_* vs clear_*; set vs update_status/update_rating/update_notes/set_progress; query vs search/search_library/get_by_status. The rich descriptions help in places, but the generic polymorphic add/remove/set tools sit alongside specific counterparts and force the agent to choose among multiple plausible tools.
Names are uniformly snake_case, but the verb conventions are mixed: add/create, set/update/edit, remove/delete/clear, plus generic names like add, remove, set, describe, and query. The broad pattern is readable, but it is not predictable enough to make tool selection reliable at this scale.
85 tools is an extreme surface for one MCP server, even for a feature-rich media-library app with public-page and taste features. Many operations could be consolidated behind fewer, better-scoped tools instead of exposing this many overlapping CRUD and convenience variants.
The surface covers the core lifecycle very thoroughly: library add/edit/delete/status/rating/notes/progress/dates, lists and shelves, events, challenges, public-page settings, search, discovery, recommendations, stats, taste/profile, and niche research/comics tools. No obvious core operation for the apparent domain is missing.
Publisher details
- Operator
- TMAI, LLC · Publisher source
- Operator website
- https://www.achriom.com
- Vendor relationship
- First-party
- Documentation
- https://achriom.com/mcp
- Privacy policy
- Not provided
- Trust center
- Unknown
- Restrictions
- Requires a free Achriom account (sign in with OAuth). No paid plan, admin approval or custom OAuth app needed.
Available Tools
85 toolsaddAdd to my libraryBInspect
Add something. what: library (a title; pass external_id from lookup_item for an exact match), list_entry (a title onto a list, creating the list if new), list (a new list), event (a finish or rewatch with a date), pin (a title pinned to their page, with a prompt), episode (episodes of a show watched), challenge (one of their challenges: name, starts_on, ends_on, prompts), challenge_pick (a title for a challenge prompt: challenge, prompt or slot_id, media_type, title or item_id), shelf (a shelf of their own for anything the kinds don't cover: name, template?, noun?, visibility?), shelf_entry (an entry on a shelf: shelf, title, creator?, status?, rating?, notes?, started?, finished?, image_url?), shelf_session (a session on a shelf entry: entry_id or shelf and title, day?, hours?, note?). describe topic collections shows the arguments for each.
Inputs: what (required), day, kind, line, +36 more.
add_itemAdd to libraryAIdempotentInspect
Add 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.
Inputs: title (required), media_type (required), year, format, +3 more.
add_to_listAdd to a listAIdempotentInspect
Add a library item to a list by title. Creates the list if it does not exist. The item must already be in the library (use add_item first if not).
Inputs: list_name (required), media_type (required), note, title, +1 more.
add_to_shelfAdd to a shelfAInspect
Add one entry (title and the rest at the top level) or many (entries, up to 100) to one of their shelves. Status takes want, active, done or dropped, or the shelf's own word for one ("Played"). image_url puts a picture on it from a public https link to an image.
Inputs: year, notes, shelf, title, +10 more.
bulk_add_itemsAdd items in bulkAIdempotentInspect
Add up to 250 items to the library in ONE call. Use this whenever the user provides a list of more than 3 items to add — never loop add_item. IMPORTANT: always pass year, and pass external_id whenever you know it. Without them each title is resolved by fuzzy text search, which silently picks the wrong version for any ambiguous title (Roma 1972 vs Roma 2018, remakes, reissues). A wrong match is expensive to undo, so resolve ids up front via lookup_item for anything ambiguous rather than adding bare titles. Returns honest counts: {added, skipped_duplicates, failed} plus a per-item result list. Always report the exact counts to the user; never claim success without reading them. Items are added with the default status; to set a different status on what you just added, call bulk_update_status with those exact titles in titles.
Inputs: items (required).
bulk_log_eventsLog events in bulkAInspect
Log finish or re-watch/re-read/re-listen events for many items in one call (max 250). Each entry takes media_type plus title or item_id, and optionally event_type, event_date (YYYY-MM-DD, YYYY-MM, or YYYY), rating, notes. An ambiguous title is skipped and reported, never guessed. Use for imports that carry finish dates.
Inputs: events (required).
bulk_update_statusUpdate status in bulkADestructiveIdempotentInspect
Update status for a specific list of items, named one by one in titles (exact titles, case-insensitive, max 250 per call). This tool can ONLY update items it is given by name; there is no way to update a whole library in one call, and no parameter will make one appear. For a library-wide change, fetch the titles first (get_by_status) and update them in explicit batches, telling the user what each batch touches. Returns matched/unmatched counts; unmatched titles need individual update_status calls.
Inputs: status (required), titles (required), media_type (required).
clear_promptClear a promptADestructiveIdempotentInspect
Take the picked title off a challenge prompt (the title stays in their library), or with remove: true take the prompt itself out of the challenge.
Inputs: prompt, remove, slot_id, challenge, +1 more.
clear_ratingClear a ratingADestructiveIdempotentInspect
Remove the user rating from one library item, leaving it unrated. The undo for update_rating.
Inputs: media_type (required), title, item_id.
create_listCreate a listAInspect
Create a named list. Lists are private, cross-media collections the user curates ("Halloween marathon", "Beach house"). Items from any media type can go on one list.
Inputs: name (required), description.
create_shelfMake a shelfAInspect
Make a shelf of their own for something the library's kinds don't cover (board games, perfumes, concerts, wine, LEGO, plants). Start from a template for its status words and fields, or name it and pick its words. Offer one when they want to keep track of such things; add entries with add_to_shelf.
Inputs: name, noun, emoji, words, +5 more.
delete_challengeDelete a challengeADestructiveIdempotentInspect
Delete one of their challenges and its prompts. The titles stay in their library. Only when they ask to delete the challenge itself.
Inputs: challenge, challenge_id.
delete_eventDelete a logged eventADestructiveIdempotentInspect
Delete a logged finish/re-watch/re-read event on one item. The undo for log_event. With no event_date, event_id, or all, and more than one event on the item, nothing is deleted and the events are listed with their ids.
Inputs: media_type (required), all, title, item_id, +2 more.
delete_itemRemove from libraryCDestructiveIdempotentInspect
Delete an item from the library.
Inputs: media_type (required), title, item_id.
delete_listDelete a listADestructiveIdempotentInspect
Delete one of the user's lists. Everything on it stays in the library. Only when the user asks to delete the list itself.
Inputs: list_name (required).
delete_reviewDelete a reviewADestructiveIdempotentInspect
Delete the user's review of one item (it also comes off their public page). Their rating and notes are untouched.
Inputs: media_type (required), title, item_id.
delete_shelfDelete a shelfADestructiveIdempotentInspect
Delete one of their shelves with every entry, session and picture on it. Only when they ask to delete the shelf itself. Without confirm it changes nothing and says what would go; call again with confirm: true once they have said yes.
Inputs: shelf, confirm, shelf_id.
describeWhat can be read and changedARead-onlyIdempotentInspect
What can be read and changed: the me.* views with their columns, every field set can change (with allowed values), and what add and remove act on. Read it once before your first query or set.
Inputs: topic, media_type.
edit_itemEdit item detailsADestructiveIdempotentInspect
Correct an item in THIS user's library. new_title/new_creator save a personal override visible only to them; the shared catalog entry is untouched. fields sets any other detail the app's edit form allows, also as a personal override (book: title, author, summary, genres, cover_url; movie: title, director, cast_members, poster_url, backdrop_url, release_date, runtime_minutes, plot, genres; show: title, creator, cast_members, poster_url, backdrop_url, first_air_date, last_air_date, plot, genres, networks; album: title, artist, cover_url, release_date, total_tracks, duration_minutes, genres, label; anime: title, title_english, description, genres, studios, cover_url, banner_url; and the equivalents for podcasts, games and manga). Dates are YYYY-MM-DD, lists are arrays, images are https links, null puts a field back to the catalog's value. new_external_id relinks the item to a different catalog entry, which is the correct fix when the wrong film/show/album was added (re_enrich cannot fix a wrong match, it only refetches the same entry). Errors if no change field is supplied.
Inputs: media_type (required), title, fields, item_id, +3 more.
edit_shelfEdit a shelfBDestructiveIdempotentInspect
Change one of their shelves: rename it, its noun, emoji, what "by" means, its status words, its fields, sessions on or off, or who sees it (public on their page, or private). Change visibility only when they ask.
Inputs: noun, emoji, shelf, words, +6 more.
edit_shelf_entryEdit a shelf entryADestructiveIdempotentInspect
Change one entry on their shelves: its title (new_title), creator, year, status, rating (null clears), notes, dates, fields, privacy or picture (image_url; empty removes it). Find it by entry_id, or by title (with shelf when two shelves have it).
Inputs: year, notes, shelf, title, +11 more.
expand_research_scopeSet research scopeAIdempotentInspect
Add an item to the current research corpus (focused research mode only).
Inputs: title (required), media_type (required).
explore_comicsExplore comicsARead-onlyIdempotentInspect
Comics beyond their shelf, from Metron (the comics database behind media_type "comic"). action "issue": one issue of a series on their shelf in full (stories, credits by role, story arc with its id, characters, variant covers, collected editions, their read). "creator" / "character" / "arc": by name or Metron id, their bio and the issues they are in, each marked against the shelf (series theirs, issue read and when); an arc lists its issues in reading order and the series not on their shelf. "this_week": new comics out this week (or the week of date), their pull list first. "reading_orders": search Metron's community reading orders by name; "reading_order": one in order with what they have read, what is next, and the series they are missing. Missing series come with metron ids for add_item. To log reading, use set_progress (media_type "comic", issue, through).
Inputs: action (required), id, date, name, +3 more.
get_by_ratingList by ratingARead-onlyIdempotentInspect
Get items filtered by user rating range. Leave out media_type to get every kind in one call (best for questions across their whole library).
Inputs: max_rating, media_type, min_rating. Returns: Items from the user's own library matching the request.
get_by_statusList by statusARead-onlyIdempotentInspect
Get items filtered by status. Books: unread, reading, finished, abandoned. Movies/shows: unwatched, watching, watched, abandoned. Anime: plan_to_watch, watching, completed, saved, on_hold, dropped (the movie words also work). Albums: unheard, listening, played, saved. Podcasts: want_to_listen, listening, caught_up, dropped. Games: unplayed, playing, played, saved, on_hold, abandoned. Pass status "all" for any media type to return items regardless of status.
Inputs: status (required), media_type (required), limit. Returns: Items from the user's own library matching the request.
get_chartsGet popularity chartsARead-onlyIdempotentInspect
Popularity charts: the most popular movies, shows, anime, books, games, albums or manga this month, this year, of the past 5 years, of the decade or of all time, plus the most popular movie and book series, directors and authors. Counted from TMDB ratings, AniList members, IGDB ratings, Open Library reading logs and Apple Music's chart, or by how many Achriom libraries keep a title; these are not sales figures. Titles already in their library are marked. Use it when they ask what is popular, a best-of or a top list, or what is big right now.
Inputs: media_type (required), view, limit, source, +1 more.
get_contextGet library contextARead-onlyIdempotentInspect
Summarise the user's Achriom library for pitching a conversation: item counts per media type, days since they last added something, a stage (empty, starting, building, established), and their taste signals. Reads only their Achriom library.
Inputs: no named parameters.
get_detailsGet item detailsARead-onlyIdempotentInspect
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.
Inputs: media_type (required), title, item_id. Returns: Full detail for one item in the user's library, including AI analysis.
get_listGet a listARead-onlyIdempotentInspect
Show the user's lists. With a name: that list's items in order. Without: all lists with counts.
Inputs: name.
get_my_pageRead my pageARead-onlyIdempotentInspect
Read how the user's public Achriom page is set up: its address, style (background, headings, section look, color), their headline, Currently lines, rating names, My 9s, pins with prompts, and which sections are switched off. Read this before changing the page.
Inputs: no named parameters.
get_recently_addedList recently addedARead-onlyIdempotentInspect
List items by when they were ADDED to the library (newest first). Use for "show me the last N things I added", "my last 8 vinyl records", "what did I add recently". This is addition order — different from get_timeline, which orders by reading/watching dates. Returns title, creator, media_type, status, rating, and when each was added.
Inputs: limit, media_type.
get_recommendationsGet recommendationsARead-onlyIdempotentInspect
What people with overlapping taste also liked, drawn from other Achriom libraries in aggregate (never anyone's individual list). With no arguments: picks across all media based on everything the user has rated 4+ or finished, each with the titles that drove it. With based_on or item_id: "people who liked X also liked", seeded from something the user owns. Excludes what they already have. Each pick carries an external_id ready for add_item.
Inputs: limit, item_id, based_on, media_type.
get_scope_infoGet research scopeCRead-onlyIdempotentInspect
Get information about the current research scope.
Inputs: no named parameters.
get_shelvesRead my shelvesARead-onlyIdempotentInspect
Their shelves of their own (board games, perfumes, concerts, wine: anything the library's kinds don't cover). Without arguments: every shelf with its count. With shelf: that shelf's settings (status words, fields) and its entries. With entry_id (or title): one entry in full, with its notes, fields, picture and logged sessions.
Inputs: sort, shelf, title, entry_id, +1 more.
get_show_progressGet show progressARead-onlyIdempotentInspect
Read a TV show's season-by-season watch progress and the next unwatched episode ("up next").
Inputs: title, item_id.
get_signalsGet taste signalsBRead-onlyIdempotentInspect
Get behavioral signals: theme repetition, consumption gaps, and recent activity.
Inputs: no named parameters.
get_statsGet library statsARead-onlyIdempotentInspect
Get collection statistics including progress, rating distribution, genre/theme breakdown, and timeline. If no media_type specified, returns combined stats.
Inputs: media_type. Returns: Aggregate statistics for the user's collection.
get_tasteGet their taste in briefARead-onlyIdempotentInspect
Who this person is, in brief, from what they chose to read, watch, listen to and play: what they loved, the creators they return to, the genres they lean toward, what they are in the middle of, what they finished lately and what did not land, plus their Taste Portrait's essence and preoccupations when they have one. Call it once, early, in any conversation where knowing them would change your answer, including ones that are not about media: advice, planning, a gift, a trip, learning something, writing, an idea they are working through. One call, queries only, no generation, so it is fast. Not needed for quick factual questions or for looking up one title (use search or get_details). Let it shape your answer; do not read it back to them as a list.
Inputs: media_types.
get_taste_portraitGet Taste PortraitARead-onlyIdempotentInspect
Get the user's full Taste Portrait: their generated archetype, essence, core tension, preoccupations, the recommendation they don't own yet, and their blind spot. A compact version is already in your context; call this to go deeper when they ask about their portrait. Unlocks at 10 items; below that it returns how many more they need.
Inputs: no named parameters.
get_timelineGet history timelineBRead-onlyIdempotentInspect
Get timeline showing items started and finished over time. Leave out media_type to get every kind in one call.
Inputs: media_type.
get_track_previewsGet track previewsARead-onlyIdempotentInspect
Get playable 30-second audio previews for tracks from an album IN THE USER'S LIBRARY.
Inputs: album_title (required), max_tracks, track_numbers. Returns: Album track list with 30-second preview URLs where available.
get_user_profileGet taste profileARead-onlyIdempotentInspect
Read the taste profile Achriom keeps for this user: taste patterns, key facts, cross-media connections and preferences, gathered from their chats with the Achriom librarian and from save_insight. Achriom data only; it does not read Claude's or any other assistant's memory or history.
Inputs: no named parameters.
keep_challengeKeep a challengeADestructiveIdempotentInspect
Keep a reading (or watching, playing...) challenge in Achriom: its dates, its prompts ("an anthology", "an audiobook"), and an optional count ("30 books"). Makes it when no challenge has that name, otherwise changes it. Offer this when they mention a challenge they are doing; pick titles for its prompts with pick_for_prompt. Progress is shown as what is read and picked, never as behind or ahead.
Inputs: kind, rename, target, ends_on, +6 more.
log_eventLog a finish or repeatAInspect
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.
Inputs: media_type (required), notes, title, rating, +3 more.
log_shelf_sessionLog a sessionBDestructiveInspect
Log a session on a shelf entry: a day, how long, and a line ("played Wingspan for two hours last night", "session 12 of our campaign"). A session on something they only wanted moves it to under way.
Inputs: day, note, hours, shelf, +3 more.
lookup_itemLook up a titleARead-onlyIdempotentInspect
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=TMDB, Shows=TVDB (falls back to TMDB), Albums=Discogs, Anime=AniList, Games=IGDB. Use anime (not show) for Japanese animation.
Inputs: title (required), media_type (required), year, creator. Returns: Candidate matches from external catalogs, with external_id for exact adds.
mark_tv_watchedMark episodes watchedADestructiveIdempotentInspect
Mark TV progress. Give season+episode to mark that episode; add through=true to mark everything up to it; give season only to mark the whole season; give neither to mark the whole show. Set watched=false to unmark.
Inputs: title, season, episode, item_id, +2 more.
pick_for_promptPick for a promptADestructiveIdempotentInspect
Pick a title from their library for one of a challenge's prompts (replacing an earlier pick). It counts as read once they finish it inside the challenge's dates. Without a prompt, it fills the next open one, or adds a free pick (for a count challenge). If the title is not in their library yet, add it first.
Inputs: title, prompt, item_id, slot_id, +3 more.
pin_to_pagePin to my pageAIdempotentInspect
Pin one of the user's titles to the top of their public page (up to 3 pins), optionally answering a prompt ("The one I'd save in a fire", or their own) and with a short line. On a title already pinned, changes its prompt or line.
Inputs: media_type (required), line, title, prompt, +1 more.
preview_albumPreview an albumARead-onlyIdempotentInspect
Preview any album from Apple Music WITHOUT adding to library. Use this to sample before committing to add. Returns playable 30-second previews.
Inputs: title (required), artist (required), max_tracks. Returns: Album track list with 30-second preview URLs where available.
queryQuery my libraryARead-onlyIdempotentInspect
Read anything in the user's own Achriom data with one SQL SELECT over the me.* views. me.items has every title of every kind: kind, id, title, creator, year, status, rating (stars 0.5-5), notes, priority, started, finished, added, genres. me.books/movies/albums/shows/anime/podcasts/games/manga have the same columns plus that kind's own (page_count, runtime_minutes, platform, hours_played, episodes_watched...). Also me.events (history: kind, item_id, event_type, event_date, rating), me.show_episodes, me.lists, me.list_items, me.reviews, me.hidden, me.page, me.pins, me.nines, me.favorites_on_page, me.challenges, me.challenge_slots (each prompt, its pick, and read_on: the day it was read inside the challenge's dates). Read-only, their rows only, up to 200 rows, 3 seconds. describe lists every column. Prefer this for any question about their library ("albums I rated 4+ but never finished", "what I finished each month this year").
Inputs: sql (required).
random_pickPick something at randomCRead-onlyIdempotentInspect
Pick random item(s) for serendipitous discovery.
Inputs: media_type (required), count, filter.
read_book_sectionRead a book passageARead-onlyIdempotentInspect
Read a specific section of an uploaded book by line numbers.
Inputs: end_line (required), book_title (required), start_line (required).
re_enrichRefresh metadataADestructiveInspect
Re-fetch metadata from external sources for an item whose data is incomplete. This re-runs the SAME external lookup, so it will return the same result as before: it does NOT fix a wrong match. If the item is the wrong film/show/album entirely, use edit_item with new_external_id to relink it, which is the only thing that changes which entry is fetched.
Inputs: media_type (required), title, item_id.
rememberRemember what they read, watched or playedADestructiveInspect
Save something the person just told you about their own reading, watching, listening or playing, in one call: "just finished Severance, loved it", "started Dune", "gave up on that podcast", "rewatched Heat last night", "want to read Piranesi". Finds the title in their library (exact title, or item_id) or adds it, then sets what happened, the date and the rating. Use it for the person's own activity, not for titles you are only discussing or recommending. Afterwards tell them in a few words what you saved.
Inputs: happened (required), media_type (required), date, note, +6 more.
removeRemove from my libraryADestructiveIdempotentInspect
Remove something. what: library (a title from their library: needs media_type and item_id, from query), list_entry (a title from a list), list (a whole list; its titles stay), event (one history entry: event_id or event_date, or all), pin (off their page), episode (mark episodes unwatched), challenge (a whole challenge: name; its titles stay), challenge_pick (the title off a challenge prompt: challenge, prompt or slot_id), shelf (a whole shelf with its entries: name, and confirm: true once they said yes), shelf_entry (an entry off a shelf: entry_id, or shelf and title). Confirm with the user before removing a title, a list or a shelf.
Inputs: what (required), all, list, name, +14 more.
remove_from_listRemove from a listADestructiveIdempotentInspect
Remove an item from a list by title, or exactly by media_type + item_id. The item stays in the library.
Inputs: list_name (required), title, item_id, media_type.
remove_from_shelfRemove from a shelfADestructiveIdempotentInspect
Take one entry off their shelf, with its sessions and picture. Only when they ask to remove it.
Inputs: shelf, title, entry_id, shelf_id.
save_insightSave an insightAInspect
Save one insight to the user's Achriom taste profile (read back by get_user_profile): a taste pattern, a fact about them, a cross-media connection, or a preference. Use only when the user asks you to remember or note something, or agrees when you offer to; do not save things they have not chosen to keep.
Inputs: insight (required), category (required).
searchSearch your libraryARead-onlyIdempotentInspect
Search the USER'S COLLECTION by title, creator, genre, or theme. Literal keyword match only - the query must actually appear in the item's title/creator/genre/theme text, or it returns nothing. 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. For generic, thematic, mood, or conceptual queries (e.g. "something about grief", "a film podcast") where the exact wording may not appear in any field, use search_library instead - it searches by meaning, not keyword.
Inputs: query (required), media_type (required), filter. Returns: Items from the user's own library matching the request.
search_book_contentSearch inside booksARead-onlyIdempotentInspect
Semantic search within an uploaded book (EPUB/PDF). Uses AI embeddings to find relevant passages.
Inputs: query (required), book_title (required), limit.
search_conversationsSearch past Achriom chatsARead-onlyIdempotentInspect
Search the user's past chats with the Achriom librarian inside the Achriom app, by meaning as well as keywords. It does not search Claude's or any other assistant's chat history.
Inputs: query (required), limit.
search_librarySearch library by meaningARead-onlyIdempotentInspect
Search their library by meaning rather than keywords, across every kind at once (or one, with media_type). Use it for thematic or mood questions ("things about grief", "noir mood"), and to find what this person has already read, watched or listened to around the topic you are discussing, whatever the topic is: the books behind an idea they are working through, a movie that bears on a trip. Not for a specific title or creator (use the keyword search tool) and not for counts or filters (use query). Returns up to limit matches (default 10), best first: ordered by similarity, with a small, bounded lift for titles they rated highly, finished, favorited or wrote notes on. Each match has its title, kind, creator and similarity percentage; their own rating, status, finished date and favorite where they exist; a short excerpt of their notes when they wrote any; and a line of its themes.
Inputs: query (required), limit, media_type, min_similarity.
search_youtubeSearch YouTubeBRead-onlyIdempotentInspect
Search YouTube for relevant videos (interviews, trailers, analysis, music videos).
Inputs: query (required), max_results. Returns: Relevant public videos for the query.
setChange fieldsADestructiveIdempotentInspect
Change named fields in one call. target item: one title in their library (media_type plus item_id or exact title), fields like status, rating (stars, null clears), notes, priority, started, finished, favorite, hidden, review, progress, format. target page: their public page, fields like style.background, style.headings, headline, currently.reading, rating_names, sections.guestbook, my9.movie, favorites.book. target list: one list by name, fields name, description, visibility, entry. target shelf: one of their shelves by name (shelf), fields name, noun, emoji, by_label, visibility, tracks_sessions, words.done, fields. target shelf_entry: one shelf entry (entry_id), fields title, creator, year, status, rating, notes, started, finished, private, image, field.. target event: one history entry (event_id, from me.events), field note (their words on that one finish, rewatch or play; empty clears). Every field is checked before anything is written. describe lists them all.
Inputs: fields (required), target (required), list, shelf, +5 more.
set_currentlySet CurrentlyADestructiveIdempotentInspect
Set lines of the user's "Currently" box beside their bio (mood, reading, watching, listening, playing), dated, in their words. Lines not passed stay as they are; an empty string clears one; clear: true empties the box. Up to 60 characters a line.
Inputs: mood, clear, playing, reading, +2 more.
set_datesSet datesADestructiveIdempotentInspect
Set or clear the dates on one library item: started_at, finished_at, added_at. Each accepts YYYY-MM-DD, YYYY-MM, or YYYY (a year-only finish is kept as a year, not turned into January 1st), or "none" to clear. Use for imported histories that only carry years, and to fix a wrong date.
Inputs: media_type (required), title, item_id, added_at, +2 more.
set_favoriteMark a favoriteADestructiveIdempotentInspect
Mark or unmark one library item as a favorite (the heart in the app). Favorites are kept on the user's favorites list, created if they have none.
Inputs: favorite (required), media_type (required), title, item_id.
set_formatSet formatADestructiveIdempotentInspect
Record how the user has or consumes an item, and whether they want to own it. Ownership is separate from status: never change a status because of it. Books (the default media_type): format = how they read it (print, ebook, audiobook or ereader); formats = the copies they own (Hardcover, Paperback, Ebook, Audiobook) with an optional edition. Games: format = physical or digital, platforms (every one they have or play it on), hours_played, and/or full_completion (100% done). Movies, shows, anime and albums: the copies they own, as formats (movie/show/anime: 4K UHD, Blu-ray, DVD, VHS, LaserDisc, Digital; album: Vinyl, CD, Cassette, Digital), stores for a Digital copy (movie/show: Apple TV, Prime Video, Movies Anywhere, Google TV / YouTube, Fandango at Home, Microsoft Store; anime adds Crunchyroll Store; album: Bandcamp, iTunes, Amazon Music, Qobuz, 7digital) and an edition note. formats and stores replace the saved lists; an empty list clears them. Any kind: want_to_own true/false ("Want to own"), optionally want_formats from that kind's formats (games: Physical, Digital); adding an owned copy in a wanted format takes it off Want to own.
Inputs: title, format, stores, edition, +12 more.
set_headlineSet my headlineADestructiveIdempotentInspect
Set the user's own short line beside their handle on their public page, in their words (screened like a bio). An empty string clears it, and their taste archetype shows there again.
Inputs: headline (required).
set_my9Set my 9ADestructiveIdempotentInspect
Set the user's My 9 for one kind: the nine titles that made them, in order, from their own library, shown on their page and shareable as a poster. Replaces that 9; an empty list removes it.
Inputs: media_type (required), titles, item_ids.
set_page_sectionsShow or hide page sectionsADestructiveIdempotentInspect
Switch sections of the user's public page on or off. Names: pinned, my9, now, favorites, five_stars, lately, reviews, how_i_rate, lists, shelves, guestbook, taste_headline. Sections not named keep their setting.
Inputs: sections (required).
set_prioritySet priorityADestructiveIdempotentInspect
Set the priority of an item in the collection. High = want this next, normal = standard backlog, low = speculative or distant.
Inputs: priority (required), media_type (required), title, item_id.
set_profile_favoritesSet profile favoritesADestructiveIdempotentInspect
Choose the favorites shown for one media type on the user's public page, in order, up to 4, from their own library. Replaces the current choice; an empty list clears it.
Inputs: media_type (required), titles, item_ids.
set_progressSet progressADestructiveIdempotentInspect
Update how far the user is through an in-progress item. Books: current page, the page count of their copy, and/or a reading percentage (for audiobooks and e-readers). Shows: current season + episode. Anime: episodes watched. Manga: chapter and/or volume read up to. Comics: an issue read (issue), or every issue up to it (issue + through), on a day (read_on, default today).
Inputs: media_type (required), issue, title, volume, +10 more.
set_rating_namesName my ratingsADestructiveIdempotentInspect
Name ranges of the user's ratings in their own words and colors (e.g. "Loved it" from 4 stars), shown beside their ratings and on their page. Replaces all of them; an empty list turns them off. Ratings themselves are unchanged.
Inputs: tiers (required).
set_reviewWrite a reviewADestructiveIdempotentInspect
Write or replace the user's review of something they have finished. Private by default; visibility public puts it on their public page and on the title's page, after a community check. Only make it public when the user asks. Use update_notes for private jottings.
Inputs: body (required), media_type (required), title, item_id, +2 more.
show_itemShow an itemARead-onlyIdempotentInspect
Open one item from the user's library in Achriom. Use when they ask to see, open, go to or pull up an item. Returns a link to the item's page in the Achriom app (and opens it directly when the Achriom app itself is the client).
Inputs: media_type (required), title, item_id.
style_pageStyle my pageADestructiveIdempotentInspect
Change how the user's public page looks. Anything left out stays as it is. background: grid, dots, stars, checker, stripes, notebook, hearts, plain (or image, only after they have uploaded a picture in the app). headings: classic, typewriter, poster, handwritten, pixel, standard. sections_look: open, boxes, windows (old-style windows). color: cobalt, violet, rose, coral, amber, green, teal, sky, default.
Inputs: color, reset, headings, background, +1 more.
unpin_from_pageUnpin from my pageADestructiveIdempotentInspect
Take one of the user's pinned titles off the top of their public page. The title stays in their library.
Inputs: media_type (required), title, item_id.
update_listEdit a listADestructiveIdempotentInspect
Change a list: rename it (new_name), set or clear its description, set who can see it (visibility: private, link = anyone with the share link, public = also on the user's public page), and edit one entry's note or position. Only change visibility when the user asks; public list names and descriptions are checked before they go on the public page.
Inputs: list_name (required), item, new_name, visibility, +1 more.
update_notesUpdate notesCDestructiveIdempotentInspect
Add or update personal notes for an item.
Inputs: notes (required), media_type (required), title, item_id.
update_ratingRate an itemCDestructiveIdempotentInspect
Set or update user rating in stars, 0.05 to 5.0 in steps of 0.05: half stars (e.g. 3.5), or a score out of ten divided by two (7.5/10 is 3.75).
Inputs: rating (required), media_type (required), title, season, +2 more.
update_statusUpdate statusBDestructiveIdempotentInspect
Update status. Books: unread, reading, finished, abandoned. Movies/shows: unwatched, watching, watched, abandoned. Anime: plan_to_watch, watching, completed, saved, on_hold, dropped (the movie words also work). Albums: unheard, listening, played, saved. Games: unplayed, playing, played, saved, on_hold, abandoned.
Inputs: status (required), media_type (required), title, item_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
A self-improving memory layer. Your memory, notes, tasks and goals, remembered everywhere.
Universal memory for AI agents and tools. Save, organize and search context anywhere.
A second brain for your AI agent. Shared memory for your team's AI agents, plus public and private knowledge bases — works with ChatGPT, Claude, Cursor and any MCP client.
Memory for your AI: what you saw on screen, said in calls and worked on, searchable by agents.
Related MCP Servers
- AlicenseBqualityAmaintenanceYour portable AI memory layer. Classify, store, and recall what matters across models, tools, and devices.319MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI clients like Claude, ChatGPT, and Cursor to search, read, and write back to one cross-model Markdown library of saved articles, videos, PDFs, notes, and conversations. Hosted remote server with OAuth 2.1 or Agent-key auth and read_only, edit, or full permission tiers.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to capture, classify, promote, synthesize, and retrieve persistent knowledge from sources such as Obsidian vaults, code repos, YouTube transcripts, bookmarks, terminal sessions, and bug fixes. Exposes tiered cold/warm/hot memory with token-optimized search, context briefings, and cross-source synthesis so multiple agents share one compounding brain across sessions.10 npmMIT
- AlicenseNot gradedqualityBmaintenanceAggregates a person's watched videos, listened tracks, likes, bookmarks and follows across dozens of services into their own Cloudflare deployment, so an AI agent can search those records, compute long-term and recent taste profiles, find similar items, and keep notes backed by evidence. It is self-hosted, owner-only, and designed for personal assistants rather than coding tasks.AGPL 3.0
Glama MCP Gateway
Add one secure layer between your agents and this server.