# Achriom MCP server

The media memory layer for AI agents and their humans. Books, movies, music, shows, and anime.

## Links
- Registry page: https://www.getdrio.com/mcp/com-achriom-achriom
- Repository: https://github.com/achriom/achriom-mcp
- Website: https://www.achriom.com/mcp

## Install
- Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- Auth: Not captured

## Setup notes
- Remote URL variable: api_key (secret)
- Remote endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- URL variable: api_key

## Tools
- search - 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. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- get_details - 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. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- get_stats - Get collection statistics including progress, rating distribution, genre/theme breakdown, and timeline. If no media_type specified, returns combined stats. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- update_status - Update status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, watched, abandoned. Albums: unheard, listening, played, saved. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- update_rating - Set or update user rating (1-5 stars). Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- update_notes - Add or update personal notes for an item. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- get_by_rating - Get items filtered by user rating range. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- get_by_status - Get items filtered by status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, watched, abandoned. Albums: unheard, listening, played, saved. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- get_timeline - Get timeline showing items started and finished over time. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- edit_item - 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. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- lookup_item - 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. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- add_item - 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. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- delete_item - Delete an item from the library. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- re_enrich - Re-fetch all metadata from external sources. Use when item has wrong data. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- search_youtube - Search YouTube for relevant videos (interviews, trailers, analysis, music videos). Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- get_track_previews - Get playable 30-second audio previews for tracks from an album IN THE USER'S LIBRARY. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- preview_album - Preview any album from Apple Music WITHOUT adding to library. Use this to sample before committing to add. Returns playable 30-second previews. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- search_book_content - Semantic search within an uploaded book (EPUB/PDF). Uses AI embeddings to find relevant passages. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- search_library - 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. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- read_book_section - Read a specific section of an uploaded book by line numbers. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- bulk_update_status - Update status for multiple items at once. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- bulk_add_items - 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. 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. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- random_pick - Pick random item(s) for serendipitous discovery. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- expand_research_scope - Add an item to the current research corpus (focused research mode only). Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- get_scope_info - Get information about the current research scope. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- get_context - Get user context for adaptive conversation. Returns lifecycle stage and behavioral signals. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- get_signals - Get behavioral signals: theme repetition, consumption gaps, and recent activity. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- search_conversations - Search past conversations with this user. Supports semantic search - finds conceptually related conversations, not just keyword matches. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- save_insight - 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. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- get_user_profile - Get the persistent profile built from past conversations. Shows taste patterns, key facts, cross-media connections, and preferences. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}
- show_item - 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. Endpoint: https://mcp.achriom.com/mcp?api_key={api_key}

## Resources
- https://api.achriom.com/widgets/library-grid.html - Displays a grid of media items with covers, titles, and ratings MIME type: text/html;profile=mcp-app
- https://api.achriom.com/widgets/item-detail.html - Displays detailed information about a single media item MIME type: text/html;profile=mcp-app
- https://api.achriom.com/widgets/item-preview.html - Compact preview card for a media item with action buttons MIME type: text/html;profile=mcp-app
- https://api.achriom.com/widgets/stats-card.html - Displays collection statistics with visual charts MIME type: text/html;profile=mcp-app
- https://api.achriom.com/widgets/lookup-results.html - Displays search results from external databases for disambiguation MIME type: text/html;profile=mcp-app
- https://api.achriom.com/widgets/youtube-results.html - Displays YouTube video search results with embedded players MIME type: text/html;profile=mcp-app
- https://api.achriom.com/widgets/track-previews.html - Displays playable 30-second audio previews from Apple Music MIME type: text/html;profile=mcp-app

## Prompts
- librarian - Core librarian persona. Activates warm, insightful engagement with media collections. Proactive discovery, demonstrates rather than describes.
- book-analysis - Deep literary analysis. Explores themes, author intent, historical context, and connections between books. Arguments: title
- movie-analysis - Film analysis methodology. Cinematography, director style, themes, performances, and film history. Arguments: title
- music-analysis - Album and artist discussion. Musical style, production, artist evolution, lyrics, and cultural impact. Always plays tracks. Arguments: title
- show-analysis - TV series analysis. Show structure, character arcs, seasonal evolution, and long-form storytelling. Arguments: title
- anime-analysis - Animation-specific analysis. Studio style, sakuga moments, adaptation fidelity, Japanese cultural context. Arguments: title
- recommendations - Cross-media recommendations. Mines collection first, bridges across media types by mood and theme. Arguments: mood, media_type
- collection-insights - Pattern recognition across the full collection. Analyzes taste, finds connections, identifies gaps.
- focused-research - Deep analysis mode for a curated subset. Contained universe, no contamination from outside collection. Arguments: scope
- stop-slop - Writing quality filter. Eliminates AI patterns: no throat-clearing, no false drama, no manufactured profundity. Apply to all responses.

## Metadata
- Owner: com.achriom
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Apr 15, 2026
- Source: https://registry.modelcontextprotocol.io