# Achriom

The media memory layer for AI agents and their humans. Your AI client gets 29 tools to search your collection, add items, update ratings, preview music, and find patterns across everything you've rea…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add achriom/achriom

# Browse available tools
npx -y @smithery/cli@latest tool list achriom/achriom

# Get full schema for a tool
npx -y @smithery/cli@latest tool get achriom/achriom search

# Call a tool
npx -y @smithery/cli@latest tool call achriom/achriom search '{}'
```

## Direct MCP Connection

Endpoint: `https://achriom--achriom.run.tools`

**Optional config:**
- `api_key` (query) — Your Achriom API key. Get from app.achriom.com/settings → Connect to AI Tools

## Tools (29)

- `search` — Search the USER'S COLLECTION by title, creator, genre, or theme. Returns items they own with status, ratings, and for b…
- `get_details` — Get FULL details of an item FROM THE USER'S COLLECTION including AI analysis, user notes, rating, timeline, and all met…
- `get_stats` — Get collection statistics including progress, rating distribution, genre/theme breakdown, and timeline. If no media_typ…
- `update_status` — Update status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, watched, abandoned…
- `update_rating` — Set or update user rating (1-5 stars).
- `update_notes` — Add or update personal notes for an item.
- `get_by_rating` — Get items filtered by user rating range.
- `get_by_status` — Get items filtered by status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, wat…
- `get_timeline` — Get timeline showing items started and finished over time.
- `edit_item` — Edit metadata (title, creator, external ID). Use new_external_id to re-link to correct database entry, then call re_enr…
- `lookup_item` — Search EXTERNAL databases (NOT the user's collection) to find items BEFORE adding them. Use search/get_details for item…
- `add_item` — Add a new item to the library. For best results, use lookup_item first to get the external_id. IMPORTANT: Use anime (no…
- `delete_item` — Delete an item from the library.
- `re_enrich` — Re-fetch all metadata from external sources. Use when item has wrong data.
- `search_youtube` — Search YouTube for relevant videos (interviews, trailers, analysis, music videos).
- `get_track_previews` — Get playable 30-second audio previews for tracks from an album IN THE USER'S LIBRARY.
- `preview_album` — Preview any album from Apple Music WITHOUT adding to library. Use this to sample before committing to add. Returns play…
- `search_book_content` — Semantic search within an uploaded book (EPUB/PDF). Uses AI embeddings to find relevant passages.
- `read_book_section` — Read a specific section of an uploaded book by line numbers.
- `bulk_update_status` — Update status for multiple items at once.
- `random_pick` — Pick random item(s) for serendipitous discovery.
- `expand_research_scope` — Add an item to the current research corpus (focused research mode only).
- `get_scope_info` — Get information about the current research scope.
- `get_context` — Get user context for adaptive conversation. Returns lifecycle stage and behavioral signals.
- `get_signals` — Get behavioral signals: theme repetition, consumption gaps, and recent activity.
- `search_conversations` — Search past conversations with this user. Supports semantic search - finds conceptually related conversations, not just…
- `save_insight` — Save a lasting insight about the user to their persistent profile. Use when you discover meaningful patterns, preferenc…
- `get_user_profile` — Get the persistent profile built from past conversations. Shows taste patterns, key facts, cross-media connections, and…
- `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…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get achriom/achriom <tool-name>
```

## Resources

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

## Prompts (10)

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