home / mcp / anilist mcp server

AniList MCP Server

AniList MCP server for accessing anime and manga data

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can access AniList data through a dedicated MCP server that exposes AniList search, details, user profiles, and lists via a lightweight, client-friendly interface. This server supports both STDIO and HTTP transports, so you can run it locally or deploy it to the cloud and connect with MCP clients to build powerful conversational experiences around anime and manga data.

How to use

Connect to the AniList MCP server using your MCP client or inspector tool. For STDIO transport, you will run a local configuration that starts the server as a child process and communicates over standard input/output. For HTTP transport, you will interact with a running HTTP endpoint exposed by the server. Once connected, you can search for anime, manga, characters, staff, and studios; fetch detailed information about specific media or people; access user profiles and lists; and retrieve genres and media tags. If you enable login, you can perform actions that require authentication, such as adding or updating user lists and posting activity.

How to install

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

Additional setup and usage notes

For local development with STDIO transport, place the MCP configuration into your client’s mcp.json (or claude_desktop_config.json) as shown above. Then restart your MCP client (for example, Claude Desktop) and begin using the AniList MCP tools.

Security and access considerations

If you configure a token for login-required operations, keep it secure and do not expose it publicly. You can run the server without a token for read-only operations, but any endpoints that require authentication should be protected when hosting publicly.

Available tools

get_genres

Retrieve all available genres from AniList so you can filter media by genre.

get_media_tags

Fetch all available media tags from AniList to refine search results.

get_site_statistics

Obtain site statistics for AniList to gauge overall activity.

get_studio

Get information about a studio by its AniList ID or name.

favourite_studio

Mark a studio as favorite or unfavorite for the authorized user (requires login).

delete_activity

Delete a current authorized user's activity post (requires login).

get_activity

Retrieve a specific AniList activity by its ID.

get_user_activity

Fetch activities from a particular user.

post_message_activity

Post a new message activity or update an existing one (requires login).

post_text_activity

Post a new text activity or update an existing one (requires login).

get_user_anime_list

Get a user’s anime list.

get_user_manga_list

Get a user’s manga list.

add_list_entry

Add an entry to the authorized user’s list (requires login).

remove_list_entry

Remove an entry from the authorized user’s list (requires login).

update_list_entry

Update an entry on the authorized user’s list (requires login).

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

Favourite or unfavourite an anime by its ID (requires login).

favourite_manga

Favourite or unfavourite a manga by its ID (requires login).

get_character

Get information about a character by their AniList ID.

get_staff

Get information about a staff member by their AniList ID.

favourite_character

Favourite or unfavourite a character by its ID (requires login).

favourite_staff

Favourite or unfavourite a staff member by their ID (requires login).

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 a query term and filters.

search_manga

Search for manga with a 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

Delete a thread by its ID (requires login).

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

Get profile information of the currently authorized user (requires login).

follow_user

Follow or unfollow a user by their ID (requires login).

update_user

Update user settings (requires login).