SuperAPI AI Directory
Partner with us中文AI newsFavorites
All toolsAI developer platformsanilist-mcp

anilist-mcp

Anime and manga information from the AniList API.

Open website

About this tool

Purpose

AniList MCP Server is a Model Context Protocol (MCP) server used to interface with the AniList API, enabling LLM clients to access and interact with anime, manga, character, staff, and user data on AniList.

Main Capabilities

  • Search anime, manga, characters, staff, and studios
  • Get detailed information about specific anime, manga, characters, and staff
  • Access user profiles and lists
  • Support advanced filtering options
  • Get genres and media tags
  • Dual transport support: supports both HTTP and STDIO transports
  • Cloud deployment support: compatible with Smithery and other platforms

Usage

Local Installation (STDIO Transport)

Add this server to your mcp.json / claude_desktop_config.json. If you do not plan to use AniList Token operations that require login, you can remove the env object entirely. Restart the MCP client (such as Claude Desktop), then use the tools to interact with AniList.

Server Deployment (HTTP Transport)

Set up the project locally according to the local development instructions, then run it. By default, the server starts on port 8081, and the port can be changed by setting the PORT environment variable.

Cloud Deployment

This MCP server can be deployed to any cloud platform that supports Node.js server applications, and can also be deployed through MCP platforms such as Smithery.

Environment Variables (STDIO Transport and HTTP Transport Server with Configuration Provided by the Host)

When using STDIO transport or hosting an HTTP transport server, configuration can be passed through environment variables:

  • ANILIST_TOKEN: (Optional) AniList API Token (only required for login-related operations)

If you host an HTTP transport server with a preconfigured token, you should protect the endpoint and implement authentication before allowing users to access it; otherwise, anyone can access your MCP server while using your AniList token.

HTTP Headers (HTTP Transport with Configuration Provided by the User)

When using HTTP transport, users can pass configuration through HTTP headers:

  • Anilist-Token: (Optional) AniList API Token (only required for login-related operations)

If the user provides a token in the header and the server also has ANILIST_TOKEN set, the value in the header takes precedence.

Obtaining an AniList API Token (Optional)

  1. Go to AniList settings.
  2. Click "Create New Client".
  3. Use this URL as the client's "Redirect URL".
  4. Then visit https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token , replace {clientID} with the client ID you obtained. It will ask you to log in, then provide a token.
  5. Copy the generated token for use in the .env file or environment variables.

Available Tools

  • get_genres: Get all available genres on AniList
  • get_media_tags: Get all available media tags on AniList
  • get_site_statistics: Get site statistics for the last seven days on AniList
  • get_studio: Get studio information by AniList ID or name
  • favourite_studio: [Login required] Favourite or unfavourite a studio by ID
  • delete_activity: [Login required] Delete an activity post of the currently authorized user
  • get_activity: Get a specific AniList activity by ID
  • get_user_activity: Get a user's activity
  • post_message_activity: [Login required] Post a new message activity or update an existing activity
  • post_text_activity: [Login required] Post a new text activity or update an existing activity
  • get_user_anime_list: Get a user's anime list
  • get_user_manga_list: Get a user's manga list
  • add_list_entry: [Login required] Add an entry to the authorized user's list
  • remove_list_entry: [Login required] Remove an entry from the authorized user's list
  • update_list_entry: [Login required] Update an entry in the authorized user's list
  • get_anime: Get detailed information about an anime by AniList ID
  • get_manga: Get detailed information about a manga by AniList ID
  • favourite_anime: [Login required] Favourite or unfavourite an anime by ID
  • favourite_manga: [Login required] Favourite or unfavourite a manga by ID
  • get_character: Get character information by AniList ID
  • get_staff: Get staff information by AniList ID
  • favourite_character: [Login required] Favourite or unfavourite a character by ID
  • favourite_staff: [Login required] Favourite or unfavourite a staff member by ID
  • get_todays_birthday_characters: Get all characters whose birthday is today
  • get_todays_birthday_staff: Get all staff members whose birthday is today

Recommended Tools

  • get_recommendation: Get an AniList recommendation by ID
  • get_recommendations_for_media: Get AniList recommendations for specific media
  • search_activity: Search for activities on AniList
  • search_anime: Search for anime using query terms and filters
  • search_manga: Search for manga using query terms and filters
  • search_character: Search for characters based on query terms
  • search_staff: Search for staff based on query terms
  • search_studio: Search for studios based on query terms
  • search_user: Search for users on AniList
  • get_thread: Get a specific thread by AniList ID
  • get_thread_comments: Get comments of a specific thread
  • delete_thread: [Login required] Delete a thread by 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 full profile and statistics
  • get_user_recent_activity: Get a user's recent activity
  • get_authorized_user: [Login required] Get the profile information of the currently authorized user
  • follow_user: [Login required] Follow or unfollow a user by ID
  • update_user: [Login required] Update user settings

Local Development

This project uses pnpm as the package manager. Clone the repository and install dependencies.

Configuration (Optional)

Copy the example to create a .env file, edit the .env fileand add your AniList API token.

Debugging with MCP Inspector

You can use MCP Inspector to test and debug the AniList MCP server. Then open a browser and visit the provided URL (usually http://localhost:6274 ) to access the MCP Inspector interface. There you can:

  • Connect to a running AniList MCP server
  • Browse available tools
  • Run tools with custom parameters
  • View responses

This is especially useful when testing the configuration before connecting the setup to an MCP client such as Claude Desktop.

Docker

Pull from the GitHub Container Registry. Docker build (local development). Docker multi-platform build (local development).

MCP Bundles (MCPB)

To create an MCP Bundle for this server, run the corresponding command.

Security Notice

This MCP server accepts an AniList API token in a .env file, environment variables, or HTTP headers. Please keep the information secure and never commit it to version control.

This project is licensed under the MIT License.

Related tools

Browse category