Back to MCP Catalog

AniList MCP Server

Art & CultureTypeScript
Access and interact with anime, manga, character, and user data from AniList
Available Tools

get_genres

Get all available genres on AniList

get_media_tags

Get all available media tags on AniList

get_site_statistics

Get AniList site statistics over the last seven days

get_studio

Get information about a studio by its AniList ID or name

favourite_studio

[Requires Login] Favourite or unfavourite a studio by its ID

delete_activity

[Requires Login] Delete the current authorized user's activity post

get_activity

Get a specific AniList activity by its ID

get_user_activity

Fetch activities from a user

post_message_activity

[Requires Login] Post a new message activity or update an existing one

post_text_activity

[Requires Login] Post a new text activity or update an existing one

get_user_anime_list

Get a user's anime list

get_user_manga_list

Get a user's manga list

add_list_entry

[Requires Login] Add an entry to the authorized user's list

remove_list_entry

[Requires Login] Remove an entry from the authorized user's list

update_list_entry

[Requires Login] Update an entry on the authorized user's list

get_anime

Get detailed information about an anime by its AniList ID

get_manga

Get detailed information about a manga by its AniList ID

favourite_anime

[Requires Login] Favourite or unfavourite an anime by its ID

favourite_manga

[Requires Login] Favourite or unfavourite a manga by its ID

get_character

Get information about a character by their AniList ID

get_staff

Get information about staff member by their AniList ID

favourite_character

[Requires Login] Favourite or unfavourite a character by its ID

favourite_staff

[Requires Login] Favourite or unfavourite a staff member by their ID

get_todays_birthday_characters

Get all characters whose birthday is today

get_todays_birthday_staff

Get all staff members whose birthday is today

get_recommendation

Get an AniList recommendation by its ID

get_recommendations_for_media

Get AniList recommendations for a specific media

search_activity

Search for activities on AniList

search_anime

Search for anime with query term and filters

search_manga

Search for manga with query term and filters

search_character

Search for characters based on a query term

search_staff

Search for staff members based on a query term

search_studio

Search for studios based on a query term

search_user

Search for users on AniList

get_thread

Get a specific thread by its AniList ID

get_thread_comments

Get comments for a specific thread

delete_thread

[Requires Login] Delete a thread by its ID

get_user_profile

Get a user's AniList profile

get_user_stats

Get a user's AniList statistics

get_full_user_info

Get a user's complete profile and stats information

get_user_recent_activity

Get recent activity from a user

get_authorized_user

[Requires Login] Get profile information of the currently authorized user

follow_user

[Requires Login] Follow or unfollow a user by their ID

update_user

[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.

Overview

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.

Installation Options

Using Smithery (Recommended)

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>

Using mcp-get

Alternatively, you can install using mcp-get:

npx @michaellatman/mcp-get@latest install anilist-mcp

Manual Installation

To manually install the AniList MCP server:

  1. Add the server configuration to your client's configuration file (e.g., claude_desktop_config.json):
{
  "mcpServers": {
    "anilist": {
      "command": "npx",
      "args": ["-y", "anilist-mcp"],
      "env": {
        "ANILIST_TOKEN": "your_api_token"
      }
    }
  }
}
  1. Restart your client application
  2. The AniList tools will now be available to your AI assistant

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.

Authentication (Optional)

Some features require authentication with an AniList account. To get an API token:

  1. Go to AniList settings
  2. Click "Create New Client"
  3. Use https://anilist.co/api/v2/oauth/pin as your client's "Redirect URL"
  4. Save the client
  5. Navigate to https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token, replacing {clientID} with your client ID
  6. Log in and copy the generated token
  7. Add this token to your configuration as shown above

Usage Examples

Here are some examples of how to use the AniList MCP with an AI assistant:

Basic Anime Search

Can you search for anime similar to "Bocchi the Rock!"?

Character Information

Can you tell me about the character Hitori Gotou?

Studio Works Comparison

What anime has Studio Ghibli produced? Can you list their most popular works?

User Profile and Lists

Can you show me the anime list for user "example_username"?

Debugging

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.

Docker Support

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.

Related MCPs

Video Jungle
Art & CulturePython

Upload, edit, search, and generate videos with AI assistance

Rijksmuseum
Art & CultureTypeScript

Access and explore the Rijksmuseum's art collection through natural language

Giphy
Art & CultureTypeScript

Access and search for GIFs from Giphy's vast library

About Model Context Protocol

Model Context Protocol (MCP) allows AI models to access external tools and services, extending their capabilities beyond their training data.

Generate Cursor Documentation

Save time on coding by generating custom documentation and prompts for Cursor IDE.