ani-mcp 0.1.2 → 0.2.0

package/README.md

@@ -11,7 +11,7 @@ Most AniList integrations mirror the API 1:1. ani-mcp adds an intelligence layer
 - **Compatibility** - compare taste between two users
 - **Year in review** - your watching/reading stats wrapped up
 
-Plus the essentials: search, details, trending, seasonal browsing, list management, and community recommendations.
+Plus the essentials: search, details, trending, seasonal browsing, list management, and community recommendations. All search and browse tools support pagination for browsing beyond the first page of results.
 
 ## Install
 
@@ -38,8 +38,11 @@ Works with any MCP-compatible client.
 | Variable | Required | Description |
 | --- | --- | --- |
 | `ANILIST_USERNAME` | No | Default username for list and stats tools. Can also pass per-call. |
-| `ANILIST_TOKEN` | No | AniList OAuth token. Enables authenticated queries. |
+| `ANILIST_TOKEN` | No | AniList OAuth token. Required for write operations and private lists. |
 | `DEBUG` | No | Set to `true` for debug logging to stderr. |
+| `MCP_TRANSPORT` | No | Set to `http` for HTTP Stream transport. Default: stdio. |
+| `MCP_PORT` | No | Port for HTTP transport. Default: `3000`. |
+| `MCP_HOST` | No | Host for HTTP transport. Default: `localhost`. |
 
 ## Tools
 
@@ -69,15 +72,37 @@ Works with any MCP-compatible client.
 | `anilist_pick` | Personalized "what to watch next" based on taste and mood |
 | `anilist_compare` | Compare taste compatibility between two users |
 | `anilist_wrapped` | Year-in-review summary |
+| `anilist_explain` | "Why would I like this?" - score a title against your taste profile |
+| `anilist_similar` | Find titles similar to a given anime or manga |
 
 ### Info
 
 | Tool | Description |
 | --- | --- |
 | `anilist_staff` | Staff credits and voice actors for a title |
+| `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_characters` | Search characters by name with appearances and VAs |
 
