Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEBUG | No | Set to true for debug logging to stderr. | |
| MCP_HOST | No | Host for HTTP transport. Default: localhost. | localhost |
| MCP_PORT | No | Port for HTTP transport. Default: 3000. | 3000 |
| ANILIST_NSFW | No | Set to true to include adult content in results. Default: false. | false |
| ANILIST_TOKEN | No | AniList OAuth token. Required for write operations and private lists. | |
| MCP_TRANSPORT | No | Set to http for HTTP Stream transport. Default: stdio. | stdio |
| ANILIST_USERNAME | No | Default username for list and stats tools. Can also pass per-call. | |
| ANILIST_MOOD_CONFIG | No | JSON object to add or override mood keywords. Mapping of mood keywords to boost/penalize arrays of genres and tags. | |
| ANILIST_SCORE_FORMAT | No | Override score display: POINT_100, POINT_10_DECIMAL, POINT_10, POINT_5, POINT_3. | |
| ANILIST_TITLE_LANGUAGE | No | Title preference: english (default), romaji, or native. | english |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
| logging | {} |
| prompts | {} |
| resources | {} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| anilist_search | Search for anime or manga by title with optional filters. Use when the user wants to find an anime/manga by name, discover titles in a genre, or find what aired in a specific year. Supports common abbreviations (aot, jjk, csm). Returns ranked list with title, format, year, score, genres, episode count, studios, and AniList URL. |
| anilist_details | Get full details about a specific anime or manga. Use when the user asks about a specific title and wants synopsis, score, episodes, studios, related works, and recommendations. Accepts AniList ID (faster, exact) or title (fuzzy match with abbreviation support). Returns format, status, episodes/chapters, season, score, studios, source, genres, tags, synopsis, related works, and community recommendations. |
| anilist_seasonal | Browse anime airing in a given season. Use when the user asks what's airing this season, what aired in a past season, or wants to discover seasonal anime. Defaults to current season/year. Returns ranked list with title, format, score, genres, and episode count. |
| anilist_recommendations | Get community recommendations for a specific anime or manga. Use when the user asks for shows similar to a specific title, or says "I liked X, what else should I watch?" Returns titles ranked by recommendation count with format, score, and genres. |
| anilist_list | Get a user's anime or manga list, filtered by watching status. Use when the user asks about their list, what they're watching, what they've completed, or what's on their plan-to-watch. Supports custom lists via status CUSTOM. Returns entries with title, score, progress, status, updated date, and entry ID. |
| anilist_stats | Get a user's watching/reading statistics. Use when the user asks about their overall stats, how much anime they've watched, their average score, top genres, or score distribution. Returns title count, mean score, episodes/chapters, top genres, score distribution chart, and format breakdown. |
| anilist_taste | Generate a taste profile summary from a user's completed list. Use when the user asks about their anime/manga preferences, what genres they like, or how they tend to score. Returns genre weights, top themes, scoring patterns with distribution chart, and format split. |
| anilist_pick | "What should I watch/read next?" Recommends from your Planning list based on your taste profile. Also works for backlog analysis - "which of my 200 Planning titles should I actually start?" Falls back to top-rated AniList titles if the Planning list is empty. Optionally filter by mood or max episodes. Returns ranked picks with match score, genre alignment, and mood fit. |
| anilist_session | Plan a watching or reading session within a time budget. Picks from your currently-watching list, scored by taste match and mood. Returns a session plan with titles, episodes to watch, and estimated time. |
| anilist_sequels | Find sequels airing this season for titles you've completed. Use when the user asks what sequels are coming, or wants to know if any currently airing anime continue shows they've already watched. Returns matches with the completed prequel and the airing sequel. |
| anilist_watch_order | Suggested viewing order for a franchise. Use when the user asks what order to watch a series, how to start a long franchise, or wants to know the chronological release order of sequels and prequels. Accepts any title in the franchise and traces the full chain. Returns a numbered list from first to last. |
| anilist_compare | Compare taste profiles between two AniList users. Use when someone asks to compare their taste with another user. Returns compatibility %, shared favorites, biggest disagreements, genre divergences, and cross-recommendations. |
| anilist_wrapped | Year-in-review summary for a user. Use when the user asks about their anime/manga year, what they watched/read in a given year, or wants a recap. Defaults to the current year. Returns title count, average score, highest rated, most controversial, genre breakdown, and consumption stats. |
| anilist_explain | Score a specific title against a user's taste profile and explain the alignment. Use when the user asks "why would I like this?", "is this for me?", or wants to know how well a specific anime/manga matches their preferences. Returns match score, genre/theme affinity breakdown, mood fit, and existing list status. |
| anilist_similar | Find titles similar to a specific anime or manga. Use when the user asks for shows like a specific title, or wants content-based recommendations without needing a user profile. Returns ranked results with similarity %, shared genres, and community rec strength. |
| anilist_trending | Show what's trending on AniList right now. Use when the user asks what's hot, trending, or generating buzz. No search term needed. Returns ranked list with title, format, score, genres, and episode count. |
| anilist_genres | Browse top anime or manga in a specific genre. Use when the user asks for the best titles in a genre, e.g. "best romance anime" or "top thriller manga from 2023". Supports year, status, and format filters. Returns ranked list with title, score, and genres. |
| anilist_genre_list | List all valid AniList genres and content tags. Use before genre-filtering tools to ensure valid genre names. Returns genres and content tags grouped by category with descriptions. |
| anilist_whoami | Check which AniList account is authenticated and verify the token works. Use when the user wants to confirm their setup or debug auth issues. |
| anilist_staff | Get staff and voice actor credits for an anime or manga. Use when the user asks who directed, wrote, or voiced characters in a title. Returns production staff with roles and characters with Japanese voice actors. |
| anilist_schedule | Get the airing schedule for an anime. Use when the user asks when the next episode airs, or wants to see upcoming episode dates for a currently airing show. Returns next episode date/countdown and upcoming episode schedule. |
| anilist_characters | Search for anime/manga characters by name. Use when the user asks about a specific character, wants to know which series a character appears in, or who voices them. Returns character appearances with roles and voice actors. |
| anilist_staff_search | Search for anime/manga staff by name and see their works. Use when the user asks about a director, voice actor, animator, or writer. Returns staff occupations, works with roles, and scores. |
| anilist_studio_search | Search for an animation studio by name and see their productions. Use when the user asks about a studio like MAPPA, Kyoto Animation, or Bones. Returns main and supporting productions with format, score, and status. |
| anilist_update_progress | Update your episode or chapter progress for an anime or manga. Use when the user says they watched an episode, finished a chapter, or wants to record progress. Requires ANILIST_TOKEN. Returns updated status, progress count, and entry ID. |
| anilist_add_to_list | Add an anime or manga to your list with a status. Use when the user wants to start watching, plan to watch, or mark a title as completed. Requires ANILIST_TOKEN. Returns status, optional score, and entry ID. |
| anilist_rate | Score an anime or manga on your list. Use when the user wants to give a rating (0-10). Scores display in the user's preferred format (3/5/10/100-point). Use 0 to remove. Requires ANILIST_TOKEN. |
| anilist_delete_from_list | Remove an entry from your anime or manga list. Requires the list entry ID (not the media ID) - use anilist_list to find it. Requires ANILIST_TOKEN. |
| anilist_favourite | Toggle favourite on an anime, manga, character, staff member, or studio. Calling again on the same entity removes it from favourites. Requires ANILIST_TOKEN. |
| anilist_activity | Post a text activity to your AniList feed. Use when the user wants to share a status update, thought, or message. Requires ANILIST_TOKEN. |
| anilist_feed | Get recent activity from a user's AniList feed. Shows text posts and list updates (anime/manga status changes). Returns numbered entries with author, date, and content. Supports pagination and type filtering. |
| anilist_profile | View a user's AniList profile including bio, stats, and favourites. Returns bio, anime/manga stats summary, top favourites by category, and account age. |
| anilist_reviews | Get community reviews for an anime or manga. Use when the user wants to see what others think about a title. Returns sentiment summary (positive/mixed/negative), individual review scores, summaries, and helpful ratios. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| seasonal_review | Review this season's anime lineup against my taste profile. |
| what_to_watch | Plan what to watch right now from my current list. |
| roast_my_taste | Get a humorous roast of your anime taste. |
| compare_us | Compare my taste with another user. |
| year_in_review | Get your anime/manga year in review wrapped summary. |
| explain_title | Explain why you would or wouldn't like a specific title. |
| find_similar | Find titles similar to one you enjoyed. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| User Profile | AniList profile with bio, anime/manga stats, and favourites. |