ani-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2026 GavMason
+
+Permission is hereby granted, free of
+charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# ani-mcp
+
+A smart [MCP](https://modelcontextprotocol.io) server for [AniList](https://anilist.co) that gets your anime/manga taste - not just API calls.
+
+## What makes this different
+
+Most AniList integrations mirror the API 1:1. ani-mcp gives your AI assistant actual understanding of your watching habits:
+
+- **anilist_pick** - "What should I watch next?" based on your taste profile and mood
+- **anilist_taste** - Natural language summary of your anime/manga preferences
+- **anilist_compare** - Compare taste between two users
+- **anilist_wrapped** - Your year-in-review stats
+
+Plus the essentials: search, details, trending, seasonal browsing, list management, and community recommendations.
+
+## Install
+
+Add to your Claude Desktop config (`claude_desktop_config.json`) or `mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "anilist": {
+      "command": "npx",
+      "args": ["-y", "ani-mcp"],
+      "env": {
+        "ANILIST_USERNAME": "your_username"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+| --- | --- | --- |
+| `ANILIST_USERNAME` | No | Default username for list/stats tools. Can also pass per-call. |
+| `ANILIST_TOKEN` | No | AniList OAuth token. Enables authenticated queries. |
+| `DEBUG` | No | Set to `true` for debug logging to stderr. |
+
+## Tools
+
+### Search & Discovery
+
+| Tool | Description |
+| --- | --- |
+| `anilist_search` | Search anime/manga by title with genre, year, and format filters |
+| `anilist_details` | Full details, relations, and recommendations for a title |
+| `anilist_seasonal` | Browse a season's anime lineup |
+| `anilist_trending` | What's trending on AniList right now |
+| `anilist_genres` | Browse top titles in a genre with optional filters |
+| `anilist_recommendations` | Community recommendations for a specific title |
+
+### Lists & Stats
+
+| Tool | Description |
+| --- | --- |
+| `anilist_list` | A user's anime/manga list, filtered by status |
+| `anilist_stats` | Watching/reading statistics, top genres, score distribution |
+
+### Intelligence
+
+| Tool | Description |
+| --- | --- |
+| `anilist_taste` | Generate a taste profile from your completed list |
+| `anilist_pick` | Personalized "what to watch next" based on taste and mood |
+| `anilist_compare` | Compare taste compatibility between two users |
+| `anilist_wrapped` | Year-in-review summary |
+
+### Info
+
+| Tool | Description |
+| --- | --- |
+| `anilist_staff` | Staff credits and voice actors for a title |
+| `anilist_schedule` | Airing schedule and next episode countdown |
+| `anilist_characters` | Search characters by name with appearances and VAs |
+
+## Build from Source
+
+```sh
+git clone https://github.com/GavMason/ani-mcp.git
+cd ani-mcp
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/api/client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * AniList GraphQL API Client
+ *
+ * Handles rate limiting (token bucket), retry with exponential backoff,
+ * and in-memory caching.
+ */
+import type { AniListMediaListEntry } from "../types.js";
+/** Per-category TTLs for the query cache */
+export declare const CACHE_TTLS: {
+    readonly media: number;
+    readonly search: number;
+    readonly list: number;
+    readonly seasonal: number;
+    readonly stats: number;
+};
+export type CacheCategory = keyof typeof CACHE_TTLS;
+/** API error with HTTP status and retry eligibility */
+export declare class AniListApiError extends Error {
+    readonly status?: number | undefined;
+    readonly retryable: boolean;
+    constructor(message: string, status?: number | undefined, retryable?: boolean);
+}
+/** Options for a single query call */
+export interface QueryOptions {
+    /** Cache category to use. Pass null to skip caching. */
+    cache?: CacheCategory | null;
+}
+/** Manages authenticated requests to the AniList GraphQL API */
+declare class AniListClient {
+    private token;
+    constructor();
+    /** Execute a GraphQL query with caching and automatic retry */
+    query<T = unknown>(query: string, variables?: Record<string, unknown>, options?: QueryOptions): Promise<T>;
+    /** Fetch a user's media list, flattened into a single array */
+    fetchList(username: string, type: string, status?: string, sort?: string[]): Promise<AniListMediaListEntry[]>;
+    /** Invalidate the entire query cache */
+    clearCache(): void;
+    /** Retries with exponential backoff via p-retry */
+    private executeWithRetry;
+    /** Send a single GraphQL POST request and parse the response */
+    private makeRequest;
+}
+/** Singleton. Rate limiter and cache must be shared across all tools. */
+export declare const anilistClient: AniListClient;
+export {};

package/dist/api/client.js

@@ -0,0 +1,192 @@
+/**
+ * AniList GraphQL API Client
+ *
+ * Handles rate limiting (token bucket), retry with exponential backoff,
+ * and in-memory caching.
+ */
+import { LRUCache } from "lru-cache";
+import pRetry, { AbortError } from "p-retry";
+import pThrottle from "p-throttle";
+import { USER_LIST_QUERY } from "./queries.js";
+const ANILIST_API_URL = process.env.ANILIST_API_URL || "https://graphql.anilist.co";
+// Budget under the 90 req/min limit to leave headroom
+const RATE_LIMIT_PER_MINUTE = 85;
+const MAX_RETRIES = 3;
+// Hard timeout per fetch attempt (retries get their own timeout)
+const FETCH_TIMEOUT_MS = 15_000;
+// === Logging ===
+const DEBUG = process.env.DEBUG === "true" || process.env.DEBUG === "1";
+// Extract query operation name (e.g. "SearchMedia" from "query SearchMedia(...)")
+function queryName(query) {
+    const match = query.match(/(?:query|mutation)\s+(\w+)/);
+    return match ? match[1] : "unknown";
+}
+function log(event, detail) {
+    if (!DEBUG)
+        return;
+    const msg = detail ? `[ani-mcp] ${event}: ${detail}` : `[ani-mcp] ${event}`;
+    console.error(msg);
+}
+/** Per-category TTLs for the query cache */
+export const CACHE_TTLS = {
+    media: 60 * 60 * 1000, // 1h
+    search: 2 * 60 * 1000, // 2m
+    list: 5 * 60 * 1000, // 5m
+    seasonal: 30 * 60 * 1000, // 30m
+    stats: 10 * 60 * 1000, // 10m
+};
+// 85 req/60s, excess calls queue automatically
+const rateLimit = pThrottle({
+    limit: RATE_LIMIT_PER_MINUTE,
+    interval: 60_000,
+})(() => { });
+// === In-Memory Cache ===
+/** LRU cache with per-entry TTL, keyed on query + variables */
+const queryCache = new LRUCache({
+    max: 500,
+    allowStale: false,
+});
+// === Error Types ===
+/** API error with HTTP status and retry eligibility */
+export class AniListApiError extends Error {
+    status;
+    retryable;
+    constructor(message, status, retryable = false) {
+        super(message);
+        this.status = status;
+        this.retryable = retryable;
+        this.name = "AniListApiError";
+    }
+}
+/** Manages authenticated requests to the AniList GraphQL API */
+class AniListClient {
+    token;
+    constructor() {
+        // Optional - unauthenticated requests still work for public data
+        this.token = process.env.ANILIST_TOKEN || undefined;
+    }
+    /** Execute a GraphQL query with caching and automatic retry */
+    async query(query, variables = {}, options = {}) {
+        const cacheCategory = options.cache ?? null;
+        const name = queryName(query);
+        // Cache-through: return cached result or fetch, store, and return
+        if (cacheCategory) {
+            const cacheKey = `${query}::${JSON.stringify(variables)}`;
+            const cached = queryCache.get(cacheKey);
+            if (cached !== undefined) {
+                log("cache-hit", name);
+                return cached;
+            }
+            log("cache-miss", name);
+            const data = await this.executeWithRetry(query, variables);
+            queryCache.set(cacheKey, data, {
+                ttl: CACHE_TTLS[cacheCategory],
+            });
+            return data;
+        }
+        // No cache category - skip caching entirely
+        return this.executeWithRetry(query, variables);
+    }
+    /** Fetch a user's media list, flattened into a single array */
+    async fetchList(username, type, status, sort) {
+        const variables = { userName: username, type };
+        if (status)
+            variables.status = status;
+        if (sort)
+            variables.sort = sort;
+        const data = await this.query(USER_LIST_QUERY, variables, { cache: "list" });
+        // Flatten across status groups
+        const entries = [];
+        for (const list of data.MediaListCollection.lists) {
+            entries.push(...list.entries);
+        }
+        return entries;
+    }
+    /** Invalidate the entire query cache */
+    clearCache() {
+        queryCache.clear();
+    }
+    /** Retries with exponential backoff via p-retry */
+    async executeWithRetry(query, variables) {
+        const name = queryName(query);
+        log("fetch", name);
+        return pRetry(async () => {
+            await rateLimit();
+            return this.makeRequest(query, variables);
+        }, {
+            retries: MAX_RETRIES,
+            onFailedAttempt: (err) => {
+                log("retry", `${name} attempt ${err.attemptNumber}/${MAX_RETRIES + 1}`);
+            },
+        });
+    }
+    /** Send a single GraphQL POST request and parse the response */
+    async makeRequest(query, variables) {
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        // Attach auth header if an OAuth token is configured
+        if (this.token) {
+            headers["Authorization"] = `Bearer ${this.token}`;
+        }
+        // Network errors (DNS, timeout, etc.) are retryable
+        let response;
+        try {
+            response = await fetch(ANILIST_API_URL, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ query, variables }),
+                signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            });
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            log("network-error", msg);
+            throw new AniListApiError(`Network error connecting to AniList: ${msg}`, undefined, true);
+        }
+        // Map HTTP errors to retryable/non-retryable
+        if (!response.ok) {
+            // Read error body for context
+            const body = await response.text().catch(() => "");
+            if (response.status === 429) {
+                log("rate-limit", `429 from AniList`);
+                const retryAfter = response.headers.get("Retry-After");
+                if (retryAfter) {
+                    const delaySec = parseInt(retryAfter, 10);
+                    if (delaySec > 0) {
+                        await new Promise((r) => setTimeout(r, delaySec * 1000));
+                    }
+                }
+                throw new AniListApiError("AniList rate limit hit. The server will retry automatically.", 429, true);
+            }
+            if (response.status === 404) {
+                throw new AbortError(new AniListApiError("Resource not found on AniList. Check that the ID or username is correct.", 404, false));
+            }
+            // Only server errors (5xx) are worth retrying
+            if (response.status >= 500) {
+                throw new AniListApiError(`AniList API error (HTTP ${response.status}): ${body.slice(0, 200)}`, response.status, true);
+            }
+            // Client errors (4xx except 429) are not worth retrying
+            throw new AbortError(new AniListApiError(`AniList API error (HTTP ${response.status}): ${body.slice(0, 200)}`, response.status, false));
+        }
+        // AniList can return both data and errors
+        const json = (await response.json());
+        // GraphQL can return 200 OK with errors in the body
+        if (json.errors?.length) {
+            // Prefer GraphQL error status over HTTP status
+            const firstError = json.errors[0];
+            const status = firstError.status ?? response.status;
+            const retryable = status === 429 || (status !== undefined && status >= 500);
+            const err = new AniListApiError(`AniList GraphQL error: ${firstError.message}`, status, retryable);
+            throw retryable ? err : new AbortError(err);
+        }
+        // Guard against empty response
+        if (!json.data) {
+            throw new AniListApiError("AniList returned an empty response. Try again.");
+        }
+        return json.data;
+    }
+}
+/** Singleton. Rate limiter and cache must be shared across all tools. */
+export const anilistClient = new AniListClient();

