ani-mcp 0.14.0 → 0.14.2

package/README.md

@@ -4,11 +4,11 @@
 
 # ani-mcp
 
-[![npm version](https://img.shields.io/npm/v/ani-mcp)](https://www.npmjs.com/package/ani-mcp)
+[![npm version](https://img.shields.io/npm/v/ani-mcp?color=blue)](https://www.npmjs.com/package/ani-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/ani-mcp)](https://www.npmjs.com/package/ani-mcp)
 [![CI](https://github.com/gavxm/ani-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/gavxm/ani-mcp/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Node](https://img.shields.io/node/v/ani-mcp)](https://nodejs.org)
+[![MCP Bundle](https://img.shields.io/badge/Claude_Desktop-.mcpb-blueviolet)](https://github.com/gavxm/ani-mcp/releases/latest)
 
 A smart [MCP](https://modelcontextprotocol.io) server for [AniList](https://anilist.co) that understands your anime and manga taste - not just raw API calls.
 
@@ -28,7 +28,11 @@ Plus the essentials: search, details, trending, seasonal browsing, list manageme
 
 ## Try it in 30 seconds
 
-No account needed. Paste this into your MCP client config and start asking about anime:
+No account needed. Works with any MCP-compatible client.
+
+### Claude Desktop
+
+Add to your config file (`Settings > Developer > Edit Config` or `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
 
 ```json
 {
@@ -41,9 +45,19 @@ No account needed. Paste this into your MCP client config and start asking about
 }
 ```
 
-This gives you search, trending, seasonal browsing, staff lookup, and more - no env vars required.
+Restart Claude Desktop after saving.
+
+Alternatively, download `ani-mcp.mcpb` from the [latest release](https://github.com/gavxm/ani-mcp/releases/latest) and install via `Settings > Extensions`.
 
-To unlock personalized features (recommendations, taste profiling, list management), add your username:
+### Claude Code
+
+```sh
+claude mcp add ani-mcp -- npx -y ani-mcp
+```
+
+### Personalized features
+
+Add your username for recommendations, taste profiling, and list management:
 
 ```json
 {
@@ -61,8 +75,6 @@ To unlock personalized features (recommendations, taste profiling, list manageme
 
 For write operations (updating progress, scoring, list edits), also add `ANILIST_TOKEN`. See [Environment Variables](#environment-variables) for details.
 
-Works with any MCP-compatible client.
-
 ## Environment Variables
 
 | Variable | Required | Description |
@@ -276,4 +288,4 @@ Bug reports and feature requests: [GitHub Issues](https://github.com/gavxm/ani-m
 
 ## License
 
-MIT
+[MIT](LICENSE)

package/dist/api/client.d.ts

@@ -29,8 +29,7 @@ export interface QueryOptions {
 }
 /** Manages authenticated requests to the AniList GraphQL API */
 declare class AniListClient {
-    private token;
-    constructor();
+    private get token();
     /** 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 groups with metadata (name, status, isCustomList) */

package/dist/api/client.js

@@ -74,10 +74,9 @@ export class AniListApiError extends Error {
 }
 /** 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;
+    // Read token lazily so env sanitization in index.ts runs first
+    get token() {
+        return process.env.ANILIST_TOKEN || undefined;
     }
     /** Execute a GraphQL query with caching and automatic retry */
     async query(query, variables = {}, options = {}) {

package/dist/api/queries.d.ts

@@ -5,21 +5,21 @@
  * 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    duration\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 extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+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    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      category\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 { extraLarge }\n    trailer { id site thumbnail }\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    duration\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 extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+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    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      category\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 { extraLarge }\n    trailer { id site thumbnail }\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    duration\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 extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+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    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      category\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 { extraLarge }\n    trailer { id site thumbnail }\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    duration\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 extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+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    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      category\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 { extraLarge }\n    trailer { id site thumbnail }\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      mediaListOptions {\n        scoreFormat\n      }\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    duration\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 extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+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    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      category\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 { extraLarge }\n    trailer { id site thumbnail }\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    duration\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 extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+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    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      category\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 { extraLarge }\n    trailer { id site thumbnail }\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    duration\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 extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+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    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      category\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 { extraLarge }\n    trailer { id site thumbnail }\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, $language: StaffLanguage) {\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: $language) {\n            id\n            name { full native }\n            language\n            siteUrl\n          }\n        }\n      }\n    }\n  }\n";
 /** Airing schedule for currently airing anime */
@@ -33,13 +33,13 @@ export declare const SAVE_MEDIA_LIST_ENTRY_MUTATION = "\n  mutation SaveMediaLis
 /** 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      progressVolumes\n      notes\n      private\n    }\n  }\n";
 /** Fetch a single list entry with full media details */
-export declare const LIST_LOOKUP_QUERY = "\n  query ListLookup($mediaId: Int!, $userName: String!) {\n    MediaList(mediaId: $mediaId, userName: $userName) {\n      id\n      status\n      score(format: POINT_10)\n      progress\n      progressVolumes\n      updatedAt\n      startedAt { year month day }\n      completedAt { year month day }\n      notes\n      media {\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    duration\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 extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+export declare const LIST_LOOKUP_QUERY = "\n  query ListLookup($mediaId: Int!, $userName: String!) {\n    MediaList(mediaId: $mediaId, userName: $userName) {\n      id\n      status\n      score(format: POINT_10)\n      progress\n      progressVolumes\n      updatedAt\n      startedAt { year month day }\n      completedAt { year month day }\n      notes\n      media {\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    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      category\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 { extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\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. */
-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        isCustomList\n        entries {\n          id\n          score(format: POINT_10)  # normalize to 1-10 scale regardless of user's profile setting\n          progress\n          progressVolumes\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    duration\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 extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+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        isCustomList\n        entries {\n          id\n          score(format: POINT_10)  # normalize to 1-10 scale regardless of user's profile setting\n          progress\n          progressVolumes\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    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      category\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 { extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
 /** Completed list entries filtered by date range (server-side) */
-export declare const COMPLETED_BY_DATE_QUERY = "\n  query CompletedByDate(\n    $userName: String!\n    $type: MediaType\n    $completedAfter: FuzzyDateInt\n    $completedBefore: FuzzyDateInt\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { hasNextPage }\n      mediaList(\n        userName: $userName\n        type: $type\n        status: COMPLETED\n        completedAt_greater: $completedAfter\n        completedAt_lesser: $completedBefore\n        sort: FINISHED_ON_DESC\n      ) {\n        id\n        score(format: POINT_10)\n        progress\n        progressVolumes\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  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\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 extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+export declare const COMPLETED_BY_DATE_QUERY = "\n  query CompletedByDate(\n    $userName: String!\n    $type: MediaType\n    $completedAfter: FuzzyDateInt\n    $completedBefore: FuzzyDateInt\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { hasNextPage }\n      mediaList(\n        userName: $userName\n        type: $type\n        status: COMPLETED\n        completedAt_greater: $completedAfter\n        completedAt_lesser: $completedBefore\n        sort: FINISHED_ON_DESC\n      ) {\n        id\n        score(format: POINT_10)\n        progress\n        progressVolumes\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  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      category\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 { extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
 /** Search for staff by name with their top works */
 export declare const STAFF_SEARCH_QUERY = "\n  query StaffSearch($search: String!, $page: Int, $perPage: Int, $mediaPerPage: Int) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      staff(search: $search, sort: SEARCH_MATCH) {\n        id\n        name { full native }\n        primaryOccupations\n        siteUrl\n        staffMedia(sort: POPULARITY_DESC, perPage: $mediaPerPage) {\n          edges {\n            staffRole\n            node {\n              id\n              title { romaji english }\n              format\n              type\n              meanScore\n              siteUrl\n            }\n          }\n        }\n      }\n    }\n  }\n";
 /** Authenticated user info */

package/dist/api/queries.js

@@ -27,6 +27,7 @@ const MEDIA_FRAGMENT = `
     tags {
       name
       rank
+      category
       isMediaSpoiler
     }
     season
@@ -38,7 +39,7 @@ const MEDIA_FRAGMENT = `
     }
     source
     isAdult
-    coverImage { large extraLarge }
+    coverImage { extraLarge }
     trailer { id site thumbnail }
     siteUrl
     description(asHtml: false)

package/dist/engine/analytics.d.ts

@@ -9,7 +9,7 @@ export interface GenreCalibration {
 }
 export interface CalibrationResult {
     overallDelta: number;
-    tendency: "generous" | "harsh" | "average";
+    tendency: "high" | "low" | "balanced";
     genreCalibrations: GenreCalibration[];
     totalScored: number;
 }

package/dist/engine/analytics.js

@@ -14,7 +14,7 @@ export function computeCalibration(entries) {
     if (scored.length === 0) {
         return {
             overallDelta: 0,
-            tendency: "average",
+            tendency: "balanced",
             genreCalibrations: [],
             totalScored: 0,
         };
@@ -58,10 +58,10 @@ export function computeCalibration(entries) {
     // Sort by absolute delta descending
     genreCalibrations.sort((a, b) => Math.abs(b.delta) - Math.abs(a.delta));
     const tendency = overallDelta >= 0.5
-        ? "generous"
+        ? "high"
         : overallDelta <= -0.5
-            ? "harsh"
-            : "average";
+            ? "low"
+            : "balanced";
     return {
         overallDelta,
         tendency,

package/dist/engine/card.js

@@ -65,8 +65,8 @@ function watermark(cardW, cardH) {
 /** Build an SVG taste profile card */
 export function buildTasteCardSvg(username, profile, avatarB64 = null) {
     const genres = profile.genres.slice(0, 6);
-    const tags = profile.tags.slice(0, 5);
-    const formats = profile.formats.slice(0, 4);
+    const tags = profile.themes.slice(0, 5);
+    const formats = profile.formats.slice(0, 6);
     const { scoring } = profile;
     const parts = [
         svgHeader(CARD_WIDTH, CARD_HEIGHT),
@@ -84,7 +84,7 @@ export function buildTasteCardSvg(username, profile, avatarB64 = null) {
         ...statRow(40, 74, [
             { label: "Completed", value: String(profile.totalCompleted) },
             { label: "Mean Score", value: scoring.meanScore.toFixed(1) },
-            { label: "Tendency", value: capitalize(scoring.tendency) },
+            { label: "Scoring", value: capitalize(scoring.tendency) },
             { label: "Median", value: String(scoring.median) },
         ]),
         // Radar chart (left)
@@ -295,7 +295,7 @@ function tagList(tags, x, y) {
 function formatBar(formats, x, y, totalWidth) {
     const barHeight = 16;
     const rx = 8;
-    const colors = [BRAND_BLUE, "#06d6a0", "#ffd166", "#ef476f"];
+    const colors = [BRAND_BLUE, "#06d6a0", "#ffd166", "#ef476f", "#b388ff", "#4dd0e1"];
     const lines = [];
     // Rounded container clip
     const clipId = `fbar-${x}-${y}`;

package/dist/engine/taste.d.ts

@@ -10,7 +10,7 @@ export interface ScoringPattern {
     median: number;
     totalScored: number;
     distribution: Record<number, number>;
-    tendency: "generous" | "harsh" | "average";
+    tendency: "high" | "low" | "balanced";
 }
 export interface FormatBreakdown {
     format: string;
@@ -20,6 +20,7 @@ export interface FormatBreakdown {
 export interface TasteProfile {
     genres: WeightedItem[];
     tags: WeightedItem[];
+    themes: WeightedItem[];
     scoring: ScoringPattern;
     formats: FormatBreakdown[];
     totalCompleted: number;

package/dist/engine/taste.js

@@ -9,6 +9,8 @@ const MIN_ENTRIES = 5;
 const UNSCORED = 0;
 // Cap the number of tags returned to keep output focused
 const MAX_TAGS = 20;
+// Tags must appear in at least this many entries to rank
+const MIN_TAG_COUNT = 3;
 // Recency decay: entries from HALF_LIFE years ago get ~50% weight
 const DECAY_HALF_LIFE_YEARS = 3;
 const DECAY_LAMBDA = Math.LN2 / DECAY_HALF_LIFE_YEARS;
@@ -25,12 +27,14 @@ export function buildTasteProfile(entries) {
     }
     const genres = computeGenreWeights(scored);
     const tags = computeTagWeights(scored);
+    const themes = computeTagWeights(scored, "Theme");
     const scoring = computeScoringPattern(scored);
     // Format breakdown uses all entries, not just scored ones
     const formats = computeFormatBreakdown(entries);
     return {
         genres,
         tags,
+        themes,
         scoring,
         formats,
         totalCompleted: entries.length,
@@ -60,11 +64,11 @@ export function describeTasteProfile(profile, username) {
     }
     // Scoring tendency
     const { scoring } = profile;
-    const tendencyDesc = scoring.tendency === "generous"
-        ? `Scores generously (avg ${scoring.meanScore.toFixed(1)} vs site avg ${SITE_MEAN})`
-        : scoring.tendency === "harsh"
-            ? `Scores harshly (avg ${scoring.meanScore.toFixed(1)} vs site avg ${SITE_MEAN})`
-            : `Scores close to average (avg ${scoring.meanScore.toFixed(1)})`;
+    const tendencyDesc = scoring.tendency === "high"
+        ? `Scores high (avg ${scoring.meanScore.toFixed(1)} vs site avg ${SITE_MEAN})`
+        : scoring.tendency === "low"
+            ? `Scores low (avg ${scoring.meanScore.toFixed(1)} vs site avg ${SITE_MEAN})`
+            : `Scores near average (avg ${scoring.meanScore.toFixed(1)})`;
     lines.push(`${tendencyDesc} across ${scoring.totalScored} rated titles.`);
     // Format preferences
     if (profile.formats.length > 0) {
@@ -93,13 +97,15 @@ function computeGenreWeights(entries) {
     return mapToSortedItems(genreMap);
 }
 /** Weight tags by user score multiplied by tag relevance */
-function computeTagWeights(entries) {
+function computeTagWeights(entries, categoryFilter) {
     const tagMap = new Map();
     for (const entry of entries) {
         const scoreWeight = (entry.score / 10) * computeDecay(entry);
         for (const tag of entry.media.tags) {
             if (tag.isMediaSpoiler)
                 continue;
+            if (categoryFilter && !tag.category.startsWith(categoryFilter))
+                continue;
             // Tag rank (0-100) indicates how relevant the tag is to this media
             const relevance = tag.rank / 100;
             const existing = tagMap.get(tag.name) ?? { weight: 0, count: 0 };
@@ -108,6 +114,11 @@ function computeTagWeights(entries) {
             tagMap.set(tag.name, existing);
         }
     }
+    // Filter noise (1-2 entries are never meaningful)
+    for (const [name, { count }] of tagMap) {
+        if (count < MIN_TAG_COUNT)
+            tagMap.delete(name);
+    }
     return mapToSortedItems(tagMap).slice(0, MAX_TAGS);
 }
 /** Score distribution and tendency classification */
@@ -126,10 +137,10 @@ function computeScoringPattern(entries) {
     }
     // Classify based on distance from site average (7.0)
     const tendency = mean >= SITE_MEAN + 0.5
-        ? "generous"
+        ? "high"
         : mean <= SITE_MEAN - 0.5
-            ? "harsh"
-            : "average";
+            ? "low"
+            : "balanced";
     return {
         meanScore: mean,
         median,
@@ -146,25 +157,35 @@ function computeFormatBreakdown(entries) {
         const format = entry.media.format ?? "UNKNOWN";
         counts.set(format, (counts.get(format) ?? 0) + 1);
     }
-    return [...counts.entries()]
-        .map(([format, count]) => ({
+    // Largest-remainder method so percentages sum to 100
+    const sorted = [...counts.entries()].sort((a, b) => b[1] - a[1]);
+    const rawPcts = sorted.map(([, c]) => (c / entries.length) * 100);
+    const floored = rawPcts.map(Math.floor);
+    let remainder = 100 - floored.reduce((a, b) => a + b, 0);
+    const remainders = rawPcts.map((v, i) => ({ i, r: v - floored[i] }));
+    remainders.sort((a, b) => b.r - a.r);
+    for (const { i } of remainders) {
+        if (remainder <= 0)
+            break;
+        floored[i] += 1;
+        remainder -= 1;
+    }
+    return sorted.map(([format, count], i) => ({
         format,
         count,
-        percent: Math.round((count / entries.length) * 100),
-    }))
-        .sort((a, b) => b.count - a.count);
+        percent: floored[i],
+    }));
 }
 // === Helpers ===
-/** Convert a name->weight Map into a Bayesian-smoothed sorted array */
+/** Convert a name->weight Map into a frequency-adjusted sorted array */
 function mapToSortedItems(map) {
     return [...map.entries()]
-        .map(([name, { weight, count }]) => ({
-        name,
-        // Pull sparse observations toward a neutral prior
-        weight: (weight + BAYESIAN_PRIOR_WEIGHT * BAYESIAN_PRIOR_COUNT) /
-            (count + BAYESIAN_PRIOR_COUNT),
-        count,
-    }))
+        .map(([name, { weight, count }]) => {
+        // Bayesian average (quality) scaled by log frequency (prominence)
+        const avg = (weight + BAYESIAN_PRIOR_WEIGHT * BAYESIAN_PRIOR_COUNT) /
+            (count + BAYESIAN_PRIOR_COUNT);
+        return { name, weight: avg * Math.log2(count + 1), count };
+    })
         .sort((a, b) => b.weight - a.weight);
 }
 /** Recency multiplier (0-1) - recent entries weigh more than old ones */
@@ -213,12 +234,13 @@ function emptyProfile(totalCompleted) {
     return {
         genres: [],
         tags: [],
+        themes: [],
         scoring: {
             meanScore: 0,
             median: 0,
             totalScored: 0,
             distribution: {},
-            tendency: "average",
+            tendency: "balanced",
         },
         formats: [],
         totalCompleted,

package/dist/index.js

@@ -15,6 +15,18 @@ import { registerImportTools } from "./tools/import.js";
 import { registerCardTools } from "./tools/cards.js";
 import { registerResources } from "./resources.js";
 import { registerPrompts } from "./prompts.js";
+// Sanitize env vars: clear unresolved templates, placeholders, or invalid values
+for (const key of ["ANILIST_USERNAME", "ANILIST_TOKEN"]) {
+    const val = process.env[key] ?? "";
+    if (!val || val.startsWith("${") || val === "undefined" || val === "null") {
+        process.env[key] = "";
+    }
+}
+// AniList tokens are long JWT-like strings (100+ chars)
+if (process.env.ANILIST_TOKEN && process.env.ANILIST_TOKEN.length < 30) {
+    console.warn("[ani-mcp] ANILIST_TOKEN looks invalid (too short), ignoring.");
+    process.env.ANILIST_TOKEN = "";
+}
 // Both vars are optional - warn on missing so operators know what's available
 if (!process.env.ANILIST_USERNAME) {
     console.warn("ANILIST_USERNAME not set - tools will require a username argument.");
@@ -24,7 +36,13 @@ if (!process.env.ANILIST_TOKEN) {
 }
 const server = new FastMCP({
     name: "ani-mcp",
-    version: "0.14.0",
+    version: "0.14.2",
+    instructions: "ani-mcp is a local MCP server for AniList. " +
+        "Read-only tools work without authentication. " +
+        "Write tools require ANILIST_TOKEN set in the server's environment config. " +
+        "If a tool says the token is not set, tell the user to add ANILIST_TOKEN " +
+        "to their MCP server config and restart. " +
+        "There is no in-app AniList integration or settings page to connect.",
 });
 registerSearchTools(server);
 registerListTools(server);

package/dist/tools/analytics.js

@@ -39,7 +39,7 @@ export function registerAnalyticsTools(server) {
                 ];
                 // Overall tendency
                 const sign = result.overallDelta >= 0 ? "+" : "";
-                lines.push(`Overall: ${sign}${result.overallDelta.toFixed(2)} vs community (${result.tendency} scorer)`);
+                lines.push(`Overall: ${sign}${result.overallDelta.toFixed(2)} vs community (${result.tendency} scorer vs avg)`);
                 // Per-genre breakdown
                 if (result.genreCalibrations.length > 0) {
                     lines.push("", "Per-genre bias (biggest deviations first):");
@@ -200,10 +200,13 @@ export function registerAnalyticsTools(server) {
                 let frontier = [...allIds];
                 const maxRounds = 3;
                 for (let round = 0; round < maxRounds && frontier.length > 0; round++) {
-                    // Process in chunks of 50
+                    // Fetch all chunks in parallel (rate limiter queues excess)
+                    const chunks = [];
                     for (let i = 0; i < frontier.length; i += 50) {
-                        const chunk = frontier.slice(i, i + 50);
-                        const data = await anilistClient.query(BATCH_RELATIONS_QUERY, { ids: chunk }, { cache: "media" });
+                        chunks.push(frontier.slice(i, i + 50));
+                    }
+                    const results = await Promise.all(chunks.map((chunk) => anilistClient.query(BATCH_RELATIONS_QUERY, { ids: chunk }, { cache: "media" })));
+                    for (const data of results) {
                         for (const media of data.Page.media) {
                             if (!relationsMap.has(media.id)) {
                                 relationsMap.set(media.id, media);

package/dist/tools/cards.js

@@ -26,7 +26,11 @@ export function registerCardTools(server) {
         },
         execute: async (args) => {
             const username = args.username ?? getDefaultUsername();
-            const entries = await anilistClient.fetchList(username, args.type, "COMPLETED");
+            // Fetch list and avatar in parallel
+            const [entries, avatarUrl] = await Promise.all([
+                anilistClient.fetchList(username, args.type, "COMPLETED"),
+                getAvatarUrl(username),
+            ]);
             if (entries.length === 0) {
                 return `${username} has no completed ${args.type.toLowerCase()}.`;
             }
@@ -42,8 +46,6 @@ export function registerCardTools(server) {
                 throw new UserError(`${username} doesn't have enough scored titles to generate a card. ` +
                     `Score more titles on AniList for a taste card.`);
             }
-            // Fetch avatar in parallel with nothing else, but keep it non-blocking
-            const avatarUrl = await getAvatarUrl(username);
             const avatarB64 = avatarUrl ? await fetchAvatarB64(avatarUrl) : null;
             const svg = buildTasteCardSvg(username, profile, avatarB64);
             const png = await svgToPng(svg);

package/dist/tools/discover.js

@@ -136,7 +136,7 @@ export function registerDiscoverTools(server) {
                     for (const tag of tags) {
                         const cat = tag.category || "Other";
                         if (args.category &&
-                            cat.toLowerCase() !== args.category.toLowerCase())
+                            !cat.toLowerCase().startsWith(args.category.toLowerCase()))
                             continue;
                         const list = categories.get(cat);
                         if (list) {

package/dist/tools/import.js

@@ -179,7 +179,7 @@ function kitsuEntriesToAniList(entries, animeMap) {
                 studios: { nodes: [] },
                 source: null,
                 isAdult: false,
-                coverImage: { large: null, extraLarge: null },
+                coverImage: { extraLarge: null },
                 trailer: null,
                 siteUrl: `https://kitsu.io/anime/${animeId}`,
                 description: null,

package/dist/tools/info.js

@@ -224,13 +224,13 @@ export function registerInfoTools(server) {
                 }
                 // Extract media IDs for batch airing lookup
                 const mediaIds = entries.map((e) => e.media.id);
-                // Batch-fetch airing info (50 per page max)
-                const airingMedia = [];
+                // Batch-fetch airing info in parallel (50 per page max)
+                const batches = [];
                 for (let i = 0; i < mediaIds.length; i += 50) {
-                    const batch = mediaIds.slice(i, i + 50);
-                    const data = await anilistClient.query(BATCH_AIRING_QUERY, { ids: batch, perPage: 50 }, { cache: "schedule" });
-                    airingMedia.push(...data.Page.media);
+                    batches.push(mediaIds.slice(i, i + 50));
                 }
+                const airingResults = await Promise.all(batches.map((batch) => anilistClient.query(BATCH_AIRING_QUERY, { ids: batch, perPage: 50 }, { cache: "schedule" })));
+                const airingMedia = airingResults.flatMap((d) => d.Page.media);
                 // Map media ID to user progress
                 const progressMap = new Map(entries.map((e) => [e.media.id, e.progress]));
                 // Sort by nearest airing time

package/dist/tools/recommend.js

@@ -1,9 +1,8 @@
 /** Recommendation tools: taste profiling, personalized picks, and user comparison. */
 import { anilistClient } from "../api/client.js";
-import { BATCH_RELATIONS_QUERY, COMPLETED_BY_DATE_QUERY, DISCOVER_MEDIA_QUERY, MEDIA_DETAILS_QUERY, RECOMMENDATIONS_QUERY, SEASONAL_MEDIA_QUERY, } from "../api/queries.js";
+import { BATCH_RELATIONS_QUERY, COMPLETED_BY_DATE_QUERY, DISCOVER_MEDIA_QUERY, MEDIA_DETAILS_QUERY, RECOMMENDATIONS_QUERY, SEARCH_MEDIA_QUERY, SEASONAL_MEDIA_QUERY, } from "../api/queries.js";
 import { TasteInputSchema, PickInputSchema, SessionInputSchema, SequelAlertInputSchema, WatchOrderInputSchema, CompareInputSchema, WrappedInputSchema, ExplainInputSchema, SimilarInputSchema, } from "../schemas.js";
 import { getTitle, getDefaultUsername, throwToolError, isNsfwEnabled, resolveSeasonYear, resolveAlias, } from "../utils.js";
-import { SEARCH_MEDIA_QUERY } from "../api/queries.js";
 import { buildTasteProfile, describeTasteProfile, formatTasteProfileText, } from "../engine/taste.js";
 import { matchCandidates, explainMatch } from "../engine/matcher.js";
 import { parseMood, hasMoodMatch, seasonalMoodSuggestions, } from "../engine/mood.js";
@@ -662,9 +661,9 @@ export function registerRecommendTools(server) {
                 // Server-side date filter (FuzzyDateInt format: YYYYMMDD)
                 const completedAfter = year * 10000 + 100 + 1; // Jan 1
                 const completedBefore = year * 10000 + 1231; // Dec 31
-                // Paginate through results
-                const yearEntries = [];
-                for (const type of types) {
+                // Paginate through results (types fetched in parallel)
+                async function fetchType(type) {
+                    const results = [];
                     let page = 1;
                     let hasNext = true;
                     while (hasNext) {
@@ -676,11 +675,13 @@ export function registerRecommendTools(server) {
                             page,
                             perPage: 50,
                         }, { cache: "list" });
-                        yearEntries.push(...data.Page.mediaList);
+                        results.push(...data.Page.mediaList);
                         hasNext = data.Page.pageInfo.hasNextPage;
                         page++;
                     }
+                    return results;
                 }
+                const yearEntries = (await Promise.all(types.map(fetchType))).flat();
                 if (yearEntries.length === 0) {
                     return `${username} didn't complete any titles in ${year}.`;
                 }

package/dist/tools/search.js

@@ -147,7 +147,7 @@ export function registerSearchTools(server) {
                     }
                 }
                 // Cover image
-                const cover = m.coverImage?.extraLarge ?? m.coverImage?.large;
+                const cover = m.coverImage?.extraLarge;
                 if (cover)
                     lines.push("", `Cover: ${cover}`);
                 // Trailer

package/dist/types.d.ts

@@ -9,6 +9,7 @@ export interface AniListDate {
 export interface AniListTag {
     name: string;
     rank: number;
+    category: string;
     isMediaSpoiler: boolean;
 }
 /** Core media object shared across all query responses */
@@ -43,7 +44,6 @@ export interface AniListMedia {
     source: string | null;
     isAdult: boolean;
     coverImage: {
-        large: string | null;
         extraLarge: string | null;
     };
     trailer: {

package/dist/utils.js

@@ -130,7 +130,7 @@ export function formatMediaSummary(media) {
     if (studios)
         lines.push(`  Studio: ${studios}`);
     // Best available cover image
-    const cover = media.coverImage?.extraLarge ?? media.coverImage?.large;
+    const cover = media.coverImage?.extraLarge;
     if (cover)
         lines.push(`  Cover: ${cover}`);
     // Trailer link

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": "0.3",
   "name": "ani-mcp",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "display_name": "AniList MCP",
   "description": "A smart MCP server for AniList that gets your anime/manga taste - not just API calls.",
   "author": {
@@ -36,13 +36,13 @@
     "anilist_username": {
       "type": "string",
       "title": "AniList Username",
-      "description": "Default AniList username for list and stats tools",
+      "description": "Optional. Your AniList username so tools don't need to ask each time.",
       "required": false
     },
     "anilist_token": {
       "type": "string",
       "title": "AniList Token",
-      "description": "AniList OAuth token for write operations (update progress, rate, etc.)",
+      "description": "Optional. Your AniList API token for write features (rate, update progress, etc.).",
       "required": false,
       "sensitive": true
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ani-mcp",
   "mcpName": "io.github.gavxm/ani-mcp",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "description": "A smart [MCP](https://modelcontextprotocol.io) server for [AniList](https://anilist.co) that gets your anime/manga taste - not just API calls.",
   "type": "module",
   "main": "dist/index.js",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/gavxm/ani-mcp",
     "source": "github"
   },
-  "version": "0.14.0",
+  "version": "0.14.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "ani-mcp",
-      "version": "0.14.0",
+      "version": "0.14.2",
       "transport": {
         "type": "stdio"
       },