ani-mcp 0.7.1 → 0.8.1

package/README.md

@@ -117,6 +117,17 @@ Works with any MCP-compatible client.
 | `anilist_favourite` | Toggle favourite on anime, manga, character, staff, or studio |
 | `anilist_activity` | Post a text activity to your feed |
 
+### Analytics
+
+| Tool | Description |
+| --- | --- |
+| `anilist_calibration` | Per-genre scoring bias vs community consensus |
+| `anilist_drops` | Drop pattern analysis - genre/tag clusters and median drop point |
+| `anilist_evolution` | How your taste shifted across 2-year time windows |
+| `anilist_completionist` | Franchise completion tracking via relation graph |
+| `anilist_seasonal_stats` | Per-season pick/finish/drop rates |
+| `anilist_pace` | Estimated completion date for currently watching titles |
+
 ### Write (requires `ANILIST_TOKEN`)
 
 | Tool | Description |
@@ -125,6 +136,9 @@ Works with any MCP-compatible client.
 | `anilist_add_to_list` | Add a title to your list with a status |
 | `anilist_rate` | Score a title (0-10) |
 | `anilist_delete_from_list` | Remove an entry from your list |
+| `anilist_undo` | Undo the last write operation |
+| `anilist_unscored` | List completed but unscored titles for batch scoring |
+| `anilist_batch_update` | Bulk filter + action on list entries (dry-run default) |
 
 ## Resources
 

package/dist/api/client.d.ts

@@ -12,6 +12,8 @@ export declare const CACHE_TTLS: {
     readonly list: number;
     readonly seasonal: number;
     readonly stats: number;
+    readonly trending: number;
+    readonly schedule: number;
 };
 export type CacheCategory = keyof typeof CACHE_TTLS;
 /** API error with HTTP status and retry eligibility */
