ani-mcp
A smart AniList integration for the Model Context Protocol that provides AI assistants with tools for searching media, managing watchlists, and analyzing user anime or manga tastes. It goes beyond basic API calls by offering personalized recommendations, taste comparisons, and natural language profile summaries.
README
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 and mood
- Compatibility - compare taste between two users
- Year in review - your watching/reading stats wrapped up
Plus the essentials: search, details, trending, seasonal browsing, list management, and community recommendations.
Install
Add to your MCP client config (e.g. mcp.json, claude_desktop_config.json, Cursor settings, etc.):
{
"mcpServers": {
"anilist": {
"command": "npx",
"args": ["-y", "ani-mcp"],
"env": {
"ANILIST_USERNAME": "your_username"
}
}
}
}
Works with any MCP-compatible client.
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. |
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_recommendations |
Community recommendations for a specific title |
Lists & Stats
| Tool | Description |
|---|---|
anilist_list |
A user's anime/manga list, filtered by status |
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" based on taste and mood |
anilist_compare |
Compare taste compatibility between two users |
anilist_wrapped |
Year-in-review summary |
Info
| Tool | Description |
|---|---|
anilist_staff |
Staff credits and voice actors for a title |
anilist_schedule |
Airing schedule and next episode countdown |
anilist_characters |
Search characters by name with appearances and VAs |
Write (requires ANILIST_TOKEN)
| Tool | Description |
|---|---|
anilist_update_progress |
Update episode or chapter progress |
anilist_add_to_list |
Add a title to your list with a status |
anilist_rate |
Score a title (0-10) |
anilist_delete_from_list |
Remove an entry from your list |
Docker
docker build -t ani-mcp .
docker run -e ANILIST_USERNAME=your_username ani-mcp
Runs on port 3000 with HTTP Stream transport by default.
Build from Source
git clone https://github.com/gavxm/ani-mcp.git
cd ani-mcp
npm install
npm run build
npm test
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.