# yuna0x0/anilist-mcp [Health: Active]

**Category:** 🎨 Art & Culture  
**Repository:** https://github.com/yuna0x0/anilist-mcp  
**GitHub Stars:** 92  
**npm Downloads (last month):** 679  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/yuna0x0-anilist-mcp

## Description
A MCP server integrating AniList API for anime and manga information

## Tools
Capabilities this server exposes over MCP:

- **favourite_studio** — [Requires Login] Favourite or unfavourite a studio by its ID
- **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
- **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
- **add_list_entry** — [Requires Login] Add an entry to the authorized user's list
- **get_user_anime_list** — Get a user's anime list
- **get_user_manga_list** — Get a user's manga 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
- **get_anime** — Get detailed information about anime by AniList ID(s)
- **favourite_anime** — [Requires Login] Favourite or unfavourite an anime by its ID
- **favourite_manga** — [Requires Login] Favourite or unfavourite a manga by its ID
- **get_manga** — Get detailed information about manga by AniList ID(s)
- **get_character** — Get information about a character by their AniList ID or name
- **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
- **get_staff** — Get information about staff member by their AniList ID or name
- **get_recommendation** — Get an AniList recommendation by its ID
- **get_recommendations_for_media** — Get AniList recommendations for a specific media
- **search_activity** — Search for activities on AniList
- **search_anime** — Search for anime with query term and filters
- **search_character** — Search for characters based on a query term
- **search_manga** — Search for manga with query term and filters
- **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
- **delete_thread** — [Requires Login] Delete a thread by its ID
- **get_thread** — Get a specific thread by its AniList ID
- **get_thread_comments** — Get comments for a specific thread
- **get_full_user_info** — Get a user's complete profile and stats information
- **follow_user** — [Requires Login] Follow or unfollow a user by their ID
- **get_authorized_user** — [Requires Login] Get profile information of the currently authorized user
- **get_user_recent_activity** — Get recent activity from a user
- **get_user_profile** — Get a user's AniList profile
- **get_user_stats** — Get a user's AniList statistics
- **update_user** — [Requires Login] Update user settings

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `ANILIST_TOKEN`, `PORT` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/yuna0x0-anilist-mcp/readme_