package/dist/api/queries.d.ts

@@ -0,0 +1,30 @@
+/**
+ * AniList GraphQL Query Strings
+ *
+ * Separated from tool logic so queries are easy to find and update
+ * if the AniList schema changes.
+ */
+/** Paginated search with optional genre, year, and format filters */
+export declare const SEARCH_MEDIA_QUERY = "\n  query SearchMedia(\n    $search: String!\n    $type: MediaType\n    $genre: [String]\n    $year: Int\n    $format: MediaFormat\n    $isAdult: Boolean\n    $page: Int\n    $perPage: Int\n    $sort: [MediaSort]\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo {\n        total\n        currentPage\n        lastPage\n        hasNextPage\n      }\n      media(\n        search: $search\n        type: $type\n        genre_in: $genre\n        startDate_year: $year\n        format: $format\n        isAdult: $isAdult\n        sort: $sort\n      ) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+/** Full media lookup with relations and recommendations */
+export declare const MEDIA_DETAILS_QUERY = "\n  query MediaDetails($id: Int, $search: String) {\n    Media(id: $id, search: $search) {\n      ...MediaFields\n      relations {\n        edges {\n          relationType\n          node {\n            id\n            title { romaji english }\n            format\n            status\n            type\n          }\n        }\n      }\n      recommendations(sort: RATING_DESC, perPage: 5) {\n        nodes {\n          rating\n          mediaRecommendation {\n            id\n            title { romaji english }\n            format\n            meanScore\n            genres\n            siteUrl\n          }\n        }\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+/** Discover top-rated titles by genre without a search term */
+export declare const DISCOVER_MEDIA_QUERY = "\n  query DiscoverMedia(\n    $type: MediaType\n    $genre_in: [String]\n    $page: Int\n    $perPage: Int\n    $sort: [MediaSort]\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      media(type: $type, genre_in: $genre_in, sort: $sort) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+/** Browse anime by season and year */
+export declare const SEASONAL_MEDIA_QUERY = "\n  query SeasonalMedia(\n    $season: MediaSeason\n    $seasonYear: Int\n    $type: MediaType\n    $isAdult: Boolean\n    $sort: [MediaSort]\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total currentPage lastPage hasNextPage }\n      media(\n        season: $season\n        seasonYear: $seasonYear\n        type: $type\n        isAdult: $isAdult\n        sort: $sort\n      ) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+/** User profile statistics - watching/reading stats, genre/tag/score breakdowns */
+export declare const USER_STATS_QUERY = "\n  query UserStats($name: String!) {\n    User(name: $name) {\n      id\n      name\n      statistics {\n        anime {\n          count\n          meanScore\n          minutesWatched\n          episodesWatched\n          genres(sort: COUNT_DESC, limit: 10) {\n            genre\n            count\n            meanScore\n            minutesWatched\n          }\n          scores(sort: MEAN_SCORE_DESC) {\n            score\n            count\n          }\n          formats(sort: COUNT_DESC) {\n            format\n            count\n          }\n        }\n        manga {\n          count\n          meanScore\n          chaptersRead\n          volumesRead\n          genres(sort: COUNT_DESC, limit: 10) {\n            genre\n            count\n            meanScore\n            chaptersRead\n          }\n          scores(sort: MEAN_SCORE_DESC) {\n            score\n            count\n          }\n          formats(sort: COUNT_DESC) {\n            format\n            count\n          }\n        }\n      }\n    }\n  }\n";
+/** Media recommendations for a given title */
+export declare const RECOMMENDATIONS_QUERY = "\n  query MediaRecommendations($id: Int, $search: String, $perPage: Int) {\n    Media(id: $id, search: $search) {\n      id\n      title { romaji english native }\n      recommendations(sort: RATING_DESC, perPage: $perPage) {\n        nodes {\n          rating\n          mediaRecommendation {\n            ...MediaFields\n          }\n        }\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+/** Trending anime or manga right now */
+export declare const TRENDING_MEDIA_QUERY = "\n  query TrendingMedia(\n    $type: MediaType\n    $isAdult: Boolean\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      media(type: $type, isAdult: $isAdult, sort: TRENDING_DESC) {\n        ...MediaFields\n        trending\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+/** Browse by genre without a search term, with optional filters */
+export declare const GENRE_BROWSE_QUERY = "\n  query GenreBrowse(\n    $type: MediaType\n    $genre_in: [String]\n    $year: Int\n    $status: MediaStatus\n    $format: MediaFormat\n    $isAdult: Boolean\n    $sort: [MediaSort]\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      media(\n        type: $type\n        genre_in: $genre_in\n        startDate_year: $year\n        status: $status\n        format: $format\n        isAdult: $isAdult\n        sort: $sort\n      ) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+/** Staff and voice actors for a media title */
+export declare const STAFF_QUERY = "\n  query MediaStaff($id: Int, $search: String) {\n    Media(id: $id, search: $search) {\n      id\n      title { romaji english native }\n      format\n      siteUrl\n      staff(sort: RELEVANCE, perPage: 15) {\n        edges {\n          role\n          node {\n            id\n            name { full native }\n            siteUrl\n          }\n        }\n      }\n      characters(sort: ROLE, perPage: 10) {\n        edges {\n          role\n          node {\n            id\n            name { full native }\n            siteUrl\n          }\n          voiceActors(language: JAPANESE) {\n            id\n            name { full native }\n            siteUrl\n          }\n        }\n      }\n    }\n  }\n";
+/** Airing schedule for currently airing anime */
+export declare const AIRING_SCHEDULE_QUERY = "\n  query AiringSchedule($id: Int, $search: String, $notYetAired: Boolean) {\n    Media(id: $id, search: $search) {\n      id\n      title { romaji english native }\n      status\n      episodes\n      nextAiringEpisode {\n        episode\n        airingAt\n        timeUntilAiring\n      }\n      airingSchedule(notYetAired: $notYetAired, perPage: 10) {\n        nodes {\n          episode\n          airingAt\n          timeUntilAiring\n        }\n      }\n      siteUrl\n    }\n  }\n";
+/** Search for characters by name */
+export declare const CHARACTER_SEARCH_QUERY = "\n  query CharacterSearch($search: String!, $page: Int, $perPage: Int) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      characters(search: $search, sort: FAVOURITES_DESC) {\n        id\n        name { full native alternative }\n        image { medium }\n        favourites\n        siteUrl\n        media(sort: POPULARITY_DESC, perPage: 5) {\n          edges {\n            characterRole\n            node {\n              id\n              title { romaji english }\n              format\n              type\n              siteUrl\n            }\n            voiceActors(language: JAPANESE) {\n              id\n              name { full }\n              siteUrl\n            }\n          }\n        }\n      }\n    }\n  }\n";
+/** User's anime/manga list, grouped by status. Omit $status to get all lists. */
+export declare const USER_LIST_QUERY = "\n  query UserMediaList(\n    $userName: String!\n    $type: MediaType\n    $status: MediaListStatus\n    $sort: [MediaListSort]\n  ) {\n    MediaListCollection(\n      userName: $userName\n      type: $type\n      status: $status\n      sort: $sort\n    ) {\n      lists {\n        name\n        status\n        entries {\n          id\n          score(format: POINT_10)  # normalize to 1-10 scale regardless of user's profile setting\n          progress\n          status\n          updatedAt\n          startedAt { year month day }\n          completedAt { year month day }\n          notes\n          media {\n            ...MediaFields\n          }\n        }\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";