Yuna0x0 Anilist Mcp

Frequently asked questions

What does the Yuna0x0 Anilist Mcp MCP server do?

AniList MCP Server 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. Features Search for anime, manga, characters, staff, and studios Get detailed information about specific anime, manga, characters, and staff members Access user profiles and lists Support for advanced filtering options Retrieve genres and media tags Dual transport support : Both HTTP and STDIO transports Cloud deployment ready : Support Smithery and other platforms Requirements Node.js 18+ Local Installation (STDIO Transport) Add this server to your mcp.json / claude desktop config.json : You may remove the env object entirely, if you are not planning to use the AniList Token for operations that require login. Restart your MCP client (e.g., Claude Desktop) Use the tools to interact with AniList Server Deployment (HTTP Transport) Self-Hosting Follow the Local Development instructions to set up the project locally, then run: This will start the server on port 8081 by default. You can change the port by setting the PORT environment variable. Cloud Deployment You can deploy this MCP server to any cloud platform that supports Node.js server applications. You can also deploy via MCP platforms like Smithery. Configuration Environment Variables (STDIO Transport and HTTP Transport server where host provides the config) When using the STDIO transport or hosting the HTTP transport server, you can pass configuration via environment variables: ANILIST TOKEN : (Optional) AniList API Token (Only needed for operations that require login) > [!CAUTION] > 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. HTTP Headers (HTTP Transport where user provides the config) When using the HTTP transport, user can pass configuration via HTTP headers: Anilist-Token : (Optional) AniList API Token (Only needed for operations that require login) If the user provides the token in the header, while the server also has ANILIST TOKEN set, the header value will take precedence. Get an AniList API Token (Optional) To get an API token, follow these steps: Go to AniList settings. Click on "Create New Client". Use this URL as your client's "Redirect URL": Click "Save" Then go to 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. Copy the generated token and use it in your .env file or environment variables. Available Tools Misc 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 Activity Tools 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 List Tools 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 Media Tools 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 People Tools 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 Recommendation Tools get recommendation : Get an AniList recommendation by its ID get recommendations for media : Get AniList recommendations for a specific media Search Tools 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 Thread Tools 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 User Tools 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 Example Usage Basic Anime Search Get Character Info Compare Studio Works Local Development This project uses pnpm as its package manager. Clone the repository and install dependencies: Configuration (Optional) Create a .env file by copying the example: Edit the .env file and add your AniList API token: Debugging with MCP Inspector You can use the MCP Inspector to test and debug the AniList MCP server: Then open your browser to the provided URL (usually to access the MCP Inspector interface. From there, you can: Connect to your running AniList MCP server Browse available tools Run tools with custom parameters View the responses This is particularly useful for testing your setup before connecting it to MCP clients like Claude Desktop. Docker Pull from 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: Security Notice 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. License This project is licensed under the MIT License - see the LICENSE file for details.

How do I install Yuna0x0 Anilist Mcp?

Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.

Is Yuna0x0 Anilist Mcp free to use?

The MCP server itself is free to install. The source is public on https://github.com/yuna0x0/anilist-mcp. Any third-party service it calls may require its own API key and account.

Which clients support Yuna0x0 Anilist Mcp?

Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.