ani-mcp 0.8.3 → 0.9.0

package/README.md

@@ -95,6 +95,7 @@ Works with any MCP-compatible client.
 | `anilist_sequels` | Sequels airing this season for titles you've completed |
 | `anilist_watch_order` | Viewing order for a franchise |
 | `anilist_session` | Plan a viewing session within a time budget |
+| `anilist_mal_import` | Import a MyAnimeList user's list and generate recommendations |
 
 ### Info
 
@@ -104,6 +105,7 @@ Works with any MCP-compatible client.
 | `anilist_staff_search` | Search for a person by name and see all their works |
 | `anilist_studio_search` | Search for a studio and see their productions |
 | `anilist_schedule` | Airing schedule and next episode countdown |
+| `anilist_airing` | Upcoming episodes for titles you're currently watching |
 | `anilist_characters` | Search characters by name with appearances and VAs |
 | `anilist_whoami` | Check authentication status and score format |
 

package/dist/api/mal-client.d.ts

@@ -0,0 +1,23 @@
+/** Jikan (MyAnimeList) API client for read-only list import */
+export interface JikanAnimeEntry {
+    score: number;
+    episodes_watched: number;
+    anime: {
+        mal_id: number;
+        title: string;
+        type: string;
+        episodes: number | null;
+        score: number | null;
+        genres: Array<{
+            mal_id: number;
+            name: string;
+        }>;
+        year: number | null;
+    };
+}
+/** Map a MAL genre name to its AniList equivalent */
+export declare function mapMalGenre(name: string): string;
+/** Map a MAL format string to AniList format */
+export declare function mapMalFormat(malType: string): string;
+/** Fetch a MAL user's completed anime list via Jikan */
+export declare function fetchMalList(username: string, maxPages?: number): Promise<JikanAnimeEntry[]>;

package/dist/api/mal-client.js

@@ -0,0 +1,61 @@
+/** Jikan (MyAnimeList) API client for read-only list import */
+import pThrottle from "p-throttle";
+import pRetry, { AbortError } from "p-retry";
+const JIKAN_BASE = "https://api.jikan.moe/v4";
+const FETCH_TIMEOUT_MS = 15_000;
+// Jikan rate limit: 3 req/sec (unauthenticated)
+const throttle = pThrottle({
+    limit: process.env.VITEST ? 10_000 : 3,
+    interval: 1_000,
+});
+const throttled = throttle(() => { });
+// === Genre Mapping ===
+// MAL and AniList share most genre names; only map exceptions
+const MAL_TO_ANILIST_GENRE = {
+    "Sci-Fi": "Sci-Fi",
+    "Slice of Life": "Slice of Life",
+};
+/** Map a MAL genre name to its AniList equivalent */
+export function mapMalGenre(name) {
+    return MAL_TO_ANILIST_GENRE[name] ?? name;
+}
+/** Map a MAL format string to AniList format */
+export function mapMalFormat(malType) {
+    const map = {
+        TV: "TV",
+        Movie: "MOVIE",
+        OVA: "OVA",
+        ONA: "ONA",
+        Special: "SPECIAL",
+        Music: "MUSIC",
+    };
+    return map[malType] ?? "TV";
+}
+// === Client ===
+/** Fetch a MAL user's completed anime list via Jikan */
+export async function fetchMalList(username, maxPages = 5) {
+    const entries = [];
+    for (let page = 1; page <= maxPages; page++) {
+        const data = await fetchPage(username, page);
+        entries.push(...data.data);
+        if (!data.pagination.has_next_page)
+            break;
+    }
+    return entries;
+}
+async function fetchPage(username, page) {
+    return pRetry(async () => {
+        await throttled();
+        const url = `${JIKAN_BASE}/users/${encodeURIComponent(username)}/animelist?status=completed&page=${page}`;
+        const response = await fetch(url, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            if (response.status === 404) {
+                throw new AbortError(`MAL user "${username}" not found.`);
+            }
+            throw new Error(`Jikan API error (HTTP ${response.status})`);
+        }
+        return (await response.json());
+    }, { retries: 3 });
+}

package/dist/api/queries.d.ts

