Unleashing the Power of AniList: A Model Context Protocol Server for LLMs

A comprehensive Model Context Protocol (MCP) server designed to seamlessly integrate the vast AniList API with Large Language Models (LLMs), enabling access to anime, manga, character, staff, and user data. Elevate your AI applications with rich contextual awareness.

Core Capabilities

Comprehensive Search: Effortlessly search for anime, manga, characters, staff, and studios with advanced filtering options.
Detailed Information Retrieval: Access in-depth information about specific anime, manga, characters, and staff members.
User Profile Integration: Retrieve user profiles and lists, enabling personalized experiences.
Metadata Access: Retrieve genres and media tags for enhanced content understanding.
AniList Activity Integration: Post and manage activities on AniList.

Getting Started

Prerequisites

Node.js 18+

Installation Methods

1. Smithery Integration (Recommended for Claude Desktop)

Leverage Smithery for automated installation with Claude Desktop:

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

For other MCP clients, discover available options:

npx -y @smithery/cli list clients

Then, install using the appropriate client name:

npx -y @smithery/cli install @yuna0x0/anilist-mcp --client <client_name>

2. MCP-Get Installation

A streamlined installation process using mcp-get:

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

3. Manual Configuration (For Advanced Users)

Integrate the server into your claude_desktop_config.json:

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

*   The `env` object is optional and only required for operations needing authentication.

2. Restart Claude Desktop to apply the changes. 3. Utilize the available tools to interact with AniList data.

Environment Configuration

ANILIST_TOKEN (Optional): Your AniList API token. Required for actions needing user authentication.

Obtaining an AniList API Token (Optional)

Navigate to AniList Developer Settings.
Create a new client application.
Set the "Redirect URL" to: https://anilist.co/api/v2/oauth/pin
Save the client details.
Visit: https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token (Replace {clientID} with your client ID).
Log in and authorize the application to receive your API token.
Store the token in your .env file or environment variables.

Toolset Overview

Miscellaneous Tools

get_genres: Retrieve all available genres.
get_media_tags: Retrieve all available media tags.
get_site_statistics: Access AniList site statistics for the past week.
get_studio: Fetch studio information by ID or name.
favourite_studio: (Requires Login) Add or remove a studio from your favorites.

Activity Management Tools

delete_activity: (Requires Login) Delete your own activity posts.
get_activity: Retrieve a specific activity by its ID.
get_user_activity: Fetch activities from a specific user.
post_message_activity: (Requires Login) Create or update a message activity.
post_text_activity: (Requires Login) Create or update a text activity.

List Management Tools

get_user_anime_list: Retrieve a user's anime list.
get_user_manga_list: Retrieve a user's manga list.
add_list_entry: (Requires Login) Add an entry to your list.
remove_list_entry: (Requires Login) Remove an entry from your list.
update_list_entry: (Requires Login) Update an entry in your list.

Media Information Tools

get_anime: Retrieve detailed anime information by ID.
get_manga: Retrieve detailed manga information by ID.
favourite_anime: (Requires Login) Add or remove an anime from your favorites.
favourite_manga: (Requires Login) Add or remove a manga from your favorites.

People Information Tools

get_character: Retrieve character information by ID.
get_staff: Retrieve staff member information by ID.
favourite_character: (Requires Login) Add or remove a character from your favorites.
favourite_staff: (Requires Login) Add or remove a staff member from your favorites.
get_todays_birthday_characters: Get characters with birthdays today.
get_todays_birthday_staff: Get staff members with birthdays today.

Recommendation Tools

get_recommendation: Retrieve a specific recommendation by ID.
get_recommendations_for_media: Get recommendations for a specific media item.

Search Tools

search_activity: Search for activities.
search_anime: Search for anime with advanced filtering.
search_manga: Search for manga with advanced filtering.
search_character: Search for characters.
search_staff: Search for staff members.
search_studio: Search for studios.
search_user: Search for users.

Thread Tools

get_thread: Retrieve a specific thread by ID.
get_thread_comments: Get comments for a thread.
delete_thread: (Requires Login) Delete a thread by its ID.

get_user_profile: Retrieve a user's profile.
get_user_stats: Retrieve a user's statistics.
get_full_user_info: Retrieve a user's complete profile and stats.
get_user_recent_activity: Get recent activity from a user.
get_authorized_user: (Requires Login) Get the profile of the authorized user.
follow_user: (Requires Login) Follow or unfollow a user.
update_user: (Requires Login) Update user settings.

Example Use Cases

Anime Discovery

Find anime similar to "Attack on Titan" with a rating above 8.

Character Insights

Tell me about the character "Levi Ackerman" from Attack on Titan.

Studio Comparison

Compare the works of Studio Ghibli and Production I.G.

Local Development Setup

This project utilizes Bun as its package manager.

Clone the repository:

git clone https://github.com/yuna0x0/anilist-mcp.git
cd anilist-mcp

Install dependencies:

bun install

Configuration (Optional)

Create a .env file:

cp .env.example .env

Add your AniList API token to the .env file:

ANILIST_TOKEN=your_api_token

Debugging with MCP Inspector

Utilize the MCP Inspector for testing and debugging:

npx @modelcontextprotocol/inspector -e ANILIST_TOKEN=your_api_token npx anilist-mcp

# For Local Development:
bun run inspector

Access the MCP Inspector in your browser (usually at http://127.0.0.1:6274) to:

Connect to your AniList MCP server.
Explore available tools.
Execute tools with custom parameters.
Inspect the responses.

Docker Deployment

Pull from Docker Hub:

docker pull yuna0x0/anilist-mcp

Local Docker Build:

docker build -t yuna0x0/anilist-mcp .

Multi-Platform Docker Build:

docker buildx build --platform linux/amd64,linux/arm64 -t yuna0x0/anilist-mcp .

Security Considerations

The AniList API token is sensitive information. Protect your .env file and avoid committing it to version control.

This comprehensive MCP server empowers LLMs with the rich data and functionality of AniList, opening up new possibilities for AI-powered anime and manga experiences.

anilist-mcp