@chessceo/mcp 0.49.0 → 0.49.2

package/README.md

@@ -6,7 +6,7 @@ Player/game lookups need no API key or auth. Cloud engines and prep-file tools n
 
 ## What it can do
 
-49 tools as of v0.49.0, mirroring the `chess.ceo` API surface. A few of the most-used:
+50 tools as of v0.49.2, mirroring the `chess.ceo` API surface. A few of the most-used:
 
 | Tool | What it answers |
 |---|---|

package/dist/index.js

@@ -29,7 +29,7 @@ import { getNodeByPath, resolveFromNodeOrFen, storeEvalOnNode, } from "./analysi
 import { findPositionInCourses, readCourseAtPosition, runSfEval } from "./courses.js";
 import { applyBatchMutations, applyMutation, argNodeId, } from "./prep/mutations.js";
 import { listNodes, listTranspositions, readPrepFile, } from "./prep/read.js";
-import { createCollection, createPrepFile, findPositionInFiles, listCollections, listPrepFiles, searchPrepFiles, } from "./prep/library.js";
+import { createCollection, createPrepFile, findPositionInFiles, listCollections, listPrepFiles, renameCollection, searchPrepFiles, } from "./prep/library.js";
 import { convertAvailableMovesToSAN, normalizeSourceForBackend, stripPositionResponse, trimGamesMovetext, } from "./response_transforms.js";
 // Tools that require an MCP token — cloud engine + prep-file tools
 // operate on the caller's own account so we can't service them
@@ -43,6 +43,7 @@ const AUTHED_TOOLS = new Set([
     "cloud_analyse",
     "list_collections",
     "create_collection",
+    "rename_collection",
     "list_prep_files",
     "search_prep_files",
     "find_position_in_files",
@@ -440,6 +441,8 @@ async function callToolInner(name, args) {
             return listCollections(args);
         case "create_collection":
             return createCollection(args);
+        case "rename_collection":
+            return renameCollection(args);
         case "list_prep_files":
             return listPrepFiles(args);
         case "search_prep_files":

package/dist/prep/library.js

@@ -53,8 +53,11 @@ export async function searchPrepFiles(args) {
     if (!q)
         throw new Error("query required");
     const raw = await authedRequest("GET", `${PGN_BASE}/games/search?q=${encodeURIComponent(q)}&limit=100`);
-    const data = unwrap(raw);
-    const games = data?.games ?? [];
+    // Unlike list_prep_files' {games:[...]} envelope, the cross-collection
+    // search handler (RespondPaginated) puts the array straight into `data` —
+    // `data?.games` was always undefined here, so this silently returned []
+    // for every query/position regardless of real matches (found 2026-09-11).
+    const games = unwrap(raw) ?? [];
     return { query: q, prep_files: games.map(projectGameRow) };
 }
 export async function findPositionInFiles(args) {
@@ -63,8 +66,8 @@ export async function findPositionInFiles(args) {
     const resolved = await resolveFromNodeOrFen(args);
     const fen = resolved.fen;
     const raw = await authedRequest("GET", `${PGN_BASE}/games/search?position=${encodeURIComponent(fen)}&limit=100`);
-    const data = unwrap(raw);
-    const games = data?.games ?? [];
+    // See searchPrepFiles above — RespondPaginated's `data` is the array itself.
+    const games = unwrap(raw) ?? [];
     return {
         fen,
         match_count: games.length,
@@ -88,6 +91,17 @@ export async function createCollection(args) {
         folder_path: collection.folderPath,
     };
 }
+export async function renameCollection(args) {
+    const id = typeof args.id === "string" ? args.id.trim() : "";
+    if (!id)
+        throw new Error("id is required");
+    const title = String(args.title || "").trim();
+    if (!title)
+        throw new Error("title is required");
+    const raw = await authedRequest("PUT", `${PGN_BASE}/${encodeURIComponent(id)}`, { title });
+    const collection = unwrap(raw);
+    return { ok: true, id: collection.id, title: collection.title };
+}
 export async function createPrepFile(args) {
     const collectionId = typeof args.collection_id === "string" ? args.collection_id.trim() : "";
     if (!collectionId) {

package/dist/tools.js

@@ -487,6 +487,18 @@ export const TOOLS = [
             required: ["title"],
         },
     },
+    {
+        name: "rename_collection",
+        description: "Rename a collection — changes only its title, not its contents or folder_path. Use when reorganizing: consolidating similarly-named collections, fixing a typo, or renaming a working title to something clearer once its scope is settled.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "Collection id, from list_collections." },
+                title: { type: "string", description: "New collection name." },
+            },
+            required: ["id", "title"],
+        },
+    },
     {
         name: "create_prep_file",
         description: "Create a new (empty) prep file in the specified collection. `name` becomes the Event PGN tag. You then extend it with mutation tools (add_move, set_comment, …).\n\n" +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chessceo/mcp",
-  "version": "0.49.0",
+  "version": "0.49.2",
   "description": "Model Context Protocol server for chess.ceo — 11.7M+ games, ~1.5M FIDE player profiles, opening preparation, live broadcasts.",
   "type": "module",
   "bin": {