@@ -37,6 +39,8 @@ declare class AniListClient {
     fetchList(username: string, type: string, status?: string, sort?: string[]): Promise<AniListMediaListEntry[]>;
     /** Invalidate the entire query cache */
     clearCache(): void;
+    /** Evict cache entries related to a specific user (lists and stats) */
+    invalidateUser(username: string): void;
     /** Retries with exponential backoff via p-retry */
     private executeWithRetry;
     /** Send a single GraphQL POST request and parse the response */

package/dist/api/client.js

@@ -34,6 +34,8 @@ export const CACHE_TTLS = {
     list: 5 * 60 * 1000, // 5m
     seasonal: 30 * 60 * 1000, // 30m
     stats: 10 * 60 * 1000, // 10m
+    trending: 30 * 60 * 1000, // 30m
+    schedule: 30 * 60 * 1000, // 30m
 };
 // 85 req/60s, excess calls queue automatically
 const rateLimit = pThrottle({
@@ -46,6 +48,14 @@ const queryCache = new LRUCache({
     max: 500,
     allowStale: false,
 });
+/** Stable JSON serialization with sorted keys */
+function stableStringify(obj) {
+    const keys = Object.keys(obj).sort();
+    const sorted = {};
+    for (const k of keys)
+        sorted[k] = obj[k];
+    return JSON.stringify(sorted);
+}
 // === Error Types ===
 /** API error with HTTP status and retry eligibility */
 export class AniListApiError extends Error {
@@ -71,7 +81,7 @@ class AniListClient {
         const name = queryName(query);
         // Cache-through: return cached result or fetch, store, and return
         if (cacheCategory) {
-            const cacheKey = `${query}::${JSON.stringify(variables)}`;
+            const cacheKey = `${query}::${stableStringify(variables)}`;
             const cached = queryCache.get(cacheKey);
             if (cached !== undefined) {
                 log("cache-hit", name);
@@ -111,6 +121,17 @@ class AniListClient {
     clearCache() {
         queryCache.clear();
     }
+    /** Evict cache entries related to a specific user (lists and stats) */
+    invalidateUser(username) {
+        const needle = `"${username}"`;
+        for (const key of queryCache.keys()) {
+            // Variable portion is after "::"
+            const varPart = key.slice(key.indexOf("::") + 2);
+            if (varPart.includes(needle)) {
+                queryCache.delete(key);
+            }
+        }
+    }
     /** Retries with exponential backoff via p-retry */
     async executeWithRetry(query, variables) {
         const name = queryName(query);

package/dist/api/queries.d.ts

@@ -28,6 +28,8 @@ export declare const AIRING_SCHEDULE_QUERY = "\n  query AiringSchedule($id: Int,
 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";
 /** Create or update a list entry */
 export declare const SAVE_MEDIA_LIST_ENTRY_MUTATION = "\n  mutation SaveMediaListEntry(\n    $mediaId: Int\n    $status: MediaListStatus\n    $scoreRaw: Int\n    $progress: Int\n    $notes: String\n    $private: Boolean\n  ) {\n    SaveMediaListEntry(\n      mediaId: $mediaId\n      status: $status\n      scoreRaw: $scoreRaw\n      progress: $progress\n      notes: $notes\n      private: $private\n    ) {\n      id\n      mediaId\n      status\n      score(format: POINT_10)\n      progress\n    }\n  }\n";
+/** Fetch a single list entry for snapshotting before mutations */
+export declare const MEDIA_LIST_ENTRY_QUERY = "\n  query MediaListEntry($id: Int, $mediaId: Int, $userName: String) {\n    MediaList(id: $id, mediaId: $mediaId, userName: $userName) {\n      id\n      mediaId\n      status\n      score(format: POINT_10)\n      progress\n      notes\n      private\n    }\n  }\n";
 /** Remove a list entry */
 export declare const DELETE_MEDIA_LIST_ENTRY_MUTATION = "\n  mutation DeleteMediaListEntry($id: Int!) {\n    DeleteMediaListEntry(id: $id) {\n      deleted\n    }\n  }\n";
 /** User's anime/manga list, grouped by status. Omit $status to get all lists. */

package/dist/api/queries.js

@@ -394,6 +394,20 @@ export const SAVE_MEDIA_LIST_ENTRY_MUTATION = `
     }
   }
 `;
+/** Fetch a single list entry for snapshotting before mutations */
+export const MEDIA_LIST_ENTRY_QUERY = `
+  query MediaListEntry($id: Int, $mediaId: Int, $userName: String) {
+    MediaList(id: $id, mediaId: $mediaId, userName: $userName) {
+      id
+      mediaId
+      status
+      score(format: POINT_10)
+      progress
+      notes
+      private
+    }
+  }
+`;
 /** Remove a list entry */
 export const DELETE_MEDIA_LIST_ENTRY_MUTATION = `
   mutation DeleteMediaListEntry($id: Int!) {

package/dist/engine/compare.js

@@ -35,18 +35,21 @@ export function computeGenreDivergences(p1, p2, name1 = "User 1", name2 = "User
     const genres2 = new Map(p2.genres.map((g) => [g.name, g]));
     const allGenres = new Set([...genres1.keys(), ...genres2.keys()]);
     const divergences = [];
+    // Pre-compute rank maps for O(1) lookup
+    const rankOf1 = new Map([...genres1.keys()].map((g, i) => [g, i]));
+    const rankOf2 = new Map([...genres2.keys()].map((g, i) => [g, i]));
     // Flag genres in one user's top 5 but not the other's top 10
     for (const genre of allGenres) {
-        const rank1 = [...genres1.keys()].indexOf(genre);
-        const rank2 = [...genres2.keys()].indexOf(genre);
-        if (rank1 >= 0 && rank1 < 5 && (rank2 < 0 || rank2 > 10)) {
+        const rank1 = rankOf1.get(genre) ?? -1;
+        const rank2 = rankOf2.get(genre) ?? -1;
+        if (rank1 >= 0 && rank1 < 5 && (rank2 === -1 || rank2 > 10)) {
             divergences.push({
                 genre,
                 diff: 10,
                 desc: `${name1} loves ${genre}, ${name2} doesn't`,
             });
         }
-        else if (rank2 >= 0 && rank2 < 5 && (rank1 < 0 || rank1 > 10)) {
+        else if (rank2 >= 0 && rank2 < 5 && (rank1 === -1 || rank1 > 10)) {
             divergences.push({
                 genre,
                 diff: 10,

package/dist/engine/profile-cache.d.ts

@@ -0,0 +1,13 @@
+/** Cached taste profiles with hash-based invalidation. */
+import type { TasteProfile } from "./taste.js";
+import type { AniListMediaListEntry } from "../types.js";
+/** Stable hash of entry IDs and scores to detect list changes */
+export declare function computeListHash(entries: AniListMediaListEntry[]): string;
+/** Get a cached profile if the list hash matches */
+export declare function getCachedProfile(key: string, listHash: string): TasteProfile | undefined;
+/** Store a profile in the cache */
+export declare function setCachedProfile(key: string, profile: TasteProfile, listHash: string): void;
+/** Invalidate all profiles for a username */
+export declare function invalidateUserProfiles(username: string): void;
+/** Clear all cached profiles */
+export declare function clearProfileCache(): void;

package/dist/engine/profile-cache.js

@@ -0,0 +1,36 @@
+/** Cached taste profiles with hash-based invalidation. */
+import { LRUCache } from "lru-cache";
+// 30-minute TTL, max 20 profiles
+const cache = new LRUCache({
+    max: 20,
+    ttl: 30 * 60 * 1000,
+});
+/** Stable hash of entry IDs and scores to detect list changes */
+export function computeListHash(entries) {
+    const pairs = entries.map((e) => `${e.id}:${e.score}`).sort();
+    return pairs.join(",");
+}
+/** Get a cached profile if the list hash matches */
+export function getCachedProfile(key, listHash) {
+    const cached = cache.get(key);
+    if (cached && cached.listHash === listHash)
+        return cached.profile;
+    return undefined;
+}
+/** Store a profile in the cache */
+export function setCachedProfile(key, profile, listHash) {
+    cache.set(key, { profile, listHash });
+}
+/** Invalidate all profiles for a username */
+export function invalidateUserProfiles(username) {
+    const lower = username.toLowerCase();
+    for (const key of cache.keys()) {
+        if (key.toLowerCase().startsWith(`${lower}::`)) {
+            cache.delete(key);
+        }
+    }
+}
+/** Clear all cached profiles */
+export function clearProfileCache() {
+    cache.clear();
+}

package/dist/engine/undo.d.ts

@@ -0,0 +1,42 @@
+/** Session-scoped undo stack for write operations. */
+export interface EntrySnapshot {
+    id: number;
+    mediaId: number;
+    status: string;
+    score: number;
+    progress: number;
+    notes: string | null;
+    private: boolean;
+}
+export type UndoOperation = {
+    type: "update";
+    before: EntrySnapshot;
+} | {
+    type: "create";
+    entryId: number;
+    mediaId: number;
+} | {
+    type: "delete";
+    before: EntrySnapshot;
+} | {
+    type: "batch";
+    entries: Array<{
+        before: EntrySnapshot;
+    }>;
+};
+export interface UndoRecord {
+    operation: UndoOperation;
+    toolName: string;
+    timestamp: number;
+    description: string;
+}
+/** Push a record onto the undo stack, trimming oldest if full */
+export declare function pushUndo(record: UndoRecord): void;
+/** Pop the most recent undo record */
+export declare function popUndo(): UndoRecord | undefined;
+/** Inspect the most recent record without removing */
+export declare function peekUndo(): UndoRecord | undefined;
+/** Current stack depth */
+export declare function undoStackSize(): number;
+/** Clear all undo records */
+export declare function clearUndoStack(): void;

package/dist/engine/undo.js

@@ -0,0 +1,26 @@
+/** Session-scoped undo stack for write operations. */
+// === Stack ===
+const MAX_UNDO = 20;
+const stack = [];
+/** Push a record onto the undo stack, trimming oldest if full */
+export function pushUndo(record) {
+    stack.push(record);
+    while (stack.length > MAX_UNDO)
+        stack.shift();
+}
+/** Pop the most recent undo record */
+export function popUndo() {
+    return stack.pop();
+}
+/** Inspect the most recent record without removing */
+export function peekUndo() {
+    return stack.length > 0 ? stack[stack.length - 1] : undefined;
+}
+/** Current stack depth */
+export function undoStackSize() {
+    return stack.length;
+}
+/** Clear all undo records */
+export function clearUndoStack() {
+    stack.length = 0;
+}

package/dist/index.js

@@ -21,7 +21,7 @@ if (!process.env.ANILIST_TOKEN) {
 }
 const server = new FastMCP({
     name: "ani-mcp",
-    version: "0.7.1",
+    version: "0.8.1",
 });
 registerSearchTools(server);
 registerListTools(server);

package/dist/resources.js

@@ -1,10 +1,10 @@
 /** MCP Resources: expose user context without tool calls */
 import { anilistClient } from "./api/client.js";
-import { USER_PROFILE_QUERY, USER_STATS_QUERY } from "./api/queries.js";
+import { USER_PROFILE_QUERY } from "./api/queries.js";
 import { buildTasteProfile, describeTasteProfile, } from "./engine/taste.js";
 import { formatProfile } from "./tools/social.js";
 import { formatListEntry } from "./tools/lists.js";
-import { getDefaultUsername, detectScoreFormat } from "./utils.js";
+import { getDefaultUsername, getScoreFormat } from "./utils.js";
 /** Register MCP resources on the server */
 export function registerResources(server) {
     // === User Profile ===
@@ -73,10 +73,7 @@ export function registerResources(server) {
                 const mediaType = String(type).toUpperCase();
                 const [entries, scoreFormat] = await Promise.all([
                     anilistClient.fetchList(username, mediaType, "CURRENT"),
-                    detectScoreFormat(async () => {
-                        const data = await anilistClient.query(USER_STATS_QUERY, { name: username }, { cache: "stats" });
-                        return data.User.mediaListOptions.scoreFormat;
-                    }),
+                    getScoreFormat(username),
                 ]);
                 if (!entries.length) {
                     return {

package/dist/schemas.d.ts

@@ -92,6 +92,7 @@ export declare const PickInputSchema: z.ZodObject<{
     year: z.ZodOptional<z.ZodNumber>;
     mood: z.ZodOptional<z.ZodString>;
     maxEpisodes: z.ZodOptional<z.ZodNumber>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     limit: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type PickInput = z.infer<typeof PickInputSchema>;
@@ -277,11 +278,13 @@ export declare const RateInputSchema: z.ZodObject<{
 export type RateInput = z.infer<typeof RateInputSchema>;
 /** Input for removing a title from the list */
 export declare const DeleteFromListInputSchema: z.ZodObject<{
-    entryId: z.ZodNumber;
+    entryId: z.ZodOptional<z.ZodNumber>;
+    mediaId: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /** Input for scoring a title against a user's taste profile */
 export declare const ExplainInputSchema: z.ZodObject<{
-    mediaId: z.ZodNumber;
+    mediaId: z.ZodOptional<z.ZodNumber>;
+    title: z.ZodOptional<z.ZodString>;
     username: z.ZodOptional<z.ZodString>;
     type: z.ZodDefault<z.ZodEnum<{
         ANIME: "ANIME";
@@ -293,7 +296,8 @@ export declare const ExplainInputSchema: z.ZodObject<{
 export type ExplainInput = z.infer<typeof ExplainInputSchema>;
 /** Input for finding titles similar to a specific anime or manga */
 export declare const SimilarInputSchema: z.ZodObject<{
-    mediaId: z.ZodNumber;
+    mediaId: z.ZodOptional<z.ZodNumber>;
+    title: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type SimilarInput = z.infer<typeof SimilarInputSchema>;
@@ -423,3 +427,50 @@ export declare const PaceInputSchema: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type PaceInput = z.infer<typeof PaceInputSchema>;
+/** Input for undoing the last write operation */
+export declare const UndoInputSchema: z.ZodObject<{}, z.core.$strip>;
+export type UndoInput = z.infer<typeof UndoInputSchema>;
+/** Input for listing unscored completed titles */
+export declare const UnscoredInputSchema: z.ZodObject<{
+    username: z.ZodOptional<z.ZodString>;
+    type: z.ZodDefault<z.ZodEnum<{
+        ANIME: "ANIME";
+        MANGA: "MANGA";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type UnscoredInput = z.infer<typeof UnscoredInputSchema>;
+/** Input for batch-updating multiple list entries */
+export declare const BatchUpdateInputSchema: z.ZodObject<{
+    username: z.ZodOptional<z.ZodString>;
+    type: z.ZodDefault<z.ZodEnum<{
+        ANIME: "ANIME";
+        MANGA: "MANGA";
+    }>>;
+    filter: z.ZodObject<{
+        status: z.ZodOptional<z.ZodEnum<{
+            CURRENT: "CURRENT";
+            COMPLETED: "COMPLETED";
+            PLANNING: "PLANNING";
+            DROPPED: "DROPPED";
+            PAUSED: "PAUSED";
+        }>>;
+        scoreBelow: z.ZodOptional<z.ZodNumber>;
+        scoreAbove: z.ZodOptional<z.ZodNumber>;
+        unscored: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    action: z.ZodObject<{
+        setStatus: z.ZodOptional<z.ZodEnum<{
+            CURRENT: "CURRENT";
+            COMPLETED: "COMPLETED";
+            PLANNING: "PLANNING";
+            DROPPED: "DROPPED";
+            PAUSED: "PAUSED";
+            REPEATING: "REPEATING";
+        }>>;
+        setScore: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type BatchUpdateInput = z.infer<typeof BatchUpdateInputSchema>;

package/dist/schemas.js

@@ -7,12 +7,12 @@ const pageParam = z
     .min(1)
     .default(1)
     .describe("Page number for pagination (default 1)");
-// AniList usernames: 2-20 chars, alphanumeric + underscores
+// AniList usernames: 2-20 chars, alphanumeric + underscores + hyphens
 const usernameSchema = z
     .string()
     .min(2)
     .max(20)
-    .regex(/^[a-zA-Z0-9_]+$/, "Letters, numbers, and underscores only");
+    .regex(/^[a-zA-Z0-9_-]+$/, "Letters, numbers, underscores, and hyphens only");
 /** Input for searching anime or manga by title and filters */
 export const SearchInputSchema = z.object({
     query: z
@@ -166,6 +166,11 @@ export const PickInputSchema = z.object({
         .positive()
         .optional()
         .describe("Filter out series longer than this episode count"),
+    exclude: z
+        .array(z.number().int().positive())
+        .max(50)
+        .optional()
+        .describe("Media IDs to exclude from results (e.g. from previous recommendations)"),
     limit: z
         .number()
         .int()
@@ -466,21 +471,37 @@ export const RateInputSchema = z.object({
         .describe("Score on a 0-10 scale. Use 0 to remove a score."),
 });
 /** Input for removing a title from the list */
-export const DeleteFromListInputSchema = z.object({
+export const DeleteFromListInputSchema = z
+    .object({
     entryId: z
         .number()
         .int()
         .positive()
-        .describe("List entry ID to delete. This is the id field on a list entry, not the media ID. " +
-        "Use anilist_list to find entry IDs."),
+        .optional()
+        .describe("List entry ID to delete (from anilist_list)"),
+    mediaId: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("AniList media ID to remove from your list"),
+})
+    .refine((data) => data.entryId !== undefined || data.mediaId !== undefined, {
+    message: "Provide either an entryId or a mediaId.",
 });
 /** Input for scoring a title against a user's taste profile */
-export const ExplainInputSchema = z.object({
+export const ExplainInputSchema = z
+    .object({
     mediaId: z
         .number()
         .int()
         .positive()
+        .optional()
         .describe("AniList media ID to evaluate against your taste profile"),
+    title: z
+        .string()
+        .optional()
+        .describe("Search by title if no ID is known"),
     username: usernameSchema
         .optional()
         .describe("AniList username. Falls back to configured default if not provided."),
@@ -492,14 +513,23 @@ export const ExplainInputSchema = z.object({
         .string()
         .optional()
         .describe('Optional mood context, e.g. "dark and brainy"'),
+})
+    .refine((data) => data.mediaId !== undefined || data.title !== undefined, {
+    message: "Provide either a mediaId or a title.",
 });
 /** Input for finding titles similar to a specific anime or manga */
-export const SimilarInputSchema = z.object({
+export const SimilarInputSchema = z
+    .object({
     mediaId: z
         .number()
         .int()
         .positive()
+        .optional()
         .describe("AniList media ID to find similar titles for"),
+    title: z
+        .string()
+        .optional()
+        .describe("Search by title if no ID is known"),
     limit: z
         .number()
         .int()
@@ -507,6 +537,9 @@ export const SimilarInputSchema = z.object({
         .max(25)
         .default(10)
         .describe("Number of similar titles to return (default 10, max 25)"),
+})
+    .refine((data) => data.mediaId !== undefined || data.title !== undefined, {
+    message: "Provide either a mediaId or a title.",
 });
 /** Input for searching staff/people by name */
 export const StaffSearchInputSchema = z.object({
@@ -704,3 +737,85 @@ export const PaceInputSchema = z.object({
         .default("ANIME")
         .describe("Estimate pace for anime or manga"),
 });
+// === 0.8.0 Persistent Intelligence ===
+/** Input for undoing the last write operation */
+export const UndoInputSchema = z.object({});
+/** Input for listing unscored completed titles */
+export const UnscoredInputSchema = z.object({
+    username: usernameSchema
+        .optional()
+        .describe("AniList username. Falls back to configured default if not provided."),
+    type: z
+        .enum(["ANIME", "MANGA"])
+        .default("ANIME")
+        .describe("Check anime or manga list for unscored titles"),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(20)
+        .describe("Number of unscored titles to return (default 20, max 50)"),
+});
+/** Input for batch-updating multiple list entries */
+export const BatchUpdateInputSchema = z.object({
+    username: usernameSchema
+        .optional()
+        .describe("AniList username. Falls back to configured default if not provided."),
+    type: z
+        .enum(["ANIME", "MANGA"])
+        .default("ANIME")
+        .describe("Update anime or manga entries"),
+    filter: z.object({
+        status: z
+            .enum(["CURRENT", "COMPLETED", "PLANNING", "DROPPED", "PAUSED"])
+            .optional()
+            .describe("Only match entries with this status"),
+        scoreBelow: z
+            .number()
+            .min(0)
+            .max(10)
+            .optional()
+            .describe("Only match entries scored below this value"),
+        scoreAbove: z
+            .number()
+            .min(0)
+            .max(10)
+            .optional()
+            .describe("Only match entries scored above this value"),
+        unscored: z
+            .boolean()
+            .optional()
+            .describe("Only match entries with no score"),
+    }),
+    action: z.object({
+        setStatus: z
+            .enum([
+            "CURRENT",
+            "PLANNING",
+            "COMPLETED",
+            "DROPPED",
+            "PAUSED",
+            "REPEATING",
+        ])
+            .optional()
+            .describe("Change status to this value"),
+        setScore: z
+            .number()
+            .min(0)
+            .max(10)
+            .optional()
+            .describe("Set score to this value (0 removes score)"),
+    }),
+    dryRun: z
+        .boolean()
+        .default(true)
+        .describe("Preview changes without applying them. Set to false to execute."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe("Max entries to update in one call (default 50, max 100)"),
+});

package/dist/tools/discover.js

@@ -2,7 +2,7 @@
 import { anilistClient } from "../api/client.js";
 import { TRENDING_MEDIA_QUERY, GENRE_BROWSE_QUERY, GENRE_TAG_COLLECTION_QUERY, } from "../api/queries.js";
 import { TrendingInputSchema, GenreBrowseInputSchema, GenreListInputSchema, } from "../schemas.js";
-import { formatMediaSummary, throwToolError, paginationFooter, } from "../utils.js";
+import { formatMediaSummary, throwToolError, paginationFooter, BROWSE_SORT_MAP, } from "../utils.js";
 /** Register discovery tools on the MCP server */
 export function registerDiscoverTools(server) {
     // === Trending ===
@@ -25,7 +25,7 @@ export function registerDiscoverTools(server) {
                     isAdult: args.isAdult ? undefined : false,
                     page: args.page,
                     perPage: args.limit,
-                }, { cache: "search" });
+                }, { cache: "trending" });
                 const results = data.Page.media;
                 if (!results.length) {
                     return `No trending ${args.type.toLowerCase()} found.`;
@@ -61,15 +61,10 @@ export function registerDiscoverTools(server) {
         },
         execute: async (args) => {
             try {
-                const sortMap = {
-                    SCORE: ["SCORE_DESC"],
-                    POPULARITY: ["POPULARITY_DESC"],
-                    TRENDING: ["TRENDING_DESC"],
-                };
                 const variables = {
                     type: args.type,
                     genre_in: [args.genre],
-                    sort: sortMap[args.sort] ?? sortMap.SCORE,
+                    sort: BROWSE_SORT_MAP[args.sort] ?? BROWSE_SORT_MAP.SCORE,
                     isAdult: args.isAdult ? undefined : false,
                     page: args.page,
                     perPage: args.limit,

package/dist/tools/info.js

@@ -154,7 +154,7 @@ export function registerInfoTools(server) {
                     variables.id = args.id;
                 if (args.title)
                     variables.search = args.title;
-                const data = await anilistClient.query(AIRING_SCHEDULE_QUERY, variables, { cache: "search" });
+                const data = await anilistClient.query(AIRING_SCHEDULE_QUERY, variables, { cache: "schedule" });
                 const m = data.Media;
                 const lines = [
                     `# Schedule: ${getTitle(m.title)}`,

package/dist/tools/lists.js

@@ -2,7 +2,7 @@
 import { anilistClient } from "../api/client.js";
 import { USER_STATS_QUERY } from "../api/queries.js";
 import { ListInputSchema, StatsInputSchema } from "../schemas.js";
-import { getTitle, getDefaultUsername, throwToolError, paginationFooter, formatScore, detectScoreFormat, } from "../utils.js";
+import { getTitle, getDefaultUsername, throwToolError, paginationFooter, formatScore, getScoreFormat, } from "../utils.js";
 // Map user-friendly sort names to AniList's internal enum values
 const SORT_MAP = {
     SCORE: ["SCORE_DESC"],
@@ -38,10 +38,7 @@ export function registerListTools(server) {
                 const status = args.status !== "ALL" ? args.status : undefined;
                 const [allEntries, scoreFormat] = await Promise.all([
                     anilistClient.fetchList(username, args.type, status, sort),
-                    detectScoreFormat(async () => {
-                        const data = await anilistClient.query(USER_STATS_QUERY, { name: username }, { cache: "stats" });
-                        return data.User.mediaListOptions.scoreFormat;
-                    }),
+                    getScoreFormat(username),
                 ]);
                 if (!allEntries.length) {
                     if (args.status === "ALL") {
@@ -141,11 +138,7 @@ async function handleCustomLists(username, args, sort) {
         return `${username}'s ${listLabel} have no entries.`;
     }
     sortEntries(allEntries, args.sort);
-    // Detect score format
-    const scoreFormat = await detectScoreFormat(async () => {
-        const data = await anilistClient.query(USER_STATS_QUERY, { name: username }, { cache: "stats" });
-        return data.User.mediaListOptions.scoreFormat;
-    });
+    const scoreFormat = await getScoreFormat(username);
     const totalCount = allEntries.length;
     const offset = (args.page - 1) * args.limit;
     const limited = allEntries.slice(offset, offset + args.limit);