Skip to content
Back to search

anilist-mcp

AniList MCP server for accessing anime and manga data

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yuna0x0--anilist-mcp/badge.svg)](/listings/yuna0x0--anilist-mcp)

HTML

<a href="/listings/yuna0x0--anilist-mcp"><img src="/api/listings/yuna0x0--anilist-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Add this server to your `mcp.json` / `claude_desktop_config.json`:

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

You may remove the `env` object entirely, if you are not planning to use the AniList Token for operations that require login.

2. Restart your MCP client (e.g., Claude Desktop) 3. Use the tools to interact with AniList

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 246 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # AniList MCP Server
  2. A Model Context Protocol (MCP) server that interfaces with the AniList API, allowing LLM clients to access and interact with anime, manga, character, staff, and user data from AniList.
  3. ## Features
  4. - Search for anime, manga, characters, staff, and studios
  5. - Get detailed information about specific anime, manga, characters, and staff members
  6. - Access user profiles and lists
  7. - Support for advanced filtering options
  8. - Retrieve genres and media tags
  9. - **Dual transport support**: Both HTTP and STDIO transports
  10. - **Cloud deployment ready**: Support Smithery and other platforms
  11. ## Requirements
  12. - Node.js 18+
  13. ## Local Installation (STDIO Transport)
  14. 1. Add this server to your `mcp.json` / `claude_desktop_config.json`:
  15. ```json
  16. {
  17. "mcpServers": {
  18. "anilist": {
  19. "command": "npx",
  20. "args": ["-y", "anilist-mcp"],
  21. "env": {
  22. "ANILIST_TOKEN": "your_api_token"
  23. }
  24. }
  25. }
  26. }
  27. ```
  28. You may remove the `env` object entirely, if you are not planning to use the AniList Token for operations that require login.
  29. 2. Restart your MCP client (e.g., Claude Desktop)
  30. 3. Use the tools to interact with AniList
  31. ## Server Deployment (HTTP Transport)
  32. ### Self-Hosting
  33. Follow the [Local Development](#local-development) instructions to set up the project locally, then run:
  34. ```bash
  35. pnpm run start:http
  36. ```
  37. This will start the server on port 8081 by default. You can change the port by setting the `PORT` environment variable.
  38. ### Cloud Deployment
  39. You can deploy this MCP server to any cloud platform that supports Node.js server applications.
  40. You can also deploy via MCP platforms like [Smithery](https://smithery.ai/server/@yuna0x0/anilist-mcp).
  41. ## Configuration
  42. ### Environment Variables (STDIO Transport and HTTP Transport server where host provides the config)
  43. When using the STDIO transport or hosting the HTTP transport server, you can pass configuration via environment variables:
  44. - `ANILIST_TOKEN`: (Optional) AniList API Token (Only needed for operations that require login)
  45. > [!CAUTION]
  46. > If you are hosting the HTTP transport server with token pre-configured, you should protect your endpoint and implement authentication before allowing users to access it. Otherwise, anyone can access your MCP server while using your AniList token.
  47. ### HTTP Headers (HTTP Transport where user provides the config)
  48. When using the HTTP transport, user can pass configuration via HTTP headers:
  49. - `Anilist-Token`: (Optional) AniList API Token (Only needed for operations that require login)
  50. If the user provides the token in the header, while the server also has `ANILIST_TOKEN` set, the header value will take precedence.
  51. ### Get an AniList API Token (Optional)
  52. To get an API token, follow these steps:
  53. 1. Go to [AniList settings](https://anilist.co/settings/developer).
  54. 2. Click on "Create New Client".
  55. 3. Use this URL as your client's "Redirect URL":
  56. ```
  57. https://anilist.co/api/v2/oauth/pin
  58. ```
  59. 4. Click "Save"
  60. 5. Then go to https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token, replace the `{clientID}` with the client ID you get. It will ask you to log in and then provide you with the token to use.
  61. 6. Copy the generated token and use it in your `.env` file or environment variables.
  62. ## Available Tools
  63. ### Misc Tools
  64. - **get_genres**: Get all available genres on AniList
  65. - **get_media_tags**: Get all available media tags on AniList
  66. - **get_site_statistics**: Get AniList site statistics over the last seven days
  67. - **get_studio**: Get information about a studio by its AniList ID or name
  68. - **favourite_studio**: [Requires Login] Favourite or unfavourite a studio by its ID
  69. ### Activity Tools
  70. - **delete_activity**: [Requires Login] Delete the current authorized user's activity post
  71. - **get_activity**: Get a specific AniList activity by its ID
  72. - **get_user_activity**: Fetch activities from a user
  73. - **post_message_activity**: [Requires Login] Post a new message activity or update an existing one
  74. - **post_text_activity**: [Requires Login] Post a new text activity or update an existing one
  75. ### List Tools
  76. - **get_user_anime_list**: Get a user's anime list
  77. - **get_user_manga_list**: Get a user's manga list
  78. - **add_list_entry**: [Requires Login] Add an entry to the authorized user's list
  79. - **remove_list_entry**: [Requires Login] Remove an entry from the authorized user's list
  80. - **update_list_entry**: [Requires Login] Update an entry on the authorized user's list
  81. ### Media Tools
  82. - **get_anime**: Get detailed information about an anime by its AniList ID
  83. - **get_manga**: Get detailed information about a manga by its AniList ID
  84. - **favourite_anime**: [Requires Login] Favourite or unfavourite an anime by its ID
  85. - **favourite_manga**: [Requires Login] Favourite or unfavourite a manga by its ID
  86. ### People Tools
  87. - **get_character**: Get information about a character by their AniList ID
  88. - **get_staff**: Get information about staff member by their AniList ID
  89. - **favourite_character**: [Requires Login] Favourite or unfavourite a character by its ID
  90. - **favourite_staff**: [Requires Login] Favourite or unfavourite a staff member by their ID
  91. - **get_todays_birthday_characters**: Get all characters whose birthday is today
  92. - **get_todays_birthday_staff**: Get all staff members whose birthday is today
  93. ### Recommendation Tools
  94. - **get_recommendation**: Get an AniList recommendation by its ID
  95. - **get_recommendations_for_media**: Get AniList recommendations for a specific media
  96. ### Search Tools
  97. - **search_activity**: Search for activities on AniList
  98. - **search_anime**: Search for anime with query term and filters
  99. - **search_manga**: Search for manga with query term and filters
  100. - **search_character**: Search for characters based on a query term
  101. - **search_staff**: Search for staff members based on a query term
  102. - **search_studio**: Search for studios based on a query term
  103. - **search_user**: Search for users on AniList
  104. ### Thread Tools
  105. - **get_thread**: Get a specific thread by its AniList ID
  106. - **get_thread_comments**: Get comments for a specific thread
  107. - **delete_thread**: [Requires Login] Delete a thread by its ID
  108. ### User Tools
  109. - **get_user_profile**: Get a user's AniList profile
  110. - **get_user_stats**: Get a user's AniList statistics
  111. - **get_full_user_info**: Get a user's complete profile and stats information
  112. - **get_user_recent_activity**: Get recent activity from a user
  113. - **get_authorized_user**: [Requires Login] Get profile information of the currently authorized user
  114. - **follow_user**: [Requires Login] Follow or unfollow a user by their ID
  115. - **update_user**: [Requires Login] Update user settings
  116. ## Example Usage
  117. ### Basic Anime Search
  118. ```
  119. Can you search for anime similar to "Bocchi the Rock!"?
  120. ```
  121. ### Get Character Info
  122. ```
  123. Can you tell me about the character Hitori Gotou? Use the AniList tools to find information.
  124. ```
  125. ### Compare Studio Works
  126. ```
  127. What anime has Studio Ghibli produced? Can you list their most popular works?
  128. ```
  129. ## Local Development
  130. This project uses [pnpm](https://pnpm.io) as its package manager.
  131. Clone the repository and install dependencies:
  132. ```bash
  133. git clone https://github.com/yuna0x0/anilist-mcp.git
  134. cd anilist-mcp
  135. pnpm install
  136. ```
  137. ### Configuration (Optional)
  138. 1. Create a `.env` file by copying the example:
  139. ```bash
  140. cp env.example .env
  141. ```
  142. 2. Edit the `.env` file and add your AniList API token:
  143. ```
  144. ANILIST_TOKEN=your_api_token
  145. ```
  146. ## Debugging with MCP Inspector
  147. You can use the MCP Inspector to test and debug the AniList MCP server:
  148. ```bash
  149. npx @modelcontextprotocol/inspector -e ANILIST_TOKEN=your_api_token npx anilist-mcp
  150. # Use this instead when Local Development
  151. pnpm run inspector
  152. ```
  153. Then open your browser to the provided URL (usually http://localhost:6274) to access the MCP Inspector interface. From there, you can:
  154. 1. Connect to your running AniList MCP server
  155. 2. Browse available tools
  156. 3. Run tools with custom parameters
  157. 4. View the responses
  158. This is particularly useful for testing your setup before connecting it to MCP clients like Claude Desktop.
  159. ## Docker
  160. Pull from GitHub Container Registry:
  161. ```bash
  162. docker pull ghcr.io/yuna0x0/anilist-mcp
  163. ```
  164. Docker build (Local Development):
  165. ```bash
  166. docker build -t ghcr.io/yuna0x0/anilist-mcp .
  167. ```
  168. Docker multi-platform build (Local Development):
  169. ```bash
  170. docker buildx build --platform linux/amd64,linux/arm64 -t ghcr.io/yuna0x0/anilist-mcp .
  171. ```
  172. ## MCP Bundles (MCPB)
  173. To create an MCP Bundle for this server, run:
  174. ```bash
  175. pnpm run pack:mcpb
  176. ```
  177. ## Security Notice
  178. This MCP server accepts your AniList API token in the .env file, environment variable or HTTP header. Keep this information secure and never commit it to version control.
  179. ## License
  180. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.