@@ -5,35 +5,37 @@
  * 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 }\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      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";
 /** 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 }\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      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";
 /** 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 }\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      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";
 /** 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 }\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      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";
 /** 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 }\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      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";
 /** 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 }\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      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";
 /** 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 }\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      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";
 /** 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";
+/** Batch-fetch next airing episodes for multiple media IDs */
+export declare const BATCH_AIRING_QUERY = "\n  query BatchAiring($ids: [Int], $perPage: Int) {\n    Page(perPage: $perPage) {\n      media(id_in: $ids, status: RELEASING) {\n        id\n        title { romaji english native }\n        format\n        episodes\n        nextAiringEpisode {\n          episode\n          airingAt\n          timeUntilAiring\n        }\n        siteUrl\n      }\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";
 /** 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";
+export declare const SAVE_MEDIA_LIST_ENTRY_MUTATION = "\n  mutation SaveMediaListEntry(\n    $mediaId: Int\n    $status: MediaListStatus\n    $scoreRaw: Int\n    $progress: Int\n    $progressVolumes: Int\n    $notes: String\n    $private: Boolean\n  ) {\n    SaveMediaListEntry(\n      mediaId: $mediaId\n      status: $status\n      scoreRaw: $scoreRaw\n      progress: $progress\n      progressVolumes: $progressVolumes\n      notes: $notes\n      private: $private\n    ) {\n      id\n      mediaId\n      status\n      score(format: POINT_10)\n      progress\n      progressVolumes\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";
+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";
 /** 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          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 }\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      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";
 /** 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

@@ -38,7 +38,8 @@ const MEDIA_FRAGMENT = `
     }
     source
     isAdult
-    coverImage { large }
+    coverImage { large extraLarge }
+    trailer { id site thumbnail }
     siteUrl
     description(asHtml: false)
   }
@@ -336,6 +337,25 @@ export const AIRING_SCHEDULE_QUERY = `
     }
   }
 `;
+/** Batch-fetch next airing episodes for multiple media IDs */
+export const BATCH_AIRING_QUERY = `
+  query BatchAiring($ids: [Int], $perPage: Int) {
+    Page(perPage: $perPage) {
+      media(id_in: $ids, status: RELEASING) {
+        id
+        title { romaji english native }
+        format
+        episodes
+        nextAiringEpisode {
+          episode
+          airingAt
+          timeUntilAiring
+        }
+        siteUrl
+      }
+    }
+  }
+`;
 /** Search for characters by name */
 export const CHARACTER_SEARCH_QUERY = `
   query CharacterSearch($search: String!, $page: Int, $perPage: Int) {
@@ -375,6 +395,7 @@ export const SAVE_MEDIA_LIST_ENTRY_MUTATION = `
     $status: MediaListStatus
     $scoreRaw: Int
     $progress: Int
+    $progressVolumes: Int
     $notes: String
     $private: Boolean
   ) {
@@ -383,6 +404,7 @@ export const SAVE_MEDIA_LIST_ENTRY_MUTATION = `
       status: $status
       scoreRaw: $scoreRaw
       progress: $progress
+      progressVolumes: $progressVolumes
       notes: $notes
       private: $private
     ) {
@@ -391,6 +413,7 @@ export const SAVE_MEDIA_LIST_ENTRY_MUTATION = `
       status
       score(format: POINT_10)
       progress
+      progressVolumes
     }
   }
 `;
@@ -403,6 +426,7 @@ export const MEDIA_LIST_ENTRY_QUERY = `
       status
       score(format: POINT_10)
       progress
+      progressVolumes
       notes
       private
     }
