/ Directory / Playground / AniList MCP
● Community yuna0x0 ⚡ Instant

AniList MCP

by yuna0x0 · yuna0x0/anilist-mcp

Search anime, manga, and characters via the AniList GraphQL API.

AniList MCP wraps the AniList GraphQL API so Claude can search anime/manga, look up characters and staff, and manage user watchlists. Useful for recommendation chatbots, anime trackers, and writers fact-checking series details.

Why use it

Key features

Live Demo

What it looks like in practice

anilist-mcp.replay ▶ ready
0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "anilist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "anilist-mcp"
      ]
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "anilist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "anilist-mcp"
      ]
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "anilist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "anilist-mcp"
      ]
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "anilist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "anilist-mcp"
      ]
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "anilist-mcp",
      "command": "npx",
      "args": [
        "-y",
        "anilist-mcp"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "anilist-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "anilist-mcp"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add anilist-mcp -- npx -y anilist-mcp

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use AniList MCP

Get genre-aware anime recommendations from your AniList history

👤 Anime fans ⏱ ~15 min intermediate

When to use: You want recs that actually respect what you've already finished.

Prerequisites
  • Server/skill installed and authenticated — See repo README
Flow
  1. Pull watch history
    Read my AniList user list (username: foobar). Group by genre and score.✓ Copied
    → Distribution by genre + average score per genre
  2. Recommend
    Recommend 5 highly-rated anime in my top two genres that I haven't watched yet.✓ Copied
    → List of 5 with titles, year, score, why-you'd-like-it

Outcome: Personalized recs grounded in your actual taste.

Pitfalls
  • Recommendations are LLM-generated — Recommendations are LLM-generated — verify with AniList scores; don't trust title hallucinations.
Combine with: fetch

Combinations

Pair with other MCPs for X10 leverage

anilist-mcp + fetch

Pair with fetch for complementary capabilities

Use this server together with fetch to complete a multi-step task.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
search_anime query, year, season Find anime by title or season 1 GraphQL call
search_character name Look up a character across series 1 GraphQL call
user_list username, type Read a user's public watchlist 1 GraphQL call

Cost & Limits

What this costs to run

API quota
See provider docs for rate limits
Tokens per call
Varies by tool
Monetary
See repo README for pricing details
Tip
Cache tool results and avoid repeated identical calls.

Security

Permissions, secrets, blast radius

Credential storage: Use environment variables; never commit secrets
Data egress: Tool calls go to the provider's API as documented

Troubleshooting

Common errors and fixes

rate limited

AniList caps unauthenticated requests at 30/min. Set ANILIST_TOKEN to raise the limit.

Verify: Wait 60s and retry
user not found

AniList usernames are case-sensitive. Use the exact handle from the user's profile URL.

Verify: Open https://anilist.co/user/<name> in a browser

Alternatives

AniList MCP vs others

AlternativeWhen to use it insteadTradeoff
MyAnimeList unofficial MCPsYou're already syncing to MALAPI is less stable than AniList's GraphQL

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills