gavxm/ani-mcp

A smart MCP server for AniList that understands your anime and manga taste - not just raw API calls.
What makes this different
Most AniList integrations mirror the API 1:1. ani-mcp adds an intelligence layer on top:
- **Taste profiling** - builds a model of your preferences from your completed list
- **Personalized picks** - "what should I watch next?" based on your taste, mood, and seasonal lineup
- **Compatibility** - compare taste between two users
- **Sequel alerts** - find sequels airing this season for shows you've finished
- **Watch order** - franchise chain traversal for long-running series
- **Session planning** - "I have 90 minutes, what should I watch?" from your current list
- **Year in review** - your watching/reading stats wrapped up
Plus the essentials: search, details, trending, seasonal browsing, list management, social features, and community recommendations. All search and browse tools support pagination for browsing beyond the first page of results.
Try it in 30 seconds
No account needed. Works with any MCP-compatible client.
Claude Desktop
Add to your config file (Settings > Developer > Edit Config or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Restart Claude Desktop after saving.
Alternatively, download ani-mcp.mcpb from the latest release and install via Settings > Extensions.
Claude Code
Personalized features
Add your username for recommendations, taste profiling, and list management:
For write operations (updating progress, scoring, list edits), also add ANILIST_TOKEN. See Environment Variables for details.
Environment Variables
| Variable | Required | Description |
| --- | --- | --- |
| ANILIST_USERNAME | No | Default username for list and stats tools. Can also pass per-call. |
| ANILIST_TOKEN | No | AniList OAuth token. Required for write operations and private lists. |
| ANILIST_TITLE_LANGUAGE | No | Title preference: english (default), romaji, or native. |
| ANILIST_SCORE_FORMAT | No | Override score display: POINT_100, POINT_10_DECIMAL, POINT_10, POINT_5, POINT_3. |
| ANILIST_NSFW | No | Set to true to include adult content in results. Default: false. |
| ANILIST_MOOD_CONFIG | No | JSON object to add or override mood keywords. See Mood config. |
| DEBUG | No | Set to true for debug logging to stderr. |
| MCP_TRANSPORT | No | Set to http for HTTP Stream transport. Default: stdio. |
| MCP_PORT | No | Port for HTTP transport. Default: 3000. |
| MCP_HOST | No | Host for HTTP transport. Default: localhost. |
Tools
Search & Discovery
| Tool | Description |
| --- | --- |
| anilist_search | Search anime/manga by title with genre, year, and format filters |
| anilist_details | Full details, relations, and recommendations for a title |
| anilist_seasonal | Browse a season's anime lineup |
| anilist_trending | What's trending on AniList right now |
| anilist_genres | Browse top titles in a genre with optional filters |
| anilist_genre_list | List all valid genres and content tags |
| anilist_recommendations | Community recommendations for a specific title |
Lists & Stats
| Tool | Description |
| --- | --- |
| anilist_list | A user's anime/manga list, filtered by status |
| anilist_lookup | Check if a specific title is on a user's list |
| anilist_stats | Watching/reading statistics, top genres, score distribution |
Intelligence
| Tool | Description |
| --- | --- |
| anilist_taste | Generate a taste profile from your completed list |
| anilist_pick | Personalized "what to watch next" from your backlog, seasonal lineup, or discovery pool |
| anilist_compare | Compare taste compatibility between two users |
| anilist_wrapped | Year-in-review summary |
| anilist_explain | "Why would I like this?" - score a title against your taste profile |