+### Write (requires `ANILIST_TOKEN`)
+
+| Tool | Description |
+| --- | --- |
+| `anilist_update_progress` | Update episode or chapter progress |
+| `anilist_add_to_list` | Add a title to your list with a status |
+| `anilist_rate` | Score a title (0-10) |
+| `anilist_delete_from_list` | Remove an entry from your list |
+
+## Docker
+
+```sh
+docker build -t ani-mcp .
+docker run -e ANILIST_USERNAME=your_username ani-mcp
+```
+
+Runs on port 3000 with HTTP Stream transport by default.
+
 ## Build from Source
 
 ```sh

package/dist/api/queries.d.ts

@@ -26,5 +26,13 @@ export declare const STAFF_QUERY = "\n  query MediaStaff($id: Int, $search: Stri
 export declare const AIRING_SCHEDULE_QUERY = "\n  query AiringSchedule($id: Int, $search: String, $notYetAired: Boolean) {\n    Media(id: $id, search: $search) {\n      id\n      title { romaji english native }\n      status\n      episodes\n      nextAiringEpisode {\n        episode\n        airingAt\n        timeUntilAiring\n      }\n      airingSchedule(notYetAired: $notYetAired, perPage: 10) {\n        nodes {\n          episode\n          airingAt\n          timeUntilAiring\n        }\n      }\n      siteUrl\n    }\n  }\n";
 /** Search for characters by name */
 export declare const CHARACTER_SEARCH_QUERY = "\n  query CharacterSearch($search: String!, $page: Int, $perPage: Int) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      characters(search: $search, sort: FAVOURITES_DESC) {\n        id\n        name { full native alternative }\n        image { medium }\n        favourites\n        siteUrl\n        media(sort: POPULARITY_DESC, perPage: 5) {\n          edges {\n            characterRole\n            node {\n              id\n              title { romaji english }\n              format\n              type\n              siteUrl\n            }\n            voiceActors(language: JAPANESE) {\n              id\n              name { full }\n              siteUrl\n            }\n          }\n        }\n      }\n    }\n  }\n";
+/** Create or update a list entry */
+export declare const SAVE_MEDIA_LIST_ENTRY_MUTATION = "\n  mutation SaveMediaListEntry(\n    $mediaId: Int\n    $status: MediaListStatus\n    $score: Float\n    $progress: Int\n    $notes: String\n    $private: Boolean\n  ) {\n    SaveMediaListEntry(\n      mediaId: $mediaId\n      status: $status\n      score: $score\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";
+/** 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        entries {\n          id\n          score(format: POINT_10)  # normalize to 1-10 scale regardless of user's profile setting\n          progress\n          status\n          updatedAt\n          startedAt { year month day }\n          completedAt { year month day }\n          notes\n          media {\n            ...MediaFields\n          }\n        }\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+/** 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";
+/** Search for a studio by name with their productions */
+export declare const STUDIO_SEARCH_QUERY = "\n  query StudioSearch($search: String!, $perPage: Int) {\n    Studio(search: $search, sort: SEARCH_MATCH) {\n      id\n      name\n      isAnimationStudio\n      siteUrl\n      media(sort: POPULARITY_DESC, perPage: $perPage) {\n        edges {\n          isMainStudio\n          node {\n            id\n            title { romaji english }\n            format\n            type\n            status\n            meanScore\n            siteUrl\n          }\n        }\n      }\n    }\n  }\n";

package/dist/api/queries.js

@@ -364,6 +364,40 @@ export const CHARACTER_SEARCH_QUERY = `
     }
   }
 `;
+/** Create or update a list entry */
+export const SAVE_MEDIA_LIST_ENTRY_MUTATION = `
+  mutation SaveMediaListEntry(
+    $mediaId: Int
+    $status: MediaListStatus
+    $score: Float
+    $progress: Int
+    $notes: String
+    $private: Boolean
+  ) {
+    SaveMediaListEntry(
+      mediaId: $mediaId
+      status: $status
+      score: $score
+      progress: $progress
+      notes: $notes
+      private: $private
+    ) {
+      id
+      mediaId
+      status
+      score(format: POINT_10)
+      progress
+    }
+  }
+`;
+/** Remove a list entry */
+export const DELETE_MEDIA_LIST_ENTRY_MUTATION = `
+  mutation DeleteMediaListEntry($id: Int!) {
+    DeleteMediaListEntry(id: $id) {
+      deleted
+    }
+  }
+`;
 /** User's anime/manga list, grouped by status. Omit $status to get all lists. */
 export const USER_LIST_QUERY = `
   query UserMediaList(
@@ -399,3 +433,55 @@ export const USER_LIST_QUERY = `
   }
   ${MEDIA_FRAGMENT}
 `;
+/** Search for staff by name with their top works */
+export const STAFF_SEARCH_QUERY = `
+  query StaffSearch($search: String!, $page: Int, $perPage: Int, $mediaPerPage: Int) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo { total hasNextPage }
+      staff(search: $search, sort: SEARCH_MATCH) {
+        id
+        name { full native }
+        primaryOccupations
+        siteUrl
+        staffMedia(sort: POPULARITY_DESC, perPage: $mediaPerPage) {
+          edges {
+            staffRole
+            node {
+              id
+              title { romaji english }
+              format
+              type
+              meanScore
+              siteUrl
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+/** Search for a studio by name with their productions */
+export const STUDIO_SEARCH_QUERY = `
+  query StudioSearch($search: String!, $perPage: Int) {
+    Studio(search: $search, sort: SEARCH_MATCH) {
+      id
+      name
+      isAnimationStudio
+      siteUrl
+      media(sort: POPULARITY_DESC, perPage: $perPage) {
+        edges {
+          isMainStudio
+          node {
+            id
+            title { romaji english }
+            format
+            type
+            status
+            meanScore
+            siteUrl
+          }
+        }
+      }
+    }
+  }
+`;

package/dist/engine/matcher.d.ts

@@ -8,5 +8,25 @@ export interface MatchResult {
     reasons: string[];
     moodFit: string | null;
 }
+export interface ScoreBreakdown {
+    genreScore: number;
+    tagScore: number;
+    communityScore: number;
+    popularityFactor: number;
+    moodMultiplier: number;
+    finalScore: number;
+}
+export interface ExplainResult {
+    media: AniListMedia;
+    breakdown: ScoreBreakdown;
+    matchedGenres: string[];
+    unmatchedGenres: string[];
+    matchedTags: string[];
+    unmatchedTags: string[];
+    reasons: string[];
+    moodFit: string | null;
+}
 /** Score and rank candidates against a user's taste profile */
 export declare function matchCandidates(candidates: AniListMedia[], profile: TasteProfile, mood?: MoodModifiers): MatchResult[];
+/** Score a single title against a taste profile with a detailed breakdown */
+export declare function explainMatch(media: AniListMedia, profile: TasteProfile, mood?: MoodModifiers): ExplainResult;

package/dist/engine/matcher.js

@@ -139,6 +139,67 @@ function applyMood(media, mood, reasons) {
     }
     return null;
 }
+// === Single-Title Explain ===
+/** Score a single title against a taste profile with a detailed breakdown */
+export function explainMatch(media, profile, mood) {
+    const genreWeights = toWeightMap(profile.genres);
+    const tagWeights = toWeightMap(profile.tags);
+    const maxGenreWeight = profile.genres[0]?.weight ?? 1;
+    const maxTagWeight = profile.tags[0]?.weight ?? 1;
+    const reasons = [];
+    // Genre affinity with matched/unmatched tracking
+    const genreScore = computeGenreAffinity(media, genreWeights, maxGenreWeight, reasons);
+    const matchedGenres = media.genres.filter((g) => genreWeights.has(g));
+    const unmatchedGenres = media.genres.filter((g) => !genreWeights.has(g));
+    // Tag affinity with matched/unmatched tracking
+    const tagScore = computeTagAffinity(media, tagWeights, maxTagWeight, reasons);
+    const nonSpoilerTags = media.tags.filter((t) => !t.isMediaSpoiler);
+    const matchedTags = nonSpoilerTags
+        .filter((t) => tagWeights.has(t.name))
+        .map((t) => t.name);
+    const unmatchedTags = nonSpoilerTags
+        .filter((t) => !tagWeights.has(t.name))
+        .map((t) => t.name);
+    const communityScore = (media.meanScore ?? 70) / 100;
+    const popFactor = popularityDiversityFactor(media.popularity);
+    let finalScore = genreScore * GENRE_WEIGHT +
+        tagScore * TAG_WEIGHT +
+        communityScore * COMMUNITY_WEIGHT;
+    finalScore *= popFactor;
+    // Mood modifier
+    let moodMultiplier = 1;
+    const moodFit = mood ? applyMood(media, mood, reasons) : null;
+    if (moodFit === "boost") {
+        moodMultiplier = MOOD_BOOST;
+        finalScore *= MOOD_BOOST;
+    }
+    if (moodFit === "penalty") {
+        moodMultiplier = MOOD_PENALTY;
+        finalScore *= MOOD_PENALTY;
+    }
+    return {
+        media,
+        breakdown: {
+            genreScore,
+            tagScore,
+            communityScore,
+            popularityFactor: popFactor,
+            moodMultiplier,
+            // Scale 0-1 to 0-100
+            finalScore: Math.round(Math.min(1, finalScore) * 100),
+        },
+        matchedGenres,
+        unmatchedGenres,
+        matchedTags,
+        unmatchedTags,
+        reasons,
+        moodFit: moodFit
+            ? moodFit === "boost"
+                ? "Strong mood match"
+                : "Weak mood fit"
+            : null,
+    };
+}
 // === Helpers ===
 /** Convert WeightedItem[] to a Map for fast lookup */
 function toWeightMap(items) {

package/dist/engine/mood.d.ts

@@ -15,3 +15,8 @@ export declare function parseMood(mood: string): MoodModifiers;
 export declare function hasMoodMatch(mood: string): boolean;
 /** List all recognized mood keywords */
 export declare function getMoodKeywords(): string[];
+/** Suggest mood keywords that fit the current anime season */
+export declare function seasonalMoodSuggestions(): {
+    season: string;
+    moods: string[];
+};

package/dist/engine/mood.js

@@ -66,6 +66,24 @@ const BASE_MOOD_RULES = {
         boost: ["Psychological", "Avant Garde", "Surreal", "Experimental"],
         penalize: ["Shounen", "Sports"],
     },
+    nostalgic: {
+        boost: [
+            "Coming of Age",
+            "Drama",
+            "Slice of Life",
+            "School",
+            "Ensemble Cast",
+        ],
+        penalize: ["Isekai", "Mecha"],
+    },
+    artistic: {
+        boost: ["Avant Garde", "Drama", "Music", "Surreal", "Visual Arts"],
+        penalize: ["Shounen", "Ecchi"],
+    },
+    competitive: {
+        boost: ["Sports", "Strategy Game", "Shounen", "Tournament", "Martial Arts"],
+        penalize: ["Slice of Life", "Iyashikei"],
+    },
 };
 // Synonyms that resolve to a base keyword's rules
 const MOOD_SYNONYMS = {
@@ -117,6 +135,17 @@ const MOOD_SYNONYMS = {
     // trippy
     surreal: "trippy",
     experimental: "trippy",
+    // nostalgic
+    retro: "nostalgic",
+    throwback: "nostalgic",
+    classic: "nostalgic",
+    // artistic
+    artsy: "artistic",
+    beautiful: "artistic",
+    aesthetic: "artistic",
+    // competitive
+    rivalry: "competitive",
+    tournament: "competitive",
 };
 // Merge base rules and synonyms into a single lookup
 const MOOD_RULES = { ...BASE_MOOD_RULES };
@@ -163,3 +192,22 @@ export function hasMoodMatch(mood) {
 export function getMoodKeywords() {
     return Object.keys(MOOD_RULES);
 }
+// === Seasonal Suggestions ===
+const SEASONAL_MOODS = {
+    WINTER: ["cozy", "dark", "nostalgic", "brainy"],
+    SPRING: ["romantic", "wholesome", "chill", "artistic"],
+    SUMMER: ["hype", "action", "epic", "competitive"],
+    FALL: ["mystery", "scary", "dark", "intense"],
+};
+/** Suggest mood keywords that fit the current anime season */
+export function seasonalMoodSuggestions() {
+    const month = new Date().getMonth() + 1;
+    const season = month <= 3
+        ? "WINTER"
+        : month <= 6
+            ? "SPRING"
+            : month <= 9
+                ? "SUMMER"
+                : "FALL";
+    return { season, moods: SEASONAL_MOODS[season] };
+}

package/dist/engine/similar.d.ts

@@ -0,0 +1,9 @@
+/** Ranks candidates by content similarity to a source title */
+import type { AniListMedia } from "../types.js";
+export interface SimilarResult {
+    media: AniListMedia;
+    similarityScore: number;
+    reasons: string[];
+}
+/** Rank candidates by genre/tag overlap and community recommendation strength */
+export declare function rankSimilar(source: AniListMedia, candidates: AniListMedia[], recRatings: Map<number, number>): SimilarResult[];

package/dist/engine/similar.js

@@ -0,0 +1,50 @@
+/** Ranks candidates by content similarity to a source title */
+// === Constants ===
+const GENRE_WEIGHT = 0.4;
+const TAG_WEIGHT = 0.3;
+const REC_WEIGHT = 0.3;
+// === Similarity Engine ===
+/** Rank candidates by genre/tag overlap and community recommendation strength */
+export function rankSimilar(source, candidates, recRatings) {
+    if (candidates.length === 0)
+        return [];
+    // Normalize rec ratings to 0-1
+    const maxRating = Math.max(1, ...recRatings.values());
+    const sourceGenres = new Set(source.genres);
+    const sourceTags = new Set(source.tags.filter((t) => !t.isMediaSpoiler).map((t) => t.name));
+    const results = [];
+    for (const candidate of candidates) {
+        const reasons = [];
+        // Genre overlap: Jaccard coefficient
+        const candidateGenres = new Set(candidate.genres);
+        const genreIntersection = [...sourceGenres].filter((g) => candidateGenres.has(g));
+        const genreUnion = new Set([...sourceGenres, ...candidateGenres]);
+        const genreOverlap = genreUnion.size > 0 ? genreIntersection.length / genreUnion.size : 0;
+        if (genreIntersection.length > 0) {
+            reasons.push(`Shares genres: ${genreIntersection.join(", ")}`);
+        }
+        // Tag overlap: Jaccard on non-spoiler tags
+        const candidateTags = new Set(candidate.tags.filter((t) => !t.isMediaSpoiler).map((t) => t.name));
+        const tagIntersection = [...sourceTags].filter((t) => candidateTags.has(t));
+        const tagUnion = new Set([...sourceTags, ...candidateTags]);
+        const tagOverlap = tagUnion.size > 0 ? tagIntersection.length / tagUnion.size : 0;
+        if (tagIntersection.length > 0) {
+            reasons.push(`Similar themes: ${tagIntersection.slice(0, 3).join(", ")}`);
+        }
+        // Community recommendation rating
+        const rating = recRatings.get(candidate.id) ?? 0;
+        const recBoost = rating > 0 ? rating / maxRating : 0;
+        if (rating > 0) {
+            reasons.push(`Recommended by community (${rating > 0 ? "+" : ""}${rating})`);
+        }
+        const score = genreOverlap * GENRE_WEIGHT +
+            tagOverlap * TAG_WEIGHT +
+            recBoost * REC_WEIGHT;
+        results.push({
+            media: candidate,
+            similarityScore: Math.round(Math.min(1, score) * 100),
+            reasons,
+        });
+    }
+    return results.sort((a, b) => b.similarityScore - a.similarityScore);
+}

package/dist/index.js

@@ -7,6 +7,7 @@ import { registerListTools } from "./tools/lists.js";
 import { registerRecommendTools } from "./tools/recommend.js";
 import { registerDiscoverTools } from "./tools/discover.js";
 import { registerInfoTools } from "./tools/info.js";
+import { registerWriteTools } from "./tools/write.js";
 // 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.");
@@ -23,4 +24,18 @@ registerListTools(server);
 registerRecommendTools(server);
 registerDiscoverTools(server);
 registerInfoTools(server);
-server.start({ transportType: "stdio" });
+registerWriteTools(server);
+// === Transport ===
+const transport = process.env.MCP_TRANSPORT === "http" ? "httpStream" : "stdio";
+if (transport === "httpStream") {
+    const port = Number(process.env.MCP_PORT) || 3000;
+    const host = process.env.MCP_HOST || "localhost";
+    console.error(`Listening on http://${host}:${port}/mcp`);
+    server.start({
+        transportType: "httpStream",
+        httpStream: { port, host },
+    });
+}
+else {
+    server.start({ transportType: "stdio" });
+}