@@ -438,6 +462,7 @@ export const USER_LIST_QUERY = `
           id
           score(format: POINT_10)  # normalize to 1-10 scale regardless of user's profile setting
           progress
+          progressVolumes
           status
           updatedAt
           startedAt { year month day }

package/dist/engine/taste.d.ts

@@ -28,3 +28,5 @@ export interface TasteProfile {
 export declare function buildTasteProfile(entries: AniListMediaListEntry[]): TasteProfile;
 /** Summarize a taste profile as natural language */
 export declare function describeTasteProfile(profile: TasteProfile, username: string): string;
+/** Detailed profile breakdown: genre weights, top themes, score distribution */
+export declare function formatTasteProfileText(profile: TasteProfile): string[];

package/dist/engine/taste.js

@@ -177,6 +177,37 @@ function computeDecay(entry) {
     const yearsSince = (now - epoch) / (365.25 * 24 * 3600);
     return Math.exp(-DECAY_LAMBDA * Math.max(0, yearsSince));
 }
+/** Detailed profile breakdown: genre weights, top themes, score distribution */
+export function formatTasteProfileText(profile) {
+    const lines = [];
+    // Detailed genre breakdown
+    if (profile.genres.length > 0) {
+        lines.push("", "Genre Weights (higher = stronger preference):");
+        for (const g of profile.genres.slice(0, 10)) {
+            lines.push(`  ${g.name}: ${g.weight.toFixed(2)} (${g.count} titles)`);
+        }
+    }
+    // Detailed tag breakdown
+    if (profile.tags.length > 0) {
+        lines.push("", "Top Themes:");
+        for (const t of profile.tags.slice(0, 10)) {
+            lines.push(`  ${t.name}: ${t.weight.toFixed(2)} (${t.count} titles)`);
+        }
+    }
+    // Score distribution bar chart
+    if (profile.scoring.totalScored > 0) {
+        lines.push("", "Score Distribution:");
+        for (let s = 10; s >= 1; s--) {
+            const count = profile.scoring.distribution[s] ?? 0;
+            if (count > 0) {
+                // Cap at 30 chars
+                const bar = "#".repeat(Math.min(count, 30));
+                lines.push(`  ${s}/10: ${bar} (${count})`);
+            }
+        }
+    }
+    return lines;
+}
 /** Empty profile for users with too few scored entries */
 function emptyProfile(totalCompleted) {
     return {

package/dist/engine/undo.d.ts

@@ -5,6 +5,7 @@ export interface EntrySnapshot {
     status: string;
     score: number;
     progress: number;
+    progressVolumes: number;
     notes: string | null;
     private: boolean;
 }

package/dist/index.js

@@ -10,6 +10,7 @@ import { registerInfoTools } from "./tools/info.js";
 import { registerWriteTools } from "./tools/write.js";
 import { registerSocialTools } from "./tools/social.js";
 import { registerAnalyticsTools } from "./tools/analytics.js";
+import { registerImportTools } from "./tools/import.js";
 import { registerResources } from "./resources.js";
 import { registerPrompts } from "./prompts.js";
 // Both vars are optional - warn on missing so operators know what's available
@@ -21,7 +22,7 @@ if (!process.env.ANILIST_TOKEN) {
 }
 const server = new FastMCP({
     name: "ani-mcp",
-    version: "0.8.3",
+    version: "0.9.0",
 });
 registerSearchTools(server);
 registerListTools(server);
@@ -31,6 +32,7 @@ registerInfoTools(server);
 registerWriteTools(server);
 registerSocialTools(server);
 registerAnalyticsTools(server);
+registerImportTools(server);
 registerResources(server);
 registerPrompts(server);
 // === Transport ===

package/dist/resources.js

@@ -1,7 +1,7 @@
 /** MCP Resources: expose user context without tool calls */
 import { anilistClient } from "./api/client.js";
 import { USER_PROFILE_QUERY } from "./api/queries.js";
-import { buildTasteProfile, describeTasteProfile, } from "./engine/taste.js";
+import { buildTasteProfile, describeTasteProfile, formatTasteProfileText, } from "./engine/taste.js";
 import { formatProfile } from "./tools/social.js";
 import { formatListEntry } from "./tools/lists.js";
 import { getDefaultUsername, getScoreFormat } from "./utils.js";
@@ -99,31 +99,7 @@ function formatTasteProfile(profile, username) {
         `# Taste Profile: ${username}`,
         "",
         describeTasteProfile(profile, username),
+        ...formatTasteProfileText(profile),
     ];
-    // Detailed genre breakdown
-    if (profile.genres.length > 0) {
-        lines.push("", "Genre Weights (higher = stronger preference):");
-        for (const g of profile.genres.slice(0, 10)) {
-            lines.push(`  ${g.name}: ${g.weight.toFixed(2)} (${g.count} titles)`);
-        }
-    }
-    // Detailed tag breakdown
-    if (profile.tags.length > 0) {
-        lines.push("", "Top Themes:");
-        for (const t of profile.tags.slice(0, 10)) {
-            lines.push(`  ${t.name}: ${t.weight.toFixed(2)} (${t.count} titles)`);
-        }
-    }
-    // Score distribution
-    if (profile.scoring.totalScored > 0) {
-        lines.push("", "Score Distribution:");
-        for (let s = 10; s >= 1; s--) {
-            const count = profile.scoring.distribution[s] ?? 0;
-            if (count > 0) {
-                const bar = "#".repeat(Math.min(count, 30));
-                lines.push(`  ${s}/10: ${bar} (${count})`);
-            }
-        }
-    }
     return lines.join("\n");
 }

package/dist/schemas.d.ts

