mcp-metacritic 1.1.1 → 1.2.0

package/README.md

@@ -3,6 +3,7 @@
 [![npm](https://img.shields.io/npm/v/mcp-metacritic.svg)](https://www.npmjs.com/package/mcp-metacritic)
 [![CI](https://github.com/smeet666/mcp-metacritic/actions/workflows/ci.yml/badge.svg)](https://github.com/smeet666/mcp-metacritic/actions/workflows/ci.yml)
 [![license](https://img.shields.io/npm/l/mcp-metacritic.svg)](./LICENSE)
+[![Glama](https://glama.ai/mcp/servers/smeet666/mcp-metacritic/badges/score.svg)](https://glama.ai/mcp/servers/smeet666/mcp-metacritic)
 
 An [MCP](https://modelcontextprotocol.io) server for
 [Metacritic](https://www.metacritic.com). Search films, shows and games, read

package/dist/index.js

@@ -4,7 +4,7 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/version.ts
-var PKG_VERSION = "1.1.1";
+var PKG_VERSION = "1.2.0";
 var REPO_URL = "https://github.com/smeet666/mcp-metacritic";
 
 // src/config.ts
@@ -129,7 +129,7 @@ function createLogger(level) {
 
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 
 // src/mc/cache.ts
 var TtlLruCache = class {
@@ -542,6 +542,10 @@ var intOf = (value) => {
   const parsed = num(value);
   return parsed === null ? null : Math.trunc(parsed);
 };
+var aggregate = (value) => {
+  const parsed = num(value);
+  return parsed === 0 ? null : parsed;
+};
 function kindOf(value) {
   const type = str(value);
   if (type === SEARCH_TYPE.movie) return "movie";
@@ -559,7 +563,7 @@ function toSummary(node) {
   const critic = isObject(node.criticScoreSummary) ? node.criticScoreSummary : {};
   const userSummary = isObject(node.userScoreSummary) ? node.userScoreSummary : {};
   const userObject = isObject(node.userScore) ? node.userScore : {};
-  const userScore = num(userSummary.score) ?? num(userObject.score) ?? num(node.userScore);
+  const userScore = aggregate(userSummary.score) ?? aggregate(userObject.score) ?? aggregate(node.userScore);
   return {
     id,
     kind,
@@ -568,7 +572,7 @@ function toSummary(node) {
     year: intOf(node.premiereYear),
     releaseDate: str(node.releaseDate),
     rating: str(node.rating),
-    metascore: num(critic.score),
+    metascore: aggregate(critic.score),
     userScore,
     sourceUrl: titlePageUrl(kind, slug)
   };
@@ -652,7 +656,7 @@ function parseDetail(raw, url, kind, slug) {
     description: str(item.description),
     tagline: str(item.tagline),
     genres: toStringList(item.genres),
-    duration: intOf(item.duration),
+    duration: aggregate(intOf(item.duration)),
     imdbId: str(item.imdbId),
     networks: toStringList(item.networks),
     production: toCompanies(item.production),
@@ -668,7 +672,7 @@ function parseScore(raw, url, what) {
   const max = num(item.max);
   if (max === null) throw parseFailure(url, "the score carries no scale");
   return {
-    score: num(item.score),
+    score: aggregate(item.score),
     max,
     reviewCount: intOf(item.reviewCount),
     positiveCount: intOf(item.positiveCount),
@@ -894,24 +898,75 @@ var McClient = class {
 };
 
 // src/tools/browseTitles.ts
-import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 
-// src/tools/shared.ts
+// src/tools/arguments.ts
 import { z } from "zod";
+var INVALID_INPUT = "invalid_input";
+function strictInput(shape) {
+  const declared = Object.keys(shape);
+  const errorMap = (issue, ctx) => issue.code === z.ZodIssueCode.unrecognized_keys ? { message: unknownArgumentMessage(issue.keys, declared) } : { message: ctx.defaultError };
+  return z.strictObject(shape, { errorMap });
+}
+function unknownArgumentMessage(keys, declared) {
+  const named = keys.map((key) => {
+    const near = nearestArgument(key, declared);
+    return near ? `'${key}' (did you mean '${near}'?)` : `'${key}'`;
+  }).join(", ");
+  return `[${INVALID_INPUT}] Unknown ${keys.length > 1 ? "arguments" : "argument"} ${named}. This tool takes: ${declared.join(", ")}.`;
+}
+function nearestArgument(key, declared) {
+  const flatten = (name) => name.toLowerCase().replace(/[^a-z0-9]/g, "");
+  const flat = flatten(key);
+  if (flat.length === 0) return void 0;
+  const sameName = declared.find((name) => flatten(name) === flat);
+  if (sameName) return sameName;
+  const overlapping = declared.find((name) => {
+    const other = flatten(name);
+    const [shorter, longer] = other.length < flat.length ? [other, flat] : [flat, other];
+    return shorter.length >= 3 && (longer.startsWith(shorter) || longer.endsWith(shorter));
+  });
+  if (overlapping) return overlapping;
+  let closest;
+  let shortest = Number.POSITIVE_INFINITY;
+  for (const name of declared) {
+    const distance = editDistance(flat, flatten(name));
+    if (distance < shortest) {
+      shortest = distance;
+      closest = name;
+    }
+  }
+  return shortest <= Math.max(1, Math.floor(flat.length / 3)) ? closest : void 0;
+}
+function editDistance(left, right) {
+  let previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+  for (let row = 1; row <= left.length; row += 1) {
+    const current = [row];
+    for (let column = 1; column <= right.length; column += 1) {
+      const substitution = previous[column - 1] + (left[row - 1] === right[column - 1] ? 0 : 1);
+      current[column] = Math.min(substitution, previous[column] + 1, current[column - 1] + 1);
+    }
+    previous = current;
+  }
+  return previous[right.length];
+}
+
+// src/tools/shared.ts
+import { z as z2 } from "zod";
 var MAX_TEXT_MIRROR_CHARS = 2e3;
 var ATTRIBUTION = "Source: Metacritic";
-var kindSchema = z.enum(["movie", "show", "game"]).describe("Which catalogue the entry belongs to. Pass it back with the slug.");
-var titleSummarySchema = z.object({
-  id: z.number().int(),
-  kind: z.enum(["movie", "show", "game"]),
-  title: z.string(),
-  slug: z.string().describe("Identifier to pass to get_title and get_reviews, with 'kind'."),
-  year: z.number().int().nullable(),
-  release_date: z.string().nullable(),
-  rating: z.string().nullable().describe("Age rating as published, such as R or TV-MA."),
-  metascore: z.number().nullable().describe("Critic score, out of 100. Not comparable to user_score without rescaling."),
-  user_score: z.number().nullable().describe("Audience score, out of 10. Not comparable to metascore without rescaling."),
-  source_url: z.string().describe("Metacritic page. Show this when citing the entry.")
+var kindSchema = z2.enum(["movie", "show", "game"]).describe("Which catalogue the entry belongs to. Pass it back with the slug.");
+var titleSummarySchema = z2.object({
+  id: z2.number().int(),
+  kind: z2.enum(["movie", "show", "game"]),
+  title: z2.string(),
+  slug: z2.string().describe("Identifier to pass to get_title and get_reviews, with 'kind'."),
+  year: z2.number().int().nullable(),
+  release_date: z2.string().nullable(),
+  rating: z2.string().nullable().describe("Age rating as published, such as R or TV-MA."),
+  metascore: z2.number().nullable().describe("Critic score, out of 100. Not comparable to user_score without rescaling."),
+  user_score: z2.number().nullable().describe("Audience score, out of 10. Not comparable to metascore without rescaling."),
+  source_url: z2.string().describe("Metacritic page. Show this when citing the entry.")
 });
 function toTitleSummaryOut(title) {
   return {
@@ -927,14 +982,14 @@ function toTitleSummaryOut(title) {
     source_url: title.sourceUrl
   };
 }
-var scoreSchema = z.object({
-  score: z.number().nullable(),
-  max: z.number().describe("Scale this score is on: 100 for critics, 10 for users."),
-  review_count: z.number().int().nullable(),
-  positive_count: z.number().int().nullable(),
-  neutral_count: z.number().int().nullable(),
-  negative_count: z.number().int().nullable(),
-  sentiment: z.string().nullable().describe("Metacritic's own wording for the verdict.")
+var scoreSchema = z2.object({
+  score: z2.number().nullable(),
+  max: z2.number().describe("Scale this score is on: 100 for critics, 10 for users."),
+  review_count: z2.number().int().nullable(),
+  positive_count: z2.number().int().nullable(),
+  neutral_count: z2.number().int().nullable(),
+  negative_count: z2.number().int().nullable(),
+  sentiment: z2.string().nullable().describe("Metacritic's own wording for the verdict.")
 });
 function toScoreOut(score) {
   return {
@@ -1023,26 +1078,26 @@ var browseTitlesDescription = [
   "Scores come back on their own scales, 100 for critics and 10 for users.",
   "Paging is approximate: Metacritic does not order tied entries stably, so an entry can appear on two consecutive pages. Deduplicate by slug rather than counting rows."
 ].join(" ");
-var browseTitlesInputShape = {
-  kind: z2.enum(["movie", "show", "game"]).default("movie").describe("Which catalogue to list."),
-  sort: z2.enum(["score", "recent", "popular"]).default("score").describe(
+var browseTitlesInput = strictInput({
+  kind: z3.enum(["movie", "show", "game"]).default("movie").describe("Which catalogue to list."),
+  sort: z3.enum(["score", "recent", "popular"]).default("score").describe(
     "'score' is the critic ranking, 'recent' is by release date, 'popular' is current attention."
   ),
-  genre: z2.string().optional().describe("Single genre name, such as Horror. Omit for all genres."),
-  limit: z2.number().int().min(1).max(50).default(20).describe("How many rows to return."),
-  offset: z2.number().int().min(0).default(0).describe("How many rows to skip, for paging.")
-};
+  genre: z3.string().optional().describe("Single genre name, such as Horror. Omit for all genres."),
+  limit: z3.number().int().min(1).max(50).default(20).describe("How many rows to return."),
+  offset: z3.number().int().min(0).default(0).describe("How many rows to skip, for paging.")
+});
 var browseTitlesOutputShape = {
-  kind: z2.string(),
-  sort: z2.string(),
-  genre: z2.string().nullable(),
-  results: z2.array(titleSummarySchema),
-  total_available: z2.number().int().describe("How many entries match upstream, which is the size of what this samples."),
-  offset: z2.number().int(),
-  next_offset: z2.number().int().nullable().describe(
+  kind: z3.string(),
+  sort: z3.string(),
+  genre: z3.string().nullable(),
+  results: z3.array(titleSummarySchema),
+  total_available: z3.number().int().describe("How many entries match upstream, which is the size of what this samples."),
+  offset: z3.number().int(),
+  next_offset: z3.number().int().nullable().describe(
     "Pass as 'offset' for the next page. Tied entries are not ordered stably upstream, so deduplicate by slug across pages."
   ),
-  notes: z2.array(z2.string())
+  notes: z3.array(z3.string())
 };
 async function runBrowseTitles(client, args) {
   try {
@@ -1094,7 +1149,7 @@ ${renderTitleList(results)}`;
 }
 
 // src/tools/getReviews.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 var MAX_QUOTE_CHARS = 600;
 var getReviewsDescription = [
   "Read individual reviews of a Metacritic entry, from critics or from users.",
@@ -1104,34 +1159,34 @@ var getReviewsDescription = [
   "Critic reviews carry the publication and a link to the original article: quote them with both.",
   "Critic scores run to 100 and user scores to 10, so do not average the two together."
 ].join(" ");
-var getReviewsInputShape = {
-  slug: z3.string().min(1).describe("Identifier from search_titles, such as 'the-matrix'."),
+var getReviewsInput = strictInput({
+  slug: z4.string().min(1).describe("Identifier from search_titles, such as 'the-matrix'."),
   kind: kindSchema,
-  source: z3.enum(["critic", "user"]).default("critic").describe("'critic' is the professional press, 'user' is the audience."),
-  sentiment: z3.enum(["all", "positive", "neutral", "negative"]).default("all").describe("Which slice to read. Metacritic groups reviews this way itself."),
-  limit: z3.number().int().min(1).max(50).default(10).describe("How many reviews to return from the sample Metacritic publishes."),
-  offset: z3.number().int().min(0).default(0).describe("How many of the sampled reviews to skip. The sample itself cannot be paged past.")
-};
-var reviewSchema = z3.object({
-  quote: z3.string().nullable().describe("Excerpt as published, truncated if long."),
-  score: z3.number().nullable(),
-  max: z3.number().describe("Scale for this review's score: 100 for critics, 10 for users."),
-  publication: z3.string().nullable().describe("Who ran it. Name it when quoting."),
-  author: z3.string().nullable(),
-  url: z3.string().nullable().describe("Original article. Link it when quoting."),
-  date: z3.string().nullable()
+  source: z4.enum(["critic", "user"]).default("critic").describe("'critic' is the professional press, 'user' is the audience."),
+  sentiment: z4.enum(["all", "positive", "neutral", "negative"]).default("all").describe("Which slice to read. Metacritic groups reviews this way itself."),
+  limit: z4.number().int().min(1).max(50).default(10).describe("How many reviews to return from the sample Metacritic publishes."),
+  offset: z4.number().int().min(0).default(0).describe("How many of the sampled reviews to skip. The sample itself cannot be paged past.")
+});
+var reviewSchema = z4.object({
+  quote: z4.string().nullable().describe("Excerpt as published, truncated if long."),
+  score: z4.number().nullable(),
+  max: z4.number().describe("Scale for this review's score: 100 for critics, 10 for users."),
+  publication: z4.string().nullable().describe("Who ran it. Name it when quoting."),
+  author: z4.string().nullable(),
+  url: z4.string().nullable().describe("Original article. Link it when quoting."),
+  date: z4.string().nullable()
 });
 var getReviewsOutputShape = {
-  slug: z3.string(),
-  kind: z3.string(),
-  source_url: z3.string().describe("Metacritic page these reviews belong to. Cite it when an article link is missing."),
-  source: z3.string(),
-  sentiment: z3.string(),
-  reviews: z3.array(reviewSchema),
-  total_available: z3.number().int().describe("How many reviews Metacritic counts in total. Usually far more than it serves here."),
-  offset: z3.number().int(),
-  next_offset: z3.number().int().nullable().describe("Pass as 'offset' for the next page."),
-  notes: z3.array(z3.string())
+  slug: z4.string(),
+  kind: z4.string(),
+  source_url: z4.string().describe("Metacritic page these reviews belong to. Cite it when an article link is missing."),
+  source: z4.string(),
+  sentiment: z4.string(),
+  reviews: z4.array(reviewSchema),
+  total_available: z4.number().int().describe("How many reviews Metacritic counts in total. Usually far more than it serves here."),
+  offset: z4.number().int(),
+  next_offset: z4.number().int().nullable().describe("Pass as 'offset' for the next page."),
+  notes: z4.array(z4.string())
 };
 async function runGetReviews(client, args) {
   try {
@@ -1215,7 +1270,7 @@ ${listing}`;
 }
 
 // src/tools/getTitle.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 var SECTIONS = ["basic", "scores", "awards", "production", "networks", "where_to_watch"];
 var getTitleDescription = [
   "Read one Metacritic entry by slug and kind, both from search_titles.",
@@ -1225,38 +1280,38 @@ var getTitleDescription = [
   "'networks' lists the broadcasters of a show; 'where_to_watch' costs an extra request and covers films and shows only.",
   "A long description paginates: when 'truncated' is true, call again with 'offset' set to 'next_offset'."
 ].join(" ");
-var getTitleInputShape = {
-  slug: z4.string().min(1).describe("Identifier from search_titles, such as 'the-matrix'."),
+var getTitleInput = strictInput({
+  slug: z5.string().min(1).describe("Identifier from search_titles, such as 'the-matrix'."),
   kind: kindSchema,
-  sections: z4.array(z4.enum(SECTIONS)).default(["basic", "scores"]).describe("Which parts to return. Each extra section beyond the default costs a request."),
-  max_chars: z4.number().int().min(200).max(2e4).default(4e3).describe("Character budget for the description."),
-  offset: z4.number().int().min(0).default(0).describe("Where to resume the description.")
-};
+  sections: z5.array(z5.enum(SECTIONS)).default(["basic", "scores"]).describe("Which parts to return. Each extra section beyond the default costs a request."),
+  max_chars: z5.number().int().min(200).max(2e4).default(4e3).describe("Character budget for the description."),
+  offset: z5.number().int().min(0).default(0).describe("Where to resume the description.")
+});
 var getTitleOutputShape = {
   title: titleSummarySchema,
-  description: z4.string().nullable(),
-  tagline: z4.string().nullable(),
-  genres: z4.array(z4.string()),
-  duration_minutes: z4.number().int().nullable().describe("Runtime in minutes for a film, or the length of a typical episode for a show."),
-  imdb_id: z4.string().nullable().describe("IMDb identifier, usable to cross-reference other sources."),
-  total_chars: z4.number().int().describe("Length of the full description."),
-  returned_chars: z4.number().int(),
-  offset: z4.number().int(),
-  next_offset: z4.number().int().nullable().describe("Pass as 'offset' to read the rest."),
-  truncated: z4.boolean(),
+  description: z5.string().nullable(),
+  tagline: z5.string().nullable(),
+  genres: z5.array(z5.string()),
+  duration_minutes: z5.number().int().nullable().describe("Runtime in minutes for a film, or the length of a typical episode for a show."),
+  imdb_id: z5.string().nullable().describe("IMDb identifier, usable to cross-reference other sources."),
+  total_chars: z5.number().int().describe("Length of the full description."),
+  returned_chars: z5.number().int(),
+  offset: z5.number().int(),
+  next_offset: z5.number().int().nullable().describe("Pass as 'offset' to read the rest."),
+  truncated: z5.boolean(),
   critic_score: scoreSchema.nullable(),
   user_score: scoreSchema.nullable(),
-  awards: z4.array(
-    z4.object({
-      ceremony: z4.string().describe("Awards body, such as 'Academy Awards, USA'."),
-      wins: z4.number().int().nullable().describe("Null when the source records no win."),
-      nominations: z4.number().int().nullable()
+  awards: z5.array(
+    z5.object({
+      ceremony: z5.string().describe("Awards body, such as 'Academy Awards, USA'."),
+      wins: z5.number().int().nullable().describe("Null when the source records no win."),
+      nominations: z5.number().int().nullable()
     })
   ).optional().describe("One tally per ceremony. Metacritic publishes no per-category detail."),
-  networks: z4.array(z4.string()).optional().describe("Broadcasters, for shows."),
-  production: z4.array(z4.object({ name: z4.string(), id: z4.number().int().nullable() })).optional(),
-  where_to_watch: z4.array(z4.object({ provider: z4.string(), kind: z4.string(), url: z4.string().nullable() })).optional(),
-  notes: z4.array(z4.string())
+  networks: z5.array(z5.string()).optional().describe("Broadcasters, for shows."),
+  production: z5.array(z5.object({ name: z5.string(), id: z5.number().int().nullable() })).optional(),
+  where_to_watch: z5.array(z5.object({ provider: z5.string(), kind: z5.string(), url: z5.string().nullable() })).optional(),
+  notes: z5.array(z5.string())
 };
 async function runGetTitle(client, args) {
   try {
@@ -1412,7 +1467,7 @@ function render(item, description, critic, user, wanted, offers, production) {
 }
 
 // src/tools/searchTitles.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 var searchTitlesDescription = [
   "Search Metacritic for films, shows and games by title.",
   "Returns one compact row per match, carrying the critic Metascore, so a question about the critical verdict needs no second call.",
@@ -1421,18 +1476,18 @@ var searchTitlesDescription = [
   "There is no paging: 'limit' is the only lever, and results always start from the most relevant match.",
   "This searches titles only. It cannot find an entry from a plot detail, a person or a studio."
 ].join(" ");
-var searchTitlesInputShape = {
-  query: z5.string().min(1).describe("Title or part of one, for example 'the matrix'."),
-  kind: z5.enum(["movie", "show", "game", "any"]).default("any").describe("Restrict results to one catalogue. Metacritic searches all three at once."),
-  limit: z5.number().int().min(1).max(50).default(10).describe("How many rows to return.")
-};
+var searchTitlesInput = strictInput({
+  query: z6.string().min(1).describe("Title or part of one, for example 'the matrix'."),
+  kind: z6.enum(["movie", "show", "game", "any"]).default("any").describe("Restrict results to one catalogue. Metacritic searches all three at once."),
+  limit: z6.number().int().min(1).max(50).default(10).describe("How many rows to return.")
+});
 var searchTitlesOutputShape = {
-  query: z5.string(),
-  results: z5.array(titleSummarySchema),
-  total_available: z5.number().int().describe(
+  query: z6.string(),
+  results: z6.array(titleSummarySchema),
+  total_available: z6.number().int().describe(
     "How many entries Metacritic counted. For a query of several words it counts entries matching any one of them, so the number is far larger than the useful matches and should not be read as a match count."
   ),
-  notes: z5.array(z5.string())
+  notes: z6.array(z6.string())
 };
 async function runSearchTitles(client, args) {
   try {
@@ -1498,8 +1553,8 @@ function createServer(options = {}) {
     {
       title: "Search Metacritic",
       description: searchTitlesDescription,
-      inputSchema: z6.object(searchTitlesInputShape),
-      outputSchema: z6.object(searchTitlesOutputShape),
+      inputSchema: searchTitlesInput,
+      outputSchema: z7.object(searchTitlesOutputShape),
       annotations: READ_ONLY
     },
     async (args) => runSearchTitles(client, args)
@@ -1509,8 +1564,8 @@ function createServer(options = {}) {
     {
       title: "Read an entry",
       description: getTitleDescription,
-      inputSchema: z6.object(getTitleInputShape),
-      outputSchema: z6.object(getTitleOutputShape),
+      inputSchema: getTitleInput,
+      outputSchema: z7.object(getTitleOutputShape),
       annotations: READ_ONLY
     },
     async (args) => runGetTitle(client, args)
@@ -1520,8 +1575,8 @@ function createServer(options = {}) {
     {
       title: "Read reviews",
       description: getReviewsDescription,
-      inputSchema: z6.object(getReviewsInputShape),
-      outputSchema: z6.object(getReviewsOutputShape),
+      inputSchema: getReviewsInput,
+      outputSchema: z7.object(getReviewsOutputShape),
       annotations: READ_ONLY
     },
     async (args) => runGetReviews(client, args)
@@ -1531,8 +1586,8 @@ function createServer(options = {}) {
     {
       title: "Browse rankings",
       description: browseTitlesDescription,
-      inputSchema: z6.object(browseTitlesInputShape),
-      outputSchema: z6.object(browseTitlesOutputShape),
+      inputSchema: browseTitlesInput,
+      outputSchema: z7.object(browseTitlesOutputShape),
       annotations: READ_ONLY
     },
     async (args) => runBrowseTitles(client, args)