AniList-MCP
Connects AI agents to AniList for discovering anime schedules, querying user profile and watch/read statistics, searching anime and manga titles, and retrieving recommendations.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
AniList-MCP ๐
A production-grade Model Context Protocol (MCP) server for AniList, written in Node.js & TypeScript, reusing the proven anilist-node library.
Connects your AI agents (Claude Desktop, Cursor, Antigravity IDE, etc.) directly to AniList to discover anime schedules, query user profile stats, search titles, and retrieve recommendations.
โจ Features (Phase 1 MVP)
๐บ Airing Schedules: Real-time broadcast schedules, countdown timers, and next-episode trackers.
๐ค User Profile & Stats: In-depth statistics (episodes watched, minutes spent, chapters read, average scores, genres).
๐ Search Anime & Manga: Fast title lookups with rich metadata (synonyms, romanized/English titles, cover images).
๐ก Recommendations: Discover related works based on community ratings or fetch individual recommendation threads.
๐ Flexible Auth: Works out-of-the-box for public queries; accepts
ANILIST_TOKENfor authenticated/private data.๐ณ Docker-Ready with
/health: Dual transport support (stdiofor local tools,ssefor remote containers) with an HTTP/healthprobe.
Related MCP server: MAL User MCP Server
๐ Table of Contents
โก Quick Start
Option A: Run via Docker (Recommended)
# Clone the repository
git clone https://github.com/OldemarJesus/AniList-MCP.git
cd AniList-MCP
# Start with Docker Compose
docker compose up -d --build
# Verify health status
curl http://localhost:3000/healthOption B: Run Locally with Node.js
# Install dependencies
npm install
# Build TypeScript
npm run build
# Run in Stdio mode (Default)
npm start
# Or run in SSE/HTTP mode with /health endpoint
TRANSPORT=sse PORT=3000 npm startโ๏ธ Configuration
AniList-MCP is configured via environment variables or a .env file:
Variable | Type | Default | Description |
| String |
| Optional AniList OAuth token for authenticated queries. |
| String |
| Transport type: |
| Number |
| Port for the HTTP / SSE server. |
| String |
| Listen host for the HTTP server. |
| String |
| Logging verbosity ( |
๐ Client Integration
1. Claude Desktop (claude_desktop_config.json)
Stdio Mode (Direct Node execution):
{
"mcpServers": {
"anilist": {
"command": "node",
"args": ["/absolute/path/to/AniList-MCP/dist/index.js"],
"env": {
"ANILIST_TOKEN": "your_optional_token"
}
}
}
}Docker Mode:
{
"mcpServers": {
"anilist": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "TRANSPORT=stdio", "anilist-mcp:latest"]
}
}
}2. Cursor / Antigravity IDE (SSE Mode)
When running the Docker container with TRANSPORT=sse:
URL:
http://localhost:3000/sse
๐ ๏ธ MCP Tools Reference
Tool Name | Parameters | Description |
|
| Returns upcoming anime broadcast schedule and countdowns. |
|
| Returns user bio, favorites, and detailed anime/manga stats. |
|
| Searches anime by title/keyword. |
|
| Searches manga by title/keyword. |
|
| Retrieves a specific recommendation by AniList ID. |
|
| Lists recommendations for an anime or manga. |
See docs/api.md for full parameter schemas and response formats.
๐ฉบ Health Check Endpoint
In sse mode, the server serves an HTTP /health endpoint:
curl http://localhost:3000/health{
"status": "ok",
"service": "anilist-mcp",
"version": "1.0.0",
"uptime": 128.45,
"transport": "sse",
"authenticated": false,
"timestamp": "2026-10-26T04:26:00.000Z"
}๐งช Testing
AniList-MCP includes automated tests verifying tool execution, input schemas, and health checks:
# Run unit and integration tests
npm test
# Run tests in watch mode
npm run test:watch๐ Documentation
Detailed documentation is available in the docs/ directory:
๐ค Author
Developed and maintained by Oldemar Jesus.
๐ License
This project is licensed under the MIT License - see the LICENSE file for details.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
This server cannot be deployed
Maintenance
Related MCP Connectors
Access and interact with anime and manga data seamlessly. Retrieve detailed information about yourโฆ
AniList MCP server for ChatGPT, Claude and any AI agent: update list entry, rate anime or manga, list your anime list, read notifications, reply to activity and favourite a title in your own AniList account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to AniList yourself; Cotlet does not store your password and you need no AniList API key. About the official AniList API: AniList has a full, free public GraphQL API but no official MCP server (checked 17 Oct 2026). The API covers searching titles, reading and saving list entries, activity, favourites, follows and the forum. Setup and FAQ: https://cotlet.dev/integrations/anilist-api-mcp-server
Unofficial AniList MCP โ wraps AniList GraphQL API (free, no auth)
The media memory layer for AI agents and their humans. Your AI client can search your collection, add and log what you've finished, update ratings and lists, and find patterns across everything you've read, watched, played, and listened to.
Related MCP Servers
- AlicenseAqualityDmaintenanceA 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.554MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with MyAnimeList user accounts for list management, progress tracking, and personalized anime recommendations.11MIT
- AlicenseAqualityDmaintenanceExposes a user's MyAnimeList data (watch list, scores, statistics) as MCP tools for AI assistants to analyze taste, build statistics, and make recommendations.20MIT
- AlicenseAqualityDmaintenanceEnables AI clients to search, inspect, rank, and manage MyAnimeList anime and manga, including authenticated user list operations.15MIT