ani-mcp
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_searchA | 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_detailsA | 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_seasonalA | 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_recommendationsA | 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_listA | 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_statsA | 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_lookupA | Check if a specific title is on a user's list and show its status. Use when the user asks "is this on my list?", "have I seen this?", or wants to check their progress or score for a single title. Returns status, score, progress, and dates without fetching the full list. |
| anilist_exportA | Export a user's anime or manga list as CSV or JSON for backup or migration. Use when the user wants to download, back up, or transfer their list data. |
| anilist_tasteA | 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_pickA | "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_sessionA | 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_sequelsA | 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_orderA | 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_compareA | 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_wrappedA | 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_explainA | 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_similarA | 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_trendingA | 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_genresA | 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_listA | 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_whoamiA | 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_staffA | 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 voice actors. Defaults to Japanese VAs but supports other languages. |
| anilist_scheduleA | 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_airingA | Show upcoming episodes for all anime you're currently watching. Use when the user asks what's airing soon, what episodes are coming up, or wants a watchlist calendar. Returns titles sorted by next airing time with episode number and countdown. |
| anilist_charactersA | 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_searchA | 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_searchA | 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_progressA | 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_listA | 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_rateA | 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_listA | Remove an entry from your anime or manga list. Pass either a list entry ID or a media ID. Requires ANILIST_TOKEN. |
| anilist_undoA | Undo the last write operation (update progress, add to list, rate, delete, or batch update). Restores the previous state of the affected list entry. Requires ANILIST_TOKEN. |
| anilist_favouriteA | 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_activityA | 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_unscoredA | List completed anime or manga that haven't been scored yet. Use when the user wants to catch up on scoring, find unrated titles, or do a batch scoring session. Returns titles sorted by most recently completed. |
| anilist_batch_updateA | Apply a bulk action to multiple list entries matching a filter. Use when the user wants to move all low-scored titles to Dropped, add all planning titles to current, or bulk-change statuses. Defaults to dry-run mode (preview only). Requires ANILIST_TOKEN. |
| anilist_feedB | 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_profileA | 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_reviewsA | 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. |
| anilist_group_pickA | Find anime or manga for a group to watch together. Finds titles on multiple users' planning lists (or highly rated by all). Use when friends want to pick something everyone will enjoy. |
| anilist_shared_planningA | Find titles on both users' planning lists. Use when two users want to see what they're both planning to watch or read. Shows overlap and unique titles. |
| anilist_follow_suggestionsA | Find AniList users with similar taste from your following list. Ranks people you follow by taste compatibility to highlight your best matches. Requires ANILIST_TOKEN for following list access. |
| anilist_reactA | Like or reply to an AniList activity. Use when the user wants to interact with an activity from their feed. Requires ANILIST_TOKEN. LIKE toggles the like state. |
| anilist_calibrationA | Score calibration analysis showing how a user rates compared to community consensus. Use when the user asks if they score too high or low, which genres they're harshest or most generous on, or how their taste compares to mainstream. Returns overall bias, per-genre deviation, and scoring tendency. |
| anilist_dropsA | Drop pattern analysis from a user's dropped list. Use when the user asks why they drop shows, what patterns their drops follow, or which genres they abandon most. Returns drop rate by genre/tag, median episode at drop, and early drop percentage. |
| anilist_evolutionA | Genre evolution analysis showing how taste has shifted over time. Use when the user asks how their taste has changed, what they used to watch vs now, or wants a timeline of their preferences. Returns era-by-era genre rankings and shift descriptions. |
| anilist_completionistA | Franchise completion tracker showing progress through series with sequels. Use when the user asks what franchises they've started but not finished, their completion rate, or what's left to watch in a series. Returns franchise groups with completed/total counts. |
| anilist_seasonal_statsA | Seasonal pick-up and completion rates. Use when the user asks about their seasonal watching habits, how many shows they finish vs drop each season, or their hit rate. Returns per-season breakdown of picked, finished, dropped, and ongoing counts. |
| anilist_paceA | Pace estimate for currently watching or reading titles. Use when the user asks how long it'll take to finish something, their watch rate, or wants a progress summary. Returns estimated completion date based on historical pace. |
| anilist_mal_importA | Import a MyAnimeList user's completed anime list and generate personalized recommendations based on their taste. No MAL auth needed. Use when the user mentions their MAL account or wants recs from MAL history. Returns a taste profile summary and recommended titles from AniList. |
| anilist_kitsu_importA | Import a Kitsu user's completed anime list and generate personalized recommendations based on their taste. No auth needed. Use when the user mentions their Kitsu account or wants recs from Kitsu history. Returns a taste profile summary and recommended titles from AniList. |
| anilist_taste_cardA | Generate a shareable taste profile card image for an AniList user. Returns a PNG image showing top genres, themes, score distribution, and format breakdown. Use when someone wants a visual summary of their anime taste. |
| anilist_compat_cardA | Generate a shareable compatibility card image comparing two AniList users. Returns a PNG image showing compatibility %, genre comparison, shared favorites, and key differences. Use when someone wants a visual comparison of taste. |
| anilist_wrapped_cardA | Generate a shareable year-in-review card image for an AniList user. Returns a PNG image showing titles completed, top genres, score distribution, highlights, and consumption stats. Use when someone wants a visual recap of their year. |
| anilist_seasonal_recap_cardA | Generate a shareable seasonal recap card image for an AniList user. Returns a PNG image showing pick/finish/drop counts, hit rate, status breakdown, and top-scored titles from a season. |
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. |
| setup | Walk through connecting your AniList account to ani-mcp step by step. |
| get_token | Step-by-step guide to create an AniList API token for write features (rate, update progress, etc.). |
| 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. |
| Server Status | Health check showing API connectivity, auth status, cache state, and server version. |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/gavxm/ani-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server