Get all available genres on AniList
Get all available media tags on AniList
Get AniList site statistics over the last seven days
Get information about a studio by its AniList ID or name
[Requires Login] Favourite or unfavourite a studio by its ID
[Requires Login] Delete the current authorized user's activity post
Get a specific AniList activity by its ID
Fetch activities from a user
[Requires Login] Post a new message activity or update an existing one
[Requires Login] Post a new text activity or update an existing one
Get a user's anime list
Get a user's manga list
[Requires Login] Add an entry to the authorized user's list
[Requires Login] Remove an entry from the authorized user's list
[Requires Login] Update an entry on the authorized user's list
Get detailed information about an anime by its AniList ID
Get detailed information about a manga by its AniList ID
[Requires Login] Favourite or unfavourite an anime by its ID
[Requires Login] Favourite or unfavourite a manga by its ID
Get information about a character by their AniList ID
Get information about staff member by their AniList ID
[Requires Login] Favourite or unfavourite a character by its ID
[Requires Login] Favourite or unfavourite a staff member by their ID
Get all characters whose birthday is today
Get all staff members whose birthday is today
Get an AniList recommendation by its ID
Get AniList recommendations for a specific media
Search for activities on AniList
Search for anime with query term and filters
Search for manga with query term and filters
Search for characters based on a query term
Search for staff members based on a query term
Search for studios based on a query term
Search for users on AniList
Get a specific thread by its AniList ID
Get comments for a specific thread
[Requires Login] Delete a thread by its ID
Get a user's AniList profile
Get a user's AniList statistics
Get a user's complete profile and stats information
Get recent activity from a user
[Requires Login] Get profile information of the currently authorized user
[Requires Login] Follow or unfollow a user by their ID
[Requires Login] Update user settings
AniList MCP provides a comprehensive interface to the AniList API, enabling AI assistants to search, retrieve, and interact with anime, manga, character, staff, and user data. The server supports detailed information retrieval, user profile access, and for authenticated users, the ability to update lists, post activities, and manage favorites. With support for advanced filtering options and comprehensive search capabilities, this MCP allows AI assistants to provide rich, contextual information about Japanese animation and comics, helping users discover new content, track their watching/reading progress, and engage with the anime community.
The AniList MCP server provides access to the AniList API, allowing AI assistants to retrieve and interact with anime, manga, character, staff, and user data. This integration enables rich conversations about Japanese animation and comics with comprehensive data access.
The easiest way to install the AniList MCP server is via Smithery:
npx -y @smithery/cli install @yuna0x0/anilist-mcp --client claude
For other MCP clients, you can list available clients and specify your preferred one:
# List available clients
npx -y @smithery/cli list clients
# Install to other clients
npx -y @smithery/cli install @yuna0x0/anilist-mcp --client <client_name>
Alternatively, you can install using mcp-get:
npx @michaellatman/mcp-get@latest install anilist-mcp
To manually install the AniList MCP server:
claude_desktop_config.json
):{
"mcpServers": {
"anilist": {
"command": "npx",
"args": ["-y", "anilist-mcp"],
"env": {
"ANILIST_TOKEN": "your_api_token"
}
}
}
}
Note: The ANILIST_TOKEN
environment variable is optional and only required for operations that need authentication (like updating lists or posting activities). You can remove the env
object entirely if you don't need these features.
Some features require authentication with an AniList account. To get an API token:
https://anilist.co/api/v2/oauth/pin
as your client's "Redirect URL"https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token
, replacing {clientID}
with your client IDHere are some examples of how to use the AniList MCP with an AI assistant:
Can you search for anime similar to "Bocchi the Rock!"?
Can you tell me about the character Hitori Gotou?
What anime has Studio Ghibli produced? Can you list their most popular works?
Can you show me the anime list for user "example_username"?
For testing and debugging, you can use the MCP Inspector:
npx @modelcontextprotocol/inspector -e ANILIST_TOKEN=your_api_token npx anilist-mcp
Then open your browser to the provided URL (usually http://127.0.0.1:6274) to access the MCP Inspector interface.
The AniList MCP server is also available as a Docker container:
docker pull yuna0x0/anilist-mcp
This can be useful for deployment in containerized environments.