README.md
A smart MCP server for AniList that understands your anime and manga taste
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):
{
"mcpServers": {
"anilist": {
"command": "npx",
"args": ["-y", "ani-mcp"]
}
}
}
Restart Claude Desktop after saving.
Alternatively, download ani-mcp.mcpb from the latest release and install via Settings > Extensions.
Claude Code
claude mcp add ani-mcp -- npx -y ani-mcp
Personalized features
Add your username for recommendations, taste profiling, and list management:
{
"mcpServers": {
"anilist": {
"command": "npx",
"args": ["-y", "ani-mcp"],
"env": {
"ANILIST_USERNAME": "your_username"
}
}
}
}
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 |
| `an |
Tools (14)
anilist_searchSearch anime/manga by title with genre, year, and format filtersanilist_detailsFull details, relations, and recommendations for a titleanilist_seasonalBrowse a season's anime lineupanilist_trendingWhat's trending on AniList right nowanilist_genresBrowse top titles in a genre with optional filtersanilist_genre_listList all valid genres and content tagsanilist_recommendationsCommunity recommendations for a specific titleanilist_listA user's anime/manga list, filtered by statusanilist_lookupCheck if a specific title is on a user's listanilist_statsWatching/reading statistics, top genres, score distributionanilist_tasteGenerate a taste profile from your completed listanilist_pickPersonalized what to watch next from your backlog, seasonal lineup, or discovery poolanilist_compareCompare taste compatibility between two usersanilist_wrappedYear-in-review summaryEnvironment Variables
ANILIST_USERNAMEDefault username for list and stats toolsANILIST_TOKENAniList OAuth token for write operations and private listsANILIST_TITLE_LANGUAGETitle preference: english, romaji, or nativeANILIST_SCORE_FORMATOverride score display formatANILIST_NSFWInclude adult content in resultsANILIST_MOOD_CONFIGJSON object to add or override mood keywordsDEBUGSet to true for debug loggingMCP_TRANSPORTSet to http for HTTP Stream transportMCP_PORTPort for HTTP transportMCP_HOSTHost for HTTP transportConfiguration
claude_desktop_config.json
{"mcpServers": {"anilist": {"command": "npx", "args": ["-y", "ani-mcp"]}}}Try it
→Based on my completed list, what should I watch next that matches my taste?
→Compare my anime taste with user 'example_user' and tell me what we have in common.
→Find me some highly-rated sci-fi anime airing this season.
→What are my top genres and watching statistics for this year?
→Search for the anime 'Frieren' and give me a summary and recommendations.