package/dist/schemas.d.ts

@@ -21,6 +21,7 @@ export declare const SearchInputSchema: z.ZodObject<{
     }>>;
     isAdult: z.ZodDefault<z.ZodBoolean>;
     limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type SearchInput = z.infer<typeof SearchInputSchema>;
 /** Input for looking up a single anime or manga by ID or title */
@@ -51,6 +52,7 @@ export declare const ListInputSchema: z.ZodObject<{
         PROGRESS: "PROGRESS";
     }>>;
     limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type ListInput = z.infer<typeof ListInputSchema>;
 /** Input for generating a taste profile summary */
@@ -101,6 +103,7 @@ export declare const SeasonalInputSchema: z.ZodObject<{
     }>>;
     isAdult: z.ZodDefault<z.ZodBoolean>;
     limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type SeasonalInput = z.infer<typeof SeasonalInputSchema>;
 /** Input for fetching user statistics */
@@ -127,6 +130,7 @@ export declare const TrendingInputSchema: z.ZodObject<{
     }>>;
     isAdult: z.ZodDefault<z.ZodBoolean>;
     limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type TrendingInput = z.infer<typeof TrendingInputSchema>;
 /** Input for browsing by genre */
@@ -161,6 +165,7 @@ export declare const GenreBrowseInputSchema: z.ZodObject<{
     }>>;
     isAdult: z.ZodDefault<z.ZodBoolean>;
     limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type GenreBrowseInput = z.infer<typeof GenreBrowseInputSchema>;
 /** Input for staff/VA credits lookup */
