AniList

v1.3.7APIsstable

Access and interact with anime and manga data seamlessly. Retrieve detailed information about your…

aianilistanimeapillm
Share:
77
Stars
0
Downloads
0
Weekly
0/5

What is AniList?

AniList is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to access and interact with anime and manga data seamlessly. retrieve detailed information about your…

Access and interact with anime and manga data seamlessly. Retrieve detailed information about your…

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • favourite_studio
  • get_genres
  • get_media_tags
  • get_site_statistics
  • get_studio

Use Cases

Anime and manga data access
Series information and metadata retrieval
yuna0x0

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.3.7
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y anilist-mcp

Manual Installation

npx -y anilist-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use AniList

AniList MCP is a Model Context Protocol server that connects AI assistants directly to the AniList API, giving them access to a comprehensive database of anime, manga, characters, voice actors, studios, and user lists. It exposes over 40 tools covering search, detailed metadata retrieval, user profile access, recommendations, and authenticated operations like updating watch lists or following users. Developers and anime enthusiasts can use it to ask natural-language questions about series, compare studio catalogs, manage their AniList lists, and get personalized recommendations without ever leaving their AI chat interface.

Prerequisites

  • Node.js 18 or later
  • An MCP-compatible client such as Claude Desktop
  • An AniList account and OAuth API token (optional — only required for write operations and accessing private user data)
  • Basic familiarity with creating an AniList API client in the AniList developer settings
1

Obtain an AniList API token (optional but recommended)

Go to https://anilist.co/settings/developer and create a new API client. Set the Redirect URL to https://anilist.co/api/v2/oauth/pin. After saving, navigate to the authorization URL substituting your client ID, then copy the token shown. This token is needed only for write operations and viewing private user data.

https://anilist.co/api/v2/oauth/authorize?client_id={YOUR_CLIENT_ID}&response_type=token
2

Add the server to your MCP client configuration

Open your claude_desktop_config.json (on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) and add the anilist-mcp entry. Include the ANILIST_TOKEN environment variable if you obtained a token; omit it for read-only public access.

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

Restart your MCP client

Quit and reopen Claude Desktop (or restart your MCP client). The AniList tools will appear in the available tool list. No further installation or building is required.

4

Search for anime or manga

Use the search_anime or search_manga tools to find titles. You can filter by genre, status, season, year, and more. Results include AniList IDs which you can pass to detail tools.

5

Retrieve detailed information

Use get_anime or get_manga with an AniList ID to get full metadata including synopsis, episode count, airing status, scores, genres, tags, and related media. Use get_character or get_staff for people data.

6

Manage your lists (requires token)

With a valid ANILIST_TOKEN, use add_list_entry, update_list_entry, and remove_list_entry to manage your watching/reading lists. Use follow_user or favourite_anime to interact with the social features.

AniList Examples

Client configuration

Minimal configuration for read-only AniList access. Add ANILIST_TOKEN to the env block to enable authenticated write operations.

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

Prompts to try

Example prompts that leverage the AniList MCP tools for anime research and list management.

- "Search for anime similar to Bocchi the Rock and show me the top 5 results with scores"
- "What anime has Studio Ghibli produced? List their most popular works by score"
- "Tell me about the character Hitori Gotou from AniList — voice actors, appearances, and birthday"
- "Get my AniList profile for username 'yourname' and summarize my watching stats"
- "What are today's character birthdays on AniList?"
- "Find recommendations for Fullmetal Alchemist Brotherhood"

Troubleshooting AniList

Authenticated tools return 'Unauthorized' or 'Invalid token' errors

Regenerate your AniList token via the developer settings. Tokens can expire or be revoked. Ensure ANILIST_TOKEN in your config exactly matches the token shown after OAuth authorization — there should be no extra whitespace.

npx fails to find or run anilist-mcp

Confirm you have Node.js 18+ installed by running 'node --version'. If the package is cached with an older version, run 'npx -y anilist-mcp' in a terminal directly to force a fresh download. Clear the npx cache with 'npx clear-npx-cache' if needed.

Search returns no results for a known title

AniList uses romanized or English titles. Try searching with the English title or romaji spelling (e.g. 'Shingeki no Kyojin' instead of 'Attack on Titan'). Use the search_anime tool's filter parameters to broaden the search.

Frequently Asked Questions about AniList

What is AniList?

AniList is a Model Context Protocol (MCP) server that access and interact with anime and manga data seamlessly. retrieve detailed information about your… It connects AI assistants to external tools and data sources through a standardized interface.

How do I install AniList?

Install via npm with the command: npx -y anilist-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with AniList?

AniList works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is AniList free to use?

Yes, AniList is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use AniList?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides