AniList MCP server

AniList MCP Server is a tool that interfaces with the AniList API, allowing AI assistants to access anime, manga, character, staff, and user data from AniList through the Model Context Protocol (MCP). It enables seamless integration of AniList's extensive database into conversations with AI assistants.

Installation Options

Install via Smithery

The easiest way to install AniList MCP Server for Claude Desktop is through Smithery:

npx -y @smithery/cli install @yuna0x0/anilist-mcp --client claude

# For other MCP clients, you can:
# List available clients
npx -y @smithery/cli list clients
# Install to other clients
npx -y @smithery/cli install @yuna0x0/anilist-mcp --client <client_name>

Install via mcp-get

An alternative installation method:

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

Manual Installation

1. Add this server to your claude_desktop_config.json:

{
  "mcpServers": {
    "anilist": {
      "command": "npx",
      "args": ["-y", "anilist-mcp"],
      "env": {
        "ANILIST_TOKEN": "your_api_token"
      }
    }
  }
}

You can remove the env object entirely if you don't plan to use operations requiring login.

2. Restart Claude Desktop
3. Begin using the tools in conversations

Setting Up AniList API Token (Optional)

An API token is only required for operations that need login authorization.

1. Go to AniList settings
2. Click "Create New Client"
3. Use this URL as your client's "Redirect URL":

https://anilist.co/api/v2/oauth/pin

4. Click "Save"
5. Go to https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token (replace {clientID} with your client ID)
6. Log in and copy the generated token
7. Use this token in your environment variables or configuration file

Available Tools

General Information Tools

• get_genres: Retrieve all available genres on AniList
• get_media_tags: Retrieve all available media tags
• get_site_statistics: Get AniList statistics over the last seven days
• get_studio: Find information about a studio by ID or name

Media Tools

• get_anime: Get detailed information about an anime by ID
• get_manga: Get detailed information about a manga by ID
• search_anime: Search for anime with various filters
• search_manga: Search for manga with various filters

Character and Staff Tools

• get_character: Get information about a character by ID
• get_staff: Get information about staff member by ID
• search_character: Search for characters by name
• search_staff: Search for staff members by name
• get_todays_birthday_characters: Get characters with today's birthday
• get_todays_birthday_staff: Get staff members with today's birthday

User and List Tools

• get_user_profile: Get a user's AniList profile
• get_user_stats: Get a user's statistics
• get_full_user_info: Get complete profile and stats
• get_user_anime_list: Get a user's anime list
• get_user_manga_list: Get a user's manga list
• search_user: Search for users

Activity and Social Tools

• get_activity: Get a specific AniList activity
• get_user_activity: Get activities from a user
• get_user_recent_activity: Get recent activity from a user
• search_activity: Search for activities

Login-Required Tools

• favourite_anime/manga/character/staff/studio: Toggle favorites
• add_list_entry/update_list_entry/remove_list_entry: Manage your lists
• post_message_activity/post_text_activity: Create activities
• follow_user: Follow or unfollow users
• get_authorized_user: Get your own profile information

Usage Examples

Basic Anime Search

Simply ask to search for anime with specific criteria:

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

Get Character Information

Ask about a specific character:

Can you tell me about the character Hitori Gotou? Use the AniList tools to find information.

Explore Studio Works

Request information about studio productions:

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

Using Docker

If you prefer Docker, you can pull the image:

docker pull yuna0x0/anilist-mcp

Security Note

Be careful with your AniList API token. Never share it publicly or commit it to version control systems.

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.