@@ -229,6 +229,18 @@ export declare const ScheduleInputSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ScheduleInput = z.infer<typeof ScheduleInputSchema>;
+/** Input for airing tracker across currently watching titles */
+export declare const AiringTrackerInputSchema: z.ZodObject<{
+    username: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type AiringTrackerInput = z.infer<typeof AiringTrackerInputSchema>;
+/** Input for importing a MyAnimeList user's list for recommendations */
+export declare const MalImportInputSchema: z.ZodObject<{
+    malUsername: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type MalImportInput = z.infer<typeof MalImportInputSchema>;
 /** Input for character search */
 export declare const CharacterSearchInputSchema: z.ZodObject<{
     query: z.ZodString;
@@ -247,6 +259,7 @@ export type RecommendationsInput = z.infer<typeof RecommendationsInputSchema>;
 export declare const UpdateProgressInputSchema: z.ZodObject<{
     mediaId: z.ZodNumber;
     progress: z.ZodNumber;
+    volumeProgress: z.ZodOptional<z.ZodNumber>;
     status: z.ZodOptional<z.ZodEnum<{
         CURRENT: "CURRENT";
         COMPLETED: "COMPLETED";

package/dist/schemas.js

@@ -389,6 +389,34 @@ export const ScheduleInputSchema = z
     .refine((data) => data.id !== undefined || data.title !== undefined, {
     message: "Provide either an id or a title.",
 });
+/** Input for airing tracker across currently watching titles */
+export const AiringTrackerInputSchema = z.object({
+    username: usernameSchema
+        .optional()
+        .describe("AniList username. Falls back to configured default if not provided."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(20)
+        .describe("Max titles to show (default 20, max 50)"),
+});
+/** Input for importing a MyAnimeList user's list for recommendations */
+export const MalImportInputSchema = z.object({
+    malUsername: z
+        .string()
+        .min(2)
+        .max(20)
+        .describe("MyAnimeList username to import"),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(15)
+        .default(5)
+        .describe("Number of recommendations to return (default 5, max 15)"),
+});
 /** Input for character search */
 export const CharacterSearchInputSchema = z.object({
     query: z
@@ -432,6 +460,12 @@ export const UpdateProgressInputSchema = z.object({
         .int()
         .min(0)
         .describe("Episode or chapter number reached"),
+    volumeProgress: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe("Volume number reached (manga only)"),
     status: z
         .enum(["CURRENT", "COMPLETED", "PAUSED", "DROPPED", "REPEATING"])
         .optional()
@@ -468,7 +502,7 @@ export const RateInputSchema = z.object({
         .number()
         .min(0)
         .max(10)
-        .describe("Score on a 0-10 scale. Use 0 to remove a score."),
+        .describe("Score on a 0-10 scale (decimals like 7.5 are supported). Use 0 to remove a score."),
 });
 /** Input for removing a title from the list */
 export const DeleteFromListInputSchema = z
@@ -498,10 +532,7 @@ export const ExplainInputSchema = z
         .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"),
+    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."),
@@ -526,10 +557,7 @@ export const SimilarInputSchema = z
         .positive()
         .optional()
         .describe("AniList media ID to find similar titles for"),
-    title: z
-        .string()
-        .optional()
-        .describe("Search by title if no ID is known"),
+    title: z.string().optional().describe("Search by title if no ID is known"),
     limit: z
         .number()
         .int()

package/dist/tools/import.d.ts

@@ -0,0 +1,4 @@
+/** Import tools: cross-platform list import for recommendations */
+import type { FastMCP } from "fastmcp";
+/** Register import tools on the MCP server */
+export declare function registerImportTools(server: FastMCP): void;

package/dist/tools/import.js

@@ -0,0 +1,134 @@
+/** Import tools: cross-platform list import for recommendations */
+import { fetchMalList, mapMalGenre, mapMalFormat, } from "../api/mal-client.js";
+import { anilistClient } from "../api/client.js";
+import { DISCOVER_MEDIA_QUERY } from "../api/queries.js";
+import { MalImportInputSchema } from "../schemas.js";
+import { throwToolError, formatMediaSummary } from "../utils.js";
+import { buildTasteProfile, describeTasteProfile, formatTasteProfileText, } from "../engine/taste.js";
+import { matchCandidates } from "../engine/matcher.js";
+// === Tool Registration ===
+/** Register import tools on the MCP server */
+export function registerImportTools(server) {
+    server.addTool({
+        name: "anilist_mal_import",
+        description: "Import a MyAnimeList user's completed anime list and generate " +
+            "personalized recommendations based on their taste. No MAL auth needed. " +
+            "Use when the user mentions their MAL account or wants recs from MAL history. " +
+            "Returns a taste profile summary and recommended titles from AniList.",
+        parameters: MalImportInputSchema,
+        annotations: {
+            title: "MAL Import",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+        execute: async (args) => {
+            try {
+                // Fetch MAL list via Jikan
+                const malEntries = await fetchMalList(args.malUsername);
+                if (malEntries.length === 0) {
+                    return `No completed anime found for MAL user "${args.malUsername}".`;
+                }
+                // Convert to AniList-compatible format for taste engine
+                const converted = malEntriesToAniList(malEntries);
+                // Build taste profile
+                const profile = buildTasteProfile(converted);
+                const lines = [
+                    `# MAL Import: ${args.malUsername}`,
+                    `Imported ${malEntries.length} completed anime from MyAnimeList.`,
+                    "",
+                    "## Taste Profile",
+                    describeTasteProfile(profile, args.malUsername),
+                    ...formatTasteProfileText(profile),
+                ];
+                // Fetch AniList candidates using top genres
+                const topGenres = profile.genres.slice(0, 3).map((g) => g.name);
+                if (topGenres.length > 0) {
+                    const candidates = await fetchDiscoverCandidates(topGenres);
+                    // Filter out titles already on the MAL list
+                    const malIds = new Set(malEntries.map((e) => e.anime.mal_id));
+                    const filtered = candidates.filter((m) => !malIds.has(m.id));
+                    // Score against taste profile
+                    const ranked = matchCandidates(filtered, profile).slice(0, args.limit);
+                    lines.push("", "## Recommendations", "");
+                    if (ranked.length === 0) {
+                        lines.push("No new recommendations found.");
+                    }
+                    else {
+                        for (let i = 0; i < ranked.length; i++) {
+                            const r = ranked[i];
+                            lines.push(`${i + 1}. ${formatMediaSummary(r.media)}`);
+                            if (r.reasons.length > 0) {
+                                lines.push(`  Why: ${r.reasons.slice(0, 3).join(", ")}`);
+                            }
+                            lines.push("");
+                        }
+                    }
+                }
+                return lines.join("\n");
+            }
+            catch (error) {
+                return throwToolError(error, "importing MAL list");
+            }
+        },
+    });
+}
+// === Helpers ===
+// Convert MAL entries to AniList format for the taste engine
+function malEntriesToAniList(entries) {
+    return entries
+        .filter((e) => e.score > 0)
+        .map((e) => ({
+        id: e.anime.mal_id,
+        score: e.score,
+        progress: e.episodes_watched,
+        progressVolumes: 0,
+        status: "COMPLETED",
+        updatedAt: 0,
+        startedAt: { year: null, month: null, day: null },
+        completedAt: { year: null, month: null, day: null },
+        notes: null,
+        media: {
+            id: e.anime.mal_id,
+            type: "ANIME",
+            title: {
+                romaji: e.anime.title,
+                english: e.anime.title,
+                native: null,
+            },
+            format: mapMalFormat(e.anime.type),
+            status: "FINISHED",
+            episodes: e.anime.episodes,
+            duration: null,
+            chapters: null,
+            volumes: null,
+            meanScore: e.anime.score ? e.anime.score * 10 : null,
+            averageScore: null,
+            popularity: null,
+            genres: e.anime.genres.map((g) => mapMalGenre(g.name)),
+            tags: [],
+            season: null,
+            seasonYear: e.anime.year,
+            startDate: { year: e.anime.year, month: null, day: null },
+            endDate: { year: null, month: null, day: null },
+            studios: { nodes: [] },
+            source: null,
+            isAdult: false,
+            coverImage: { large: null, extraLarge: null },
+            trailer: null,
+            siteUrl: `https://myanimelist.net/anime/${e.anime.mal_id}`,
+            description: null,
+        },
+    }));
+}
+// Fetch AniList discover candidates matching top taste genres
+async function fetchDiscoverCandidates(genres) {
+    const data = await anilistClient.query(DISCOVER_MEDIA_QUERY, {
+        type: "ANIME",
+        genre_in: genres,
+        perPage: 50,
+        page: 1,
+        sort: ["POPULARITY_DESC"],
+    }, { cache: "search" });
+    return data.Page.media;
+}

package/dist/tools/info.js

@@ -1,9 +1,9 @@
 /** Info tools: staff credits, airing schedule, character search, and auth check. */
 import { z } from "zod";
 import { anilistClient } from "../api/client.js";
-import { STAFF_QUERY, AIRING_SCHEDULE_QUERY, CHARACTER_SEARCH_QUERY, STAFF_SEARCH_QUERY, STUDIO_SEARCH_QUERY, VIEWER_QUERY, } from "../api/queries.js";
-import { StaffInputSchema, ScheduleInputSchema, CharacterSearchInputSchema, StaffSearchInputSchema, StudioSearchInputSchema, } from "../schemas.js";
-import { getTitle, throwToolError, paginationFooter } from "../utils.js";
+import { STAFF_QUERY, AIRING_SCHEDULE_QUERY, BATCH_AIRING_QUERY, CHARACTER_SEARCH_QUERY, STAFF_SEARCH_QUERY, STUDIO_SEARCH_QUERY, VIEWER_QUERY, } from "../api/queries.js";
+import { StaffInputSchema, ScheduleInputSchema, AiringTrackerInputSchema, CharacterSearchInputSchema, StaffSearchInputSchema, StudioSearchInputSchema, } from "../schemas.js";
+import { getTitle, getDefaultUsername, throwToolError, paginationFooter, } from "../utils.js";
 // === Helpers ===
 /** Format seconds until airing as a readable duration */
 function formatTimeUntil(seconds) {
@@ -196,6 +196,76 @@ export function registerInfoTools(server) {
             }
         },
     });
+    // === Airing Tracker ===
+    server.addTool({
+        name: "anilist_airing",
+        description: "Show upcoming episodes for all anime you're currently watching. " +
+            "Use when the user asks what's airing soon, what episodes are coming up, " +
+            "or wants a watchlist calendar. " +
+            "Returns titles sorted by next airing time with episode number and countdown.",
+        parameters: AiringTrackerInputSchema,
+        annotations: {
+            title: "Airing Tracker",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+        execute: async (args) => {
+            try {
+                const username = getDefaultUsername(args.username);
+                // Fetch currently watching anime
+                const entries = await anilistClient.fetchList(username, "ANIME", "CURRENT");
+                if (!entries.length) {
+                    return `${username} is not currently watching any anime.`;
+                }
+                // 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 = [];
+                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);
+                }
+                // Map media ID to user progress
+                const progressMap = new Map(entries.map((e) => [e.media.id, e.progress]));
+                // Sort by nearest airing time
+                const airing = airingMedia
+                    .filter((m) => m.nextAiringEpisode)
+                    .sort((a, b) => (a.nextAiringEpisode?.timeUntilAiring ?? Infinity) -
+                    (b.nextAiringEpisode?.timeUntilAiring ?? Infinity))
+                    .slice(0, args.limit);
+                const notAiringCount = entries.length - airingMedia.length;
+                const lines = [
+                    `# Airing tracker for ${username}`,
+                    `${entries.length} currently watching, ${airing.length} with upcoming episodes`,
+                    "",
+                ];
+                for (const m of airing) {
+                    const next = m.nextAiringEpisode;
+                    if (!next)
+                        continue;
+                    const title = getTitle(m.title);
+                    const date = new Date(next.airingAt * 1000);
+                    const dateStr = date.toLocaleDateString("en-US", {
+                        weekday: "short",
+                        month: "short",
+                        day: "numeric",
+                    });
+                    const totalEp = m.episodes ? `/${m.episodes}` : "";
+                    const userProgress = progressMap.get(m.id) ?? 0;
+                    lines.push(`${title} (${m.format ?? "?"})`, `  Ep ${next.episode}${totalEp} - ${dateStr} (${formatTimeUntil(next.timeUntilAiring)})`, `  Your progress: ${userProgress}${totalEp} ep`, "");
+                }
+                if (notAiringCount > 0) {
+                    lines.push(`${notAiringCount} title(s) not currently airing.`);
+                }
+                return lines.join("\n");
+            }
+            catch (error) {
+                return throwToolError(error, "tracking airing schedule");
+            }
+        },
+    });
     // === Character Search ===
     server.addTool({
         name: "anilist_characters",

package/dist/tools/lists.js

@@ -204,10 +204,14 @@ export function formatListEntry(entry, index, scoreFmt) {
     const media = entry.media;
     const title = getTitle(media.title);
     const format = media.format ?? "?";
-    // Progress string (e.g. "5/12 ep" or "30/? ch")
+    // Progress string (e.g. "5/12 ep" or "30/? ch, 5/20 vol")
     const total = media.episodes ?? media.chapters ?? "?";
     const unit = media.episodes !== null ? "ep" : "ch";
-    const progress = `${entry.progress}/${total} ${unit}`;
+    let progress = `${entry.progress}/${total} ${unit}`;
+    if (entry.progressVolumes > 0) {
+        const totalVol = media.volumes ?? "?";
+        progress += `, ${entry.progressVolumes}/${totalVol} vol`;
+    }
     const score = formatScore(entry.score, scoreFmt);
     const updated = entry.updatedAt
         ? new Date(entry.updatedAt * 1000).toLocaleDateString("en-US", {

package/dist/tools/recommend.js

@@ -4,7 +4,7 @@ import { BATCH_RELATIONS_QUERY, DISCOVER_MEDIA_QUERY, MEDIA_DETAILS_QUERY, RECOM
 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, } from "../engine/taste.js";
+import { buildTasteProfile, describeTasteProfile, formatTasteProfileText, } from "../engine/taste.js";
 import { matchCandidates, explainMatch } from "../engine/matcher.js";
 import { parseMood, hasMoodMatch, seasonalMoodSuggestions, } from "../engine/mood.js";
 import { computeCompatibility, computeGenreDivergences, findCrossRecs, } from "../engine/compare.js";
@@ -80,33 +80,8 @@ export function registerRecommendTools(server) {
                     `# Taste Profile: ${username}`,
                     "",
                     describeTasteProfile(profile, username),
+                    ...formatTasteProfileText(profile),
                 ];
-                // Detailed genre breakdown
-                if (profile.genres.length > 0) {
-                    lines.push("", "Genre Weights (higher = stronger preference):");
-                    for (const g of profile.genres.slice(0, 10)) {
-                        lines.push(`  ${g.name}: ${g.weight.toFixed(2)} (${g.count} titles)`);
-                    }
-                }
-                // Detailed tag breakdown
-                if (profile.tags.length > 0) {
-                    lines.push("", "Top Themes:");
-                    for (const t of profile.tags.slice(0, 10)) {
-                        lines.push(`  ${t.name}: ${t.weight.toFixed(2)} (${t.count} titles)`);
-                    }
-                }
-                // Score distribution bar chart
-                if (profile.scoring.totalScored > 0) {
-                    lines.push("", "Score Distribution:");
-                    for (let s = 10; s >= 1; s--) {
-                        const count = profile.scoring.distribution[s] ?? 0;
-                        if (count > 0) {
-                            // Cap at 30 chars
-                            const bar = "#".repeat(Math.min(count, 30));
-                            lines.push(`  ${s}/10: ${bar} (${count})`);
-                        }
-                    }
-                }
                 return lines.join("\n");
             }
             catch (error) {

package/dist/tools/search.js

@@ -2,7 +2,7 @@
 import { anilistClient } from "../api/client.js";
 import { SEARCH_MEDIA_QUERY, MEDIA_DETAILS_QUERY, SEASONAL_MEDIA_QUERY, RECOMMENDATIONS_QUERY, } from "../api/queries.js";
 import { SearchInputSchema, DetailsInputSchema, SeasonalInputSchema, RecommendationsInputSchema, } from "../schemas.js";
-import { getTitle, truncateDescription, throwToolError, formatMediaSummary, paginationFooter, isNsfwEnabled, resolveAlias, resolveSeasonYear, BROWSE_SORT_MAP, } from "../utils.js";
+import { getTitle, truncateDescription, throwToolError, formatMediaSummary, paginationFooter, isNsfwEnabled, resolveAlias, resolveSeasonYear, trailerUrl, BROWSE_SORT_MAP, } from "../utils.js";
 // Default to popularity for broad queries
 const SEARCH_SORT = ["POPULARITY_DESC"];
 // === Tool Registration ===
@@ -146,6 +146,14 @@ export function registerSearchTools(server) {
                         lines.push(`  - ${recTitle} (${r.meanScore ?? "?"}/100) - ${r.genres.slice(0, 3).join(", ")}`); // top 3 genres only
                     }
                 }
+                // Cover image
+                const cover = m.coverImage?.extraLarge ?? m.coverImage?.large;
+                if (cover)
+                    lines.push("", `Cover: ${cover}`);
+                // Trailer
+                const tUrl = trailerUrl(m.trailer);
+                if (tUrl)
+                    lines.push(`Trailer: ${tUrl}`);
                 lines.push("", `AniList: ${m.siteUrl}`);
                 return lines.join("\n");
             }

package/dist/tools/write.js

@@ -68,6 +68,9 @@ export function registerWriteTools(server) {
                     progress: args.progress,
                     status: args.status ?? "CURRENT",
                 };
+                if (args.volumeProgress !== undefined) {
+                    variables.progressVolumes = args.volumeProgress;
+                }
                 const data = await anilistClient.query(SAVE_MEDIA_LIST_ENTRY_MUTATION, variables, { cache: null });
                 const viewerName = await getViewerName();
                 anilistClient.invalidateUser(viewerName);
@@ -82,10 +85,13 @@ export function registerWriteTools(server) {
                     timestamp: Date.now(),
                     description: `Set progress to ${args.progress} on media ${args.mediaId}`,
                 });
+                const volStr = entry.progressVolumes > 0
+                    ? ` | Volumes: ${entry.progressVolumes}`
+                    : "";
                 return [
                     `Progress updated.`,
                     `Status: ${entry.status}`,
-                    `Progress: ${entry.progress}`,
+                    `Progress: ${entry.progress}${volStr}`,
                     `Entry ID: ${entry.id}`,
                     undoHint(before),
                 ].join("\n");
@@ -287,6 +293,7 @@ export function registerWriteTools(server) {
                         status: op.before.status,
                         scoreRaw: op.before.score * 10,
                         progress: op.before.progress,
+                        progressVolumes: op.before.progressVolumes,
                     }, { cache: null });
                     const viewerName = await getViewerName();
                     anilistClient.invalidateUser(viewerName);
@@ -308,6 +315,7 @@ export function registerWriteTools(server) {
                         status: op.before.status,
                         scoreRaw: op.before.score * 10,
                         progress: op.before.progress,
+                        progressVolumes: op.before.progressVolumes,
                     }, { cache: null });
                     const viewerName = await getViewerName();
                     anilistClient.invalidateUser(viewerName);
@@ -324,6 +332,7 @@ export function registerWriteTools(server) {
                                 status: item.before.status,
                                 scoreRaw: item.before.score * 10,
                                 progress: item.before.progress,
+                                progressVolumes: item.before.progressVolumes,
                             }, { cache: null });
                             restored++;
                         }
@@ -378,7 +387,9 @@ export function registerWriteTools(server) {
                 requireAuth();
                 const variables = { [FAVOURITE_VAR_MAP[args.type]]: args.id };
                 const data = await anilistClient.query(TOGGLE_FAVOURITE_MUTATION, variables, { cache: null });
-                anilistClient.invalidateUser(await getViewerName());
+                const viewerName = await getViewerName();
+                anilistClient.invalidateUser(viewerName);
+                invalidateUserProfiles(viewerName);
                 // Check if entity is now in favourites (added) or absent (removed)
                 const field = FAVOURITE_FIELD_MAP[args.type];
                 const isFavourited = data.ToggleFavourite[field].nodes.some((n) => n.id === args.id);
@@ -410,7 +421,9 @@ export function registerWriteTools(server) {
             try {
                 requireAuth();
                 const data = await anilistClient.query(SAVE_TEXT_ACTIVITY_MUTATION, { text: args.text }, { cache: null });
-                anilistClient.invalidateUser(await getViewerName());
+                const viewerName = await getViewerName();
+                anilistClient.invalidateUser(viewerName);
+                invalidateUserProfiles(viewerName);
                 const activity = data.SaveTextActivity;
                 const dateStr = new Date(activity.createdAt * 1000).toLocaleDateString("en-US", { month: "short", day: "numeric", year: "numeric" });
                 return [
@@ -560,6 +573,7 @@ export function registerWriteTools(server) {
                             status: e.status,
                             score: e.score,
                             progress: e.progress,
+                            progressVolumes: e.progressVolumes,
                             notes: e.notes,
                             private: false,
                         };

package/dist/types.d.ts

@@ -44,7 +44,13 @@ export interface AniListMedia {
     isAdult: boolean;
     coverImage: {
         large: string | null;
+        extraLarge: string | null;
     };
+    trailer: {
+        id: string;
+        site: string;
+        thumbnail: string;
+    } | null;
     siteUrl: string;
     description: string | null;
 }
@@ -238,6 +244,27 @@ export interface AiringScheduleResponse {
         siteUrl: string;
     };
 }
+/** Batch airing response for currently watching tracker */
+export interface BatchAiringResponse {
+    Page: {
+        media: Array<{
+            id: number;
+            title: {
+                romaji: string | null;
+                english: string | null;
+                native: string | null;
+            };
+            format: string | null;
+            episodes: number | null;
+            nextAiringEpisode: {
+                episode: number;
+                airingAt: number;
+                timeUntilAiring: number;
+            } | null;
+            siteUrl: string;
+        }>;
+    };
+}
 /** Character search results */
 export interface CharacterSearchResponse {
     Page: {
@@ -290,6 +317,7 @@ export interface MediaListEntryResponse {
         status: string;
         score: number;
         progress: number;
+        progressVolumes: number;
         notes: string | null;
         private: boolean;
     } | null;
@@ -302,6 +330,7 @@ export interface SaveMediaListEntryResponse {
         status: string;
         score: number;
         progress: number;
+        progressVolumes: number;
     };
 }
 /** Response from deleting a list entry */
@@ -315,6 +344,7 @@ export interface AniListMediaListEntry {
     id: number;
     score: number;
     progress: number;
+    progressVolumes: number;
     status: string;
     updatedAt: number;
     startedAt: AniListDate;

package/dist/utils.d.ts

@@ -16,6 +16,8 @@ export declare function throwToolError(error: unknown, action: string): never;
 export declare function paginationFooter(page: number, limit: number, total: number, hasNextPage: boolean): string;
 /** Format a media entry as a compact multi-line summary */
 export declare function formatMediaSummary(media: AniListMedia): string;
+/** Construct full trailer URL from site + video ID */
+export declare function trailerUrl(trailer: AniListMedia["trailer"]): string | null;
 /** Detect score format from env override or API fallback */
 export declare function detectScoreFormat(fetchFormat: () => Promise<ScoreFormat>): Promise<ScoreFormat>;
 /** Fetch score format for a user (by username) or the authenticated viewer */

package/dist/utils.js

@@ -129,9 +129,27 @@ export function formatMediaSummary(media) {
         lines.push(`  Length: ${length}`);
     if (studios)
         lines.push(`  Studio: ${studios}`);
+    // Best available cover image
+    const cover = media.coverImage?.extraLarge ?? media.coverImage?.large;
+    if (cover)
+        lines.push(`  Cover: ${cover}`);
+    // Trailer link
+    const trailer = trailerUrl(media.trailer);
+    if (trailer)
+        lines.push(`  Trailer: ${trailer}`);
     lines.push(`  URL: ${media.siteUrl}`);
     return lines.join("\n");
 }
+/** Construct full trailer URL from site + video ID */
+export function trailerUrl(trailer) {
+    if (!trailer)
+        return null;
+    if (trailer.site === "youtube")
+        return `https://youtube.com/watch?v=${trailer.id}`;
+    if (trailer.site === "dailymotion")
+        return `https://dailymotion.com/video/${trailer.id}`;
+    return null;
+}
 /** Detect score format from env override or API fallback */
 export async function detectScoreFormat(fetchFormat) {
     const override = process.env.ANILIST_SCORE_FORMAT;

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": "0.3",
   "name": "ani-mcp",
-  "version": "0.8.3",
+  "version": "0.9.0",
   "display_name": "AniList MCP",
   "description": "A smart MCP server for AniList that gets your anime/manga taste - not just API calls.",
   "author": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ani-mcp",
   "mcpName": "io.github.gavxm/ani-mcp",
-  "version": "0.8.3",
+  "version": "0.9.0",
   "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.8.3",
+  "version": "0.9.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "ani-mcp",
-      "version": "0.8.3",
+      "version": "0.9.0",
       "transport": {
         "type": "stdio"
       },