// MCP TOOL REFERENCE

ACHRIOM TOOLS

33 tools from the Achriom MCP Server, categorised by risk level.

View the Achriom policy → Token cost: 3,941 tokens →

// ALL 33 ACHRIOM TOOLS

READ 21 tools

Read get_by_rating Get items filtered by user rating range. Read get_by_status Get items filtered by status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, w... Read get_context Get user context for adaptive conversation. Returns lifecycle stage and behavioral signals. Read get_details Get FULL details of an item FROM THE USER'S COLLECTION including AI analysis, user notes, rating, timeline,... Read get_scope_info Get information about the current research scope. Read get_signals Get behavioral signals: theme repetition, consumption gaps, and recent activity. Read get_stats Get collection statistics including progress, rating distribution, genre/theme breakdown, and timeline. If ... Read get_timeline Get timeline showing items started and finished over time. Read get_track_previews Get playable 30-second audio previews for tracks from an album IN THE USER'S LIBRARY. Read get_user_profile Get the persistent profile built from past conversations. Shows taste patterns, key facts, cross-media conn... Read log_event Log a completion or a re-watch/re-read/re-listen with a date. Use when the user mentions finishing somethin... Read lookup_item Search EXTERNAL databases (NOT the user's collection) to find items BEFORE adding them. Use search/get_deta... Read random_pick Pick random item(s) for serendipitous discovery. Read re_enrich Re-fetch all metadata from external sources. Use when item has wrong data. Read read_book_section Read a specific section of an uploaded book by line numbers. Read search Search the USER'S COLLECTION by title, creator, genre, or theme. Returns items they own with status, rating... Read search_book_content Semantic search within an uploaded book (EPUB/PDF). Uses AI embeddings to find relevant passages. Read search_conversations Search past conversations with this user. Supports semantic search - finds conceptually related conversatio... Read search_library Semantic search across the user's entire library by meaning, theme, or vibe. Searches every book/movie/albu... Read search_youtube Search YouTube for relevant videos (interviews, trailers, analysis, music videos). Read show_item ALWAYS use this tool when users say "show me", "open", "go to", "take me to", or "pull up" an item. This na...

WRITE 11 tools

Write add_item Add a new item to the library. For best results, use lookup_item first to get the external_id. IMPORTANT: U... Write 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 i... Write bulk_update_status Update status for multiple items at once. Write edit_item Edit metadata (title, creator, external ID). Use new_external_id to re-link to correct database entry, then... Write expand_research_scope Add an item to the current research corpus (focused research mode only). Write preview_album Preview any album from Apple Music WITHOUT adding to library. Use this to sample before committing to add. ... Write save_insight Save a lasting insight about the user to their persistent profile. Use when you discover meaningful pattern... Write set_format Set how a book was read: print, ebook, audiobook, or ereader. Write update_notes Add or update personal notes for an item. Write update_rating Set or update user rating. Supports half-stars: 0.5 to 5.0 in 0.5 increments (e.g. 3.5). Write update_status Update status. Books: unread, reading, finished, abandoned. Movies/shows/anime: unwatched, watching, watche...

DESTRUCTIVE 1 tools

Destructive delete_item Delete an item from the library.

// FAQ

How many tools does the Achriom MCP server have? +

The Achriom MCP server exposes 33 tools across 3 categories: Read, Write, Destructive.

How do I enforce policies on Achriom tools? +

Route the Achriom server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Achriom tools fall into? +

Achriom tools are categorised as Read (21), Write (11), Destructive (1). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.