@@ -179,6 +184,7 @@ export type ScheduleInput = z.infer<typeof ScheduleInputSchema>;
 export declare const CharacterSearchInputSchema: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type CharacterSearchInput = z.infer<typeof CharacterSearchInputSchema>;
 /** Input for community recommendations for a specific title */
@@ -188,3 +194,72 @@ export declare const RecommendationsInputSchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type RecommendationsInput = z.infer<typeof RecommendationsInputSchema>;
+/** Input for updating episode or chapter progress */
+export declare const UpdateProgressInputSchema: z.ZodObject<{
+    mediaId: z.ZodNumber;
+    progress: z.ZodNumber;
+    status: z.ZodOptional<z.ZodEnum<{
+        CURRENT: "CURRENT";
+        COMPLETED: "COMPLETED";
+        DROPPED: "DROPPED";
+        PAUSED: "PAUSED";
+        REPEATING: "REPEATING";
+    }>>;
+}, z.core.$strip>;
+export type UpdateProgressInput = z.infer<typeof UpdateProgressInputSchema>;
+/** Input for adding a title to the user's list */
+export declare const AddToListInputSchema: z.ZodObject<{
+    mediaId: z.ZodNumber;
+    status: z.ZodEnum<{
+        CURRENT: "CURRENT";
+        COMPLETED: "COMPLETED";
+        PLANNING: "PLANNING";
+        DROPPED: "DROPPED";
+        PAUSED: "PAUSED";
+        REPEATING: "REPEATING";
+    }>;
+    score: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AddToListInput = z.infer<typeof AddToListInputSchema>;
+/** Input for rating a title */
+export declare const RateInputSchema: z.ZodObject<{
+    mediaId: z.ZodNumber;
+    score: z.ZodNumber;
+}, z.core.$strip>;
+export type RateInput = z.infer<typeof RateInputSchema>;
+/** Input for removing a title from the list */
+export declare const DeleteFromListInputSchema: z.ZodObject<{
+    entryId: z.ZodNumber;
+}, z.core.$strip>;
+/** Input for scoring a title against a user's taste profile */
+export declare const ExplainInputSchema: z.ZodObject<{
+    mediaId: z.ZodNumber;
+    username: z.ZodOptional<z.ZodString>;
+    type: z.ZodDefault<z.ZodEnum<{
+        ANIME: "ANIME";
+        MANGA: "MANGA";
+        BOTH: "BOTH";
+    }>>;
+    mood: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ExplainInput = z.infer<typeof ExplainInputSchema>;
+/** Input for finding titles similar to a specific anime or manga */
+export declare const SimilarInputSchema: z.ZodObject<{
+    mediaId: z.ZodNumber;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type SimilarInput = z.infer<typeof SimilarInputSchema>;
+/** Input for searching staff/people by name */
+export declare const StaffSearchInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    mediaLimit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type StaffSearchInput = z.infer<typeof StaffSearchInputSchema>;
+/** Input for searching studios by name */
+export declare const StudioSearchInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type StudioSearchInput = z.infer<typeof StudioSearchInputSchema>;