Anilist MCP logo

Anilist MCP

by yuna0x0

Queries AniList for anime, manga, people, activities, recommendations, lists, and authenticated account actions.

Install Anilist MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "yuna0x0-anilist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "anilist-mcp"
      ],
      "env": {
        "ANILIST_TOKEN": "YOUR_VALUE_HERE",
        "PORT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

yuna0x0/anilist-mcp MCP server connects MCP clients to the AniList API for searching and retrieving anime, manga, characters, staff, studios, activities, recommendations, and user lists. It supports STDIO and HTTP transports, with an optional AniList token for actions that modify or access the authorized account. Reach for it when an agent needs AniList data or needs to manage an authenticated user's favourites, activities, or list entries.

Use cases

  • Search for anime matching a query and filters
  • Retrieve detailed manga, character, staff, or studio information
  • Review a user's anime or manga list
  • Manage authenticated AniList list entries and favourites
  • Find recommendations for a media title

Key features

  • Anime and manga search and detail lookup
  • Character, staff, and studio information
  • AniList user lists and activity access
  • Authenticated favourites and list management
  • Recommendations, genres, tags, and site statistics
  • STDIO and HTTP transport support

Tools44

What Anilist MCP lets your agent do. Expand a tool for its parameters.

Verified live~10.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

8/9 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · anilist-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars92Stargazers on the source repository.
npm downloads679Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Tools exposed44Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Anilist MCP works

What yuna0x0/anilist-mcp MCP server does

yuna0x0/anilist-mcp MCP server exposes AniList data and account operations through MCP tools. It is suited to assistants that need structured information about anime and manga, including detailed media records, searches, studios, characters, staff, recommendations, genres, tags, and recent site statistics.

The server also covers AniList activity and list workflows. Read operations can retrieve a user's anime or manga list, fetch activities, inspect recommendations, and look up people or studios. Authenticated operations can add, update, or remove list entries; favourite anime, manga, characters, staff, or studios; and create, update, or delete activity posts.

How it works

MCP clients invoke the exposed tools, which query or mutate the AniList API. Search tools accept query terms and, for anime, filters. Detail tools use AniList IDs or, where supported, names. Recommendation tools can retrieve a recommendation by ID or find recommendations associated with a specific media item.

The server supports two transport modes. STDIO is configured as a local command launched by an MCP client. HTTP can be started for a deployed instance and listens on port 8081 by default. The repository also documents deployment to Node.js-compatible cloud platforms and Smithery.

Operations marked as requiring login use the token for the authorized AniList account. Public lookups do not require that token, so the server can be used without account credentials when only read access is needed.

Setup and configuration

Install and run yuna0x0/anilist-mcp MCP server with Node.js 18 or newer. For a local STDIO setup, configure the MCP client to run npx -y anilist-mcp. Add ANILIST_TOKEN to the client environment only when authenticated operations are needed. The token is optional for public queries.

For HTTP deployment, the documented start command is pnpm run start:http, with PORT available to change the listening port. An HTTP client can provide an optional Anilist-Token header. If both the header and the server environment contain tokens, the header takes precedence.

The repository documents obtaining a token through AniList's developer settings and OAuth authorization flow. Keep tokens out of source control. A hosted HTTP endpoint with a preconfigured token should be protected with authentication, because callers could otherwise use the server with that token.

Tools and capabilities

Available capabilities include:

  • Search anime, activities, characters, and related AniList records.
  • Retrieve anime, manga, character, staff, studio, activity, and recommendation details.
  • Read user anime and manga lists and fetch user activity.
  • Manage list entries and favourites for authenticated users.
  • Create, update, or delete authenticated-user activity posts.
  • Read genres, media tags, site statistics, and today's character or staff birthdays.

Limitations and notes

The yuna0x0/anilist-mcp MCP server depends on AniList data and authentication behavior. Tools requiring login need a valid AniList API token and act on the authorized account. The documented tool set does not make authenticated actions available without that credential.

HTTP hosting introduces an additional credential-handling concern: a server-side token can be used by anyone who can reach an unprotected endpoint. Use an access-control layer before exposing such a deployment. The project includes MCP Inspector instructions for testing tools and responses before connecting a client.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Anilist MCP

yuna0x0/anilist-mcp is an MCP server that connects MCP clients to the AniList API. Its main tools search and retrieve anime, manga, characters, staff, studios, activities, recommendations, and user lists, while optional token-based tools manage favourites, list entries, and authenticated activity posts.

Install it in an MCP client by configuring a STDIO server that runs `npx -y anilist-mcp`. Node.js 18 or newer is required. Add `ANILIST_TOKEN` only if you need tools that require AniList login, then restart the client.

Yes, it works with Claude Desktop through the documented STDIO configuration. Add the server command and optional `ANILIST_TOKEN` to `claude_desktop_config.json`, restart Claude Desktop, and invoke the AniList tools from the client.

Set the optional `ANILIST_TOKEN` environment variable for STDIO or a hosted HTTP server. HTTP clients can instead send the `Anilist-Token` header. The token is required only for login-dependent operations such as changing favourites, lists, or activities.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAnilist MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/yuna0x0-anilist-mcp?style=directory)](https://allmcps.com/mcp/yuna0x0-anilist-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/yuna0x0-anilist-mcp"><img src="https://allmcps.com/api/badge/yuna0x0-anilist-mcp?style=directory" alt="Anilist MCP on AllMCPs" /></a>