cricketstudio-mcp 1.0.2 → 1.2.0

package/data/snapshot/venues.json

@@ -1,144 +1,144 @@
-[
-  {
-    "slug": "narendra-modi-stadium",
-    "name": "Narendra Modi Stadium",
-    "city": "Ahmedabad",
-    "matchCount": 8,
-    "geo": {
-      "latitude": 23.0917,
-      "longitude": 72.5972,
-      "wikidataQid": "Q379935"
-    }
-  },
-  {
-    "slug": "wankhede-stadium",
-    "name": "Wankhede Stadium",
-    "city": "Mumbai",
-    "matchCount": 7,
-    "geo": {
-      "latitude": 18.9388,
-      "longitude": 72.8259,
-      "wikidataQid": "Q1067595"
-    }
-  },
-  {
-    "slug": "bharat-ratna-shri-atal-bihari-vajpayee-ekana-cricket-stadium",
-    "name": "Bharat Ratna Shri Atal Bihari Vajpayee Ekana Cricket Stadium",
-    "city": "Lucknow",
-    "matchCount": 7,
-    "geo": {
-      "latitude": 26.8467,
-      "longitude": 80.9462,
-      "wikidataQid": "Q26257057"
-    }
-  },
-  {
-    "slug": "arun-jaitley-stadium",
-    "name": "Arun Jaitley Stadium",
-    "city": "Delhi",
-    "matchCount": 7,
-    "geo": {
-      "latitude": 28.6379,
-      "longitude": 77.2425,
-      "wikidataQid": "Q582518"
-    }
-  },
-  {
-    "slug": "rajiv-gandhi-international-stadium",
-    "name": "Rajiv Gandhi International Stadium",
-    "city": "Hyderabad",
-    "matchCount": 7,
-    "geo": {
-      "latitude": 17.4068,
-      "longitude": 78.55,
-      "wikidataQid": "Q1419486"
-    }
-  },
-  {
-    "slug": "eden-gardens",
-    "name": "Eden Gardens",
-    "city": "Kolkata",
-    "matchCount": 6,
-    "geo": {
-      "latitude": 22.5645,
-      "longitude": 88.3433,
-      "wikidataQid": "Q582510"
-    }
-  },
-  {
-    "slug": "ma-chidambaram-stadium",
-    "name": "MA Chidambaram Stadium",
-    "city": "Chennai",
-    "matchCount": 6,
-    "geo": {
-      "latitude": 13.0628,
-      "longitude": 80.2792,
-      "wikidataQid": "Q582488"
-    }
-  },
-  {
-    "slug": "m-chinnaswamy-stadium",
-    "name": "M.Chinnaswamy Stadium",
-    "city": "Bengaluru",
-    "matchCount": 5,
-    "geo": {
-      "latitude": 12.9789,
-      "longitude": 77.5993,
-      "wikidataQid": "Q1135028"
-    }
-  },
-  {
-    "slug": "maharaja-yadavindra-singh-international-cricket-stadium-mullanpu",
-    "name": "Maharaja Yadavindra Singh International Cricket Stadium, Mullanpur",
-    "city": "Chandigarh",
-    "matchCount": 4,
-    "geo": {
-      "latitude": 30.776,
-      "longitude": 76.7012
-    }
-  },
-  {
-    "slug": "sawai-mansingh-stadium",
-    "name": "Sawai Mansingh Stadium",
-    "city": "Jaipur",
-    "matchCount": 4,
-    "geo": {
-      "latitude": 26.8867,
-      "longitude": 75.8067,
-      "wikidataQid": "Q1437432"
-    }
-  },
-  {
-    "slug": "barsapara-cricket-stadium",
-    "name": "Barsapara Cricket Stadium",
-    "city": "Guwahati",
-    "matchCount": 3,
-    "geo": {
-      "latitude": 26.1305,
-      "longitude": 91.7966,
-      "wikidataQid": "Q24938094"
-    }
-  },
-  {
-    "slug": "himachal-pradesh-cricket-association-stadium",
-    "name": "Himachal Pradesh Cricket Association Stadium",
-    "city": "Dharamsala",
-    "matchCount": 3,
-    "geo": {
-      "latitude": 32.2393,
-      "longitude": 76.3186,
-      "wikidataQid": "Q5762830"
-    }
-  },
-  {
-    "slug": "shaheed-veer-narayan-singh-international-stadium",
-    "name": "Shaheed Veer Narayan Singh International Stadium",
-    "city": "Raipur",
-    "matchCount": 2,
-    "geo": {
-      "latitude": 21.2514,
-      "longitude": 81.6296,
-      "wikidataQid": "Q7461193"
-    }
-  }
+[
+  {
+    "slug": "narendra-modi-stadium",
+    "name": "Narendra Modi Stadium",
+    "city": "Ahmedabad",
+    "matchCount": 9,
+    "geo": {
+      "latitude": 23.0917,
+      "longitude": 72.5972,
+      "wikidataQid": "Q379935"
+    }
+  },
+  {
+    "slug": "wankhede-stadium",
+    "name": "Wankhede Stadium",
+    "city": "Mumbai",
+    "matchCount": 7,
+    "geo": {
+      "latitude": 18.9388,
+      "longitude": 72.8259,
+      "wikidataQid": "Q1067595"
+    }
+  },
+  {
+    "slug": "bharat-ratna-shri-atal-bihari-vajpayee-ekana-cricket-stadium",
+    "name": "Bharat Ratna Shri Atal Bihari Vajpayee Ekana Cricket Stadium",
+    "city": "Lucknow",
+    "matchCount": 7,
+    "geo": {
+      "latitude": 26.8467,
+      "longitude": 80.9462,
+      "wikidataQid": "Q26257057"
+    }
+  },
+  {
+    "slug": "arun-jaitley-stadium",
+    "name": "Arun Jaitley Stadium",
+    "city": "Delhi",
+    "matchCount": 7,
+    "geo": {
+      "latitude": 28.6379,
+      "longitude": 77.2425,
+      "wikidataQid": "Q582518"
+    }
+  },
+  {
+    "slug": "rajiv-gandhi-international-stadium",
+    "name": "Rajiv Gandhi International Stadium",
+    "city": "Hyderabad",
+    "matchCount": 7,
+    "geo": {
+      "latitude": 17.4068,
+      "longitude": 78.55,
+      "wikidataQid": "Q1419486"
+    }
+  },
+  {
+    "slug": "maharaja-yadavindra-singh-international-cricket-stadium-mullanpu",
+    "name": "Maharaja Yadavindra Singh International Cricket Stadium, Mullanpur",
+    "city": "Chandigarh",
+    "matchCount": 6,
+    "geo": {
+      "latitude": 30.776,
+      "longitude": 76.7012
+    }
+  },
+  {
+    "slug": "eden-gardens",
+    "name": "Eden Gardens",
+    "city": "Kolkata",
+    "matchCount": 6,
+    "geo": {
+      "latitude": 22.5645,
+      "longitude": 88.3433,
+      "wikidataQid": "Q582510"
+    }
+  },
+  {
+    "slug": "ma-chidambaram-stadium",
+    "name": "MA Chidambaram Stadium",
+    "city": "Chennai",
+    "matchCount": 6,
+    "geo": {
+      "latitude": 13.0628,
+      "longitude": 80.2792,
+      "wikidataQid": "Q582488"
+    }
+  },
+  {
+    "slug": "m-chinnaswamy-stadium",
+    "name": "M.Chinnaswamy Stadium",
+    "city": "Bengaluru",
+    "matchCount": 5,
+    "geo": {
+      "latitude": 12.9789,
+      "longitude": 77.5993,
+      "wikidataQid": "Q1135028"
+    }
+  },
+  {
+    "slug": "sawai-mansingh-stadium",
+    "name": "Sawai Mansingh Stadium",
+    "city": "Jaipur",
+    "matchCount": 4,
+    "geo": {
+      "latitude": 26.8867,
+      "longitude": 75.8067,
+      "wikidataQid": "Q1437432"
+    }
+  },
+  {
+    "slug": "himachal-pradesh-cricket-association-stadium",
+    "name": "Himachal Pradesh Cricket Association Stadium",
+    "city": "Dharamsala",
+    "matchCount": 4,
+    "geo": {
+      "latitude": 32.2393,
+      "longitude": 76.3186,
+      "wikidataQid": "Q5762830"
+    }
+  },
+  {
+    "slug": "barsapara-cricket-stadium",
+    "name": "Barsapara Cricket Stadium",
+    "city": "Guwahati",
+    "matchCount": 3,
+    "geo": {
+      "latitude": 26.1305,
+      "longitude": 91.7966,
+      "wikidataQid": "Q24938094"
+    }
+  },
+  {
+    "slug": "shaheed-veer-narayan-singh-international-stadium",
+    "name": "Shaheed Veer Narayan Singh International Stadium",
+    "city": "Raipur",
+    "matchCount": 2,
+    "geo": {
+      "latitude": 21.2514,
+      "longitude": 81.6296,
+      "wikidataQid": "Q7461193"
+    }
+  }
 ]

package/dist/index.js

@@ -163,6 +163,84 @@ function getMatches(limit) {
 function getSeasonStats() {
   return loadSeasonStats();
 }
+var _graphNodes = null;
+var _graphOut = null;
+var _graphIn = null;
+function loadGraph() {
+  if (_graphNodes !== null) return;
+  _graphNodes = /* @__PURE__ */ new Map();
+  _graphOut = /* @__PURE__ */ new Map();
+  _graphIn = /* @__PURE__ */ new Map();
+  const doc = readJson("graph.json");
+  if (!doc) return;
+  for (const [slug, n] of Object.entries(doc.nodes ?? {})) {
+    _graphNodes.set(slug, { slug, type: n.type, name: n.name ?? null });
+  }
+  for (const e of doc.edges ?? []) {
+    if (!_graphOut.has(e.src)) _graphOut.set(e.src, []);
+    _graphOut.get(e.src).push(e);
+    if (!_graphIn.has(e.dst)) _graphIn.set(e.dst, []);
+    _graphIn.get(e.dst).push(e);
+  }
+}
+function getGraphNode(slug) {
+  loadGraph();
+  return _graphNodes.get(slug) ?? null;
+}
+function graphEdges(slug, opts = {}) {
+  loadGraph();
+  const { predicate, direction = "out" } = opts;
+  const collected = [];
+  if (direction === "out" || direction === "both") collected.push(..._graphOut.get(slug) ?? []);
+  if (direction === "in" || direction === "both") collected.push(..._graphIn.get(slug) ?? []);
+  return predicate ? collected.filter((e) => e.predicate === predicate) : collected;
+}
+function graphRelated(slug, opts = {}) {
+  loadGraph();
+  const { predicate, direction = "out", limit = 25 } = opts;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  const push = (otherSlug) => {
+    if (seen.has(otherSlug)) return;
+    const n = _graphNodes.get(otherSlug);
+    if (n) {
+      seen.add(otherSlug);
+      out.push(n);
+    }
+  };
+  if (direction === "out" || direction === "both") {
+    for (const e of _graphOut.get(slug) ?? []) if (!predicate || e.predicate === predicate) push(e.dst);
+  }
+  if (direction === "in" || direction === "both") {
+    for (const e of _graphIn.get(slug) ?? []) if (!predicate || e.predicate === predicate) push(e.src);
+  }
+  return out.slice(0, limit);
+}
+function graphPath(a, b, maxDepth = 4) {
+  loadGraph();
+  if (!_graphNodes.has(a) || !_graphNodes.has(b)) return null;
+  if (a === b) return [a];
+  const visited = /* @__PURE__ */ new Set([a]);
+  let frontier = [[a]];
+  for (let depth = 0; depth < maxDepth; depth++) {
+    const next = [];
+    for (const pathSoFar of frontier) {
+      const last = pathSoFar[pathSoFar.length - 1];
+      const nbrs = /* @__PURE__ */ new Set();
+      for (const e of _graphOut.get(last) ?? []) nbrs.add(e.dst);
+      for (const e of _graphIn.get(last) ?? []) nbrs.add(e.src);
+      for (const nb of nbrs) {
+        if (visited.has(nb)) continue;
+        const newPath = [...pathSoFar, nb];
+        if (nb === b) return newPath;
+        visited.add(nb);
+        next.push(newPath);
+      }
+    }
+    frontier = next;
+  }
+  return null;
+}
 
 // src/tools/ipl-leaderboard.ts
 var LEADERBOARD_ASPECTS = [
@@ -646,7 +724,7 @@ var TOOLS = [
   },
   {
     name: "get_season_stats",
-    description: "IPL 2026 season leaderboard from SETU canonical aggregate. sortBy: runs, wickets, strike_rate, economy, ducks, single_digit_outs, catches, run_outs. Optional teamCode filter. Sample-size floors apply (\u226530 balls faced for SR, \u226515 balls bowled for economy).",
+    description: "IPL 2026 season leaderboard from CricketStudio canonical aggregate. sortBy: runs, wickets, strike_rate, economy, ducks, single_digit_outs, catches, run_outs. Optional teamCode filter. Sample-size floors apply (\u226530 balls faced for SR, \u226515 balls bowled for economy).",
     inputSchema: { type: "object", properties: { sortBy: { type: "string", enum: ["runs", "wickets", "strike_rate", "economy", "ducks", "single_digit_outs", "catches", "run_outs"] }, teamCode: { type: "string", description: "Optional 2\u20134 letter team code e.g. MI, RCB" }, limit: { type: "number", description: "Max rows (default 15, max 100)" } }, required: ["sortBy"], additionalProperties: false }
   },
   {
@@ -716,7 +794,7 @@ var TOOLS = [
   },
   {
     name: "get_fielding_stats",
-    description: "IPL 2026 fielding: catches, run-out assists, total dismissals. Pass playerSlug for a single player, omit for the full leaderboard. Aggregated from the SETU canonical snapshot.",
+    description: "IPL 2026 fielding: catches, run-out assists, total dismissals. Pass playerSlug for a single player, omit for the full leaderboard. Aggregated from the CricketStudio canonical snapshot.",
     inputSchema: { type: "object", properties: { playerSlug: { type: "string", description: "Omit for leaderboard" }, limit: { type: "number", description: "Leaderboard rows (default 15)" } }, additionalProperties: false }
   },
   // ── GROUP 2: MLC ────────────────────────────────────────────────────
@@ -765,8 +843,25 @@ var TOOLS = [
     name: "get_ipl_leaderboard",
     description: 'IPL historical leaderboard from the 18-season Cricsheet corpus (2007/08\u20132025). 35+ aspects: orange-cap, purple-cap, most-sixes, most-fours, strike-rate, economy-leaders, most-matches, most-fifties, most-hundreds, best-bowling-avg, most-ducks, powerplay-economy, death-sr, and per-season variants. Pass season to scope to one year (e.g. "ipl-2024"). Returns canonical URL at /leagues/ipl/leaderboards/{aspect}.',
     inputSchema: { type: "object", properties: { aspect: { type: "string", description: "Leaderboard aspect e.g. orange-cap, purple-cap, most-sixes, economy-leaders" }, season: { type: "string", description: "Optional season slug e.g. ipl-2024 (omit for all-time)" }, limit: { type: "number", description: "Default 20, max 100" } }, required: ["aspect"], additionalProperties: false }
+  },
+  // ── GROUP 5: Knowledge graph (L3) ───────────────────────────────────
+  {
+    name: "get_related_entities",
+    description: 'Knowledge-graph traversal: entities connected to a player or franchise (by slug). Use for "who does Kohli play for", "which bowlers has Kohli faced", "who plays for RCB". Optional `predicate` filters the edge type (plays_for, faced, dismissed_by) and `direction` (out/in/both). Returns related entities + canonical URLs. Does NOT return per-ball detail \u2014 use get_player_h2h for one matchup. Matchup edges mirror the get_player_h2h pair set.',
+    inputSchema: { type: "object", properties: { slug: { type: "string", description: 'Entity slug, e.g. "virat-kohli" or "rcb"' }, predicate: { type: "string", enum: ["plays_for", "faced", "dismissed_by"] }, direction: { type: "string", enum: ["out", "in", "both"] }, limit: { type: "number", description: "Default 25, max 50" } }, required: ["slug"], additionalProperties: false }
+  },
+  {
+    name: "get_player_connections",
+    description: `A player's graph neighbourhood in one call: their franchise (plays_for), most-faced bowlers (by deliveries), and the bowlers who dismissed them most \u2014 each with canonical URLs + aggregate counts. Use for "who are Kohli's toughest bowlers", "which team does Kohli play for". Returns aggregates, not ball-by-ball. Matchup edges mirror the get_player_h2h pair set, so not every opponent appears.`,
+    inputSchema: { type: "object", properties: { playerSlug: { type: "string", description: "kebab-case slug e.g. virat-kohli" }, limit: { type: "number", description: "Default 10, max 50" } }, required: ["playerSlug"], additionalProperties: false }
+  },
+  {
+    name: "get_graph_path",
+    description: 'Shortest connection (\u22644 hops) between two cricket entities in the knowledge graph \u2014 e.g. how one player links to another via a shared franchise. Returns the path as a list of entities with canonical URLs, or connected=false if none within maxDepth. Use for "how is Kohli connected to Bumrah".',
+    inputSchema: { type: "object", properties: { fromSlug: { type: "string", description: "Start entity slug" }, toSlug: { type: "string", description: "End entity slug" }, maxDepth: { type: "number", description: "Default 3, max 4" } }, required: ["fromSlug", "toSlug"], additionalProperties: false }
   }
 ];
+var GraphPredicates = ["plays_for", "faced", "dismissed_by"];
 var validators = {
   get_dataset_summary: z.object({}).strict(),
   search_players: z.object({ query: z.string(), limit: z.number().optional() }).strict(),
@@ -796,7 +891,10 @@ var validators = {
   get_mlc_match_claim: z.object({ matchId: z.string(), kind: z.enum(["top-batter", "top-bowler", "biggest-partnership", "pp-control", "death-domination"]) }).strict(),
   list_mlc_matches: z.object({ season: z.string().optional(), teamSlug: z.string().optional(), limit: z.number().optional() }).strict(),
   list_mlc_leaderboards: z.object({ aspect: z.string(), limit: z.number().optional() }).strict(),
-  get_ipl_leaderboard: z.object({ aspect: z.string(), season: z.string().optional(), limit: z.number().optional() }).strict()
+  get_ipl_leaderboard: z.object({ aspect: z.string(), season: z.string().optional(), limit: z.number().optional() }).strict(),
+  get_related_entities: z.object({ slug: z.string(), predicate: z.enum(GraphPredicates).optional(), direction: z.enum(["out", "in", "both"]).optional(), limit: z.number().optional() }).strict(),
+  get_player_connections: z.object({ playerSlug: z.string(), limit: z.number().optional() }).strict(),
+  get_graph_path: z.object({ fromSlug: z.string(), toSlug: z.string(), maxDepth: z.number().optional() }).strict()
 };
 function handleDatasetSummary() {
   const md = metadata();
@@ -1226,7 +1324,7 @@ function handleListMlcLeaderboards(args) {
   }
   const limit = Math.max(1, Math.min(100, args.limit ?? 20));
   const rows = Array.isArray(lb.rows) ? lb.rows : [];
-  return ok({ aspect: lb.slug, title: lb.title, description: lb.description, metricLabel: lb.metricLabel, floorNote: lb.floorNote ?? null, count: Math.min(limit, rows.length), rows: rows.slice(0, limit).map((r) => ({ ...r, canonicalUrl: mlcPlayerUrl(r.slug) })), provenance: { source: "Cricsheet SETU snapshot", license: "CC BY 3.0" } }, mlcLeaderboardUrl(lb.slug));
+  return ok({ aspect: lb.slug, title: lb.title, description: lb.description, metricLabel: lb.metricLabel, floorNote: lb.floorNote ?? null, count: Math.min(limit, rows.length), rows: rows.slice(0, limit).map((r) => ({ ...r, canonicalUrl: mlcPlayerUrl(r.slug) })), provenance: { source: "Cricsheet aggregate snapshot", license: "CC BY 3.0" } }, mlcLeaderboardUrl(lb.slug));
 }
 var IPL_LB_SPECS = {
   // ── Batting aggregates ──────────────────────────────────────────────
@@ -1318,8 +1416,88 @@ function handleIplLeaderboard(args) {
     provenance: { source: "Cricsheet CC BY 3.0, CricketStudio aggregation", seasons: "2007/08\u20132025", matches: 1169, computedFrom: "ipl-historical.json bySlug career aggregates (deterministic \u2014 no LLM)" }
   }, canonical);
 }
+function urlForGraphNode(n) {
+  switch (n.type) {
+    case "player":
+      return `${SITE}/players/${n.slug}`;
+    case "franchise":
+      return `${SITE}/teams/${n.slug}`;
+    case "venue":
+      return `${SITE}/venues/${n.slug}`;
+    default:
+      return null;
+  }
+}
+function projectGraphNode(n) {
+  return { id: n.slug, type: n.type, name: n.name, canonical_url: urlForGraphNode(n) };
+}
+function handleGetRelatedEntities(args) {
+  const slug = String(args.slug ?? "");
+  const node = getGraphNode(slug);
+  if (!node) return notFound(`No graph entity with slug "${slug}".`);
+  const predicate = args.predicate ? String(args.predicate) : void 0;
+  const direction = args.direction ?? "out";
+  const limit = typeof args.limit === "number" ? Math.min(Math.max(args.limit, 1), 50) : 25;
+  const related = graphRelated(slug, { predicate, direction, limit });
+  return ok({
+    entity: projectGraphNode(node),
+    predicate: predicate ?? "all",
+    direction,
+    count: related.length,
+    related: related.map(projectGraphNode),
+    source: "CricketStudio knowledge graph (L3)"
+  }, urlForGraphNode(node) ?? void 0);
+}
+function handleGetPlayerConnections(args) {
+  const slug = String(args.playerSlug ?? "");
+  const node = getGraphNode(slug);
+  if (!node || node.type !== "player") return notFound(`No player in the graph with slug "${slug}".`);
+  const limit = typeof args.limit === "number" ? Math.min(Math.max(args.limit, 1), 50) : 10;
+  const playsFor = graphEdges(slug, { predicate: "plays_for", direction: "out" }).map((e) => getGraphNode(e.dst)).filter((n) => !!n).map(projectGraphNode);
+  const mostFacedBowlers = graphEdges(slug, { predicate: "faced", direction: "out" }).slice().sort((a, b) => (b.props?.deliveries ?? 0) - (a.props?.deliveries ?? 0)).slice(0, limit).map((e) => {
+    const n = getGraphNode(e.dst);
+    return n ? { ...projectGraphNode(n), deliveries: e.props?.deliveries ?? 0, runs: e.props?.runs ?? 0, dismissals: e.props?.dismissals ?? 0 } : null;
+  }).filter((x) => !!x);
+  const dismissedByMost = graphEdges(slug, { predicate: "dismissed_by", direction: "out" }).slice().sort((a, b) => (b.props?.dismissals ?? 0) - (a.props?.dismissals ?? 0)).slice(0, limit).map((e) => {
+    const n = getGraphNode(e.dst);
+    return n ? { ...projectGraphNode(n), dismissals: e.props?.dismissals ?? 0 } : null;
+  }).filter((x) => !!x);
+  return ok({
+    player: projectGraphNode(node),
+    playsFor,
+    mostFacedBowlers,
+    dismissedByMost,
+    window: "IPL career (faced/dismissed) + IPL 2026 (plays_for)",
+    source: "CricketStudio knowledge graph (L3)",
+    note: "Matchup edges mirror the get_player_h2h pair set; not every opponent is present."
+  }, urlForGraphNode(node) ?? void 0);
+}
+function handleGetGraphPath(args) {
+  const fromSlug = String(args.fromSlug ?? "");
+  const toSlug = String(args.toSlug ?? "");
+  const a = getGraphNode(fromSlug);
+  if (!a) return notFound(`No graph entity with slug "${fromSlug}".`);
+  const b = getGraphNode(toSlug);
+  if (!b) return notFound(`No graph entity with slug "${toSlug}".`);
+  const maxDepth = typeof args.maxDepth === "number" ? Math.min(Math.max(args.maxDepth, 1), 4) : 3;
+  const ids = graphPath(fromSlug, toSlug, maxDepth);
+  if (!ids) {
+    return ok({ from: projectGraphNode(a), to: projectGraphNode(b), connected: false, path: [], note: `No connection within ${maxDepth} hops.`, source: "CricketStudio knowledge graph (L3)" });
+  }
+  return ok({
+    from: projectGraphNode(a),
+    to: projectGraphNode(b),
+    connected: true,
+    hops: ids.length - 1,
+    path: ids.map((id) => {
+      const n = getGraphNode(id);
+      return n ? projectGraphNode(n) : { id, type: "unknown", name: null, canonical_url: null };
+    }),
+    source: "CricketStudio knowledge graph (L3)"
+  });
+}
 var server = new Server(
-  { name: "cricketstudio", version: "1.0.0" },
+  { name: "cricketstudio", version: "1.1.0" },
   { capabilities: { tools: {} } }
 );
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
@@ -1390,6 +1568,12 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         return handleListMlcLeaderboards(args);
       case "get_ipl_leaderboard":
         return handleIplLeaderboard(args);
+      case "get_related_entities":
+        return handleGetRelatedEntities(args);
+      case "get_player_connections":
+        return handleGetPlayerConnections(args);
+      case "get_graph_path":
+        return handleGetGraphPath(args);
       default:
         return ok({ error: "unknown_tool", tool: name });
     }

package/package.json

@@ -1,55 +1,56 @@
-{
-  "name": "cricketstudio-mcp",
-  "version": "1.0.2",
-  "description": "CricketStudio MCP server — 29 tools for IPL 2026, IPL historical (18 seasons), and Major League Cricket data. Citation-grade atomic claims with provenance.",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "cricketstudio-mcp": "dist/index.js"
-  },
-  "scripts": {
-    "build": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js --format=esm --packages=external",
-    "dev": "tsx src/index.ts",
-    "typecheck": "tsc --noEmit",
-    "prepare": "npm run build",
-    "snapshot": "node scripts/build-snapshot.mjs"
-  },
-  "keywords": [
-    "mcp",
-    "cricket",
-    "ipl",
-    "ipl-2026",
-    "ipl-historical",
-    "mlc",
-    "cricketstudio",
-    "claude",
-    "model-context-protocol"
-  ],
-  "author": "Arul Anand / CricketStudio <hello@cricketstudio.ai>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/i-m-arul/cricketstudio-mcp.git"
-  },
-  "homepage": "https://players.cricketstudio.ai/mcp",
-  "mcpName": "io.github.i-m-arul/cricketstudio-mcp",
-  "engines": {
-    "node": ">=18"
-  },
-  "peerDependencies": {},
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "zod": "^3.0.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.0.0",
-    "tsx": "^4.0.0",
-    "esbuild": "^0.20.0"
-  },
-  "files": [
-    "dist/",
-    "data/snapshot/",
-    "README.md",
-    "LICENSE"
-  ]
-}
+{
+  "name": "cricketstudio-mcp",
+  "version": "1.2.0",
+  "description": "CricketStudio MCP server — 32 tools (incl. an L3 knowledge-graph layer) for IPL 2026, IPL historical (18 seasons), and Major League Cricket data. Citation-grade atomic claims with provenance.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "cricketstudio-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js --format=esm --packages=external",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "smoke": "node scripts/smoke-test.mjs",
+    "validate": "node scripts/validate-snapshot.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "cricket",
+    "ipl",
+    "ipl-2026",
+    "ipl-historical",
+    "mlc",
+    "cricketstudio",
+    "claude",
+    "model-context-protocol"
+  ],
+  "author": "Arul Anand / CricketStudio <hello@cricketstudio.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/i-m-arul/cricketstudio-mcp.git"
+  },
+  "homepage": "https://players.cricketstudio.ai/mcp",
+  "mcpName": "io.github.i-m-arul/cricketstudio-mcp",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.21",
+    "esbuild": "^0.28.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/",
+    "data/snapshot/",
+    "README.md",
+    "LICENSE"
+  ]
+}