@chessceo/mcp 0.49.2 → 0.49.3

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
 
-50 tools as of v0.49.2, mirroring the `chess.ceo` API surface. A few of the most-used:
+51 tools as of v0.49.3, 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, renameCollection, searchPrepFiles, } from "./prep/library.js";
+import { createCollection, createPrepFile, findPositionInFiles, listCollections, listPrepFiles, renameCollection, searchPrepFiles, setCollectionFolder, } 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
@@ -44,6 +44,7 @@ const AUTHED_TOOLS = new Set([
     "list_collections",
     "create_collection",
     "rename_collection",
+    "set_collection_folder",
     "list_prep_files",
     "search_prep_files",
     "find_position_in_files",
@@ -443,6 +444,8 @@ async function callToolInner(name, args) {
             return createCollection(args);
         case "rename_collection":
             return renameCollection(args);
+        case "set_collection_folder":
+            return setCollectionFolder(args);
         case "list_prep_files":
             return listPrepFiles(args);
         case "search_prep_files":

package/dist/prep/library.js

@@ -102,6 +102,18 @@ export async function renameCollection(args) {
     const collection = unwrap(raw);
     return { ok: true, id: collection.id, title: collection.title };
 }
+export async function setCollectionFolder(args) {
+    const id = typeof args.id === "string" ? args.id.trim() : "";
+    if (!id)
+        throw new Error("id is required");
+    if (typeof args.folder_path !== "string") {
+        throw new Error("folder_path is required (pass an empty string to move the collection to root)");
+    }
+    const folderPath = args.folder_path.trim();
+    const raw = await authedRequest("PUT", `${PGN_BASE}/${encodeURIComponent(id)}`, { folderPath });
+    const collection = unwrap(raw);
+    return { ok: true, id: collection.id, folder_path: collection.folderPath };
+}
 export async function createPrepFile(args) {
     const collectionId = typeof args.collection_id === "string" ? args.collection_id.trim() : "";
     if (!collectionId) {

package/dist/tools.js

@@ -499,6 +499,18 @@ export const TOOLS = [
             required: ["id", "title"],
         },
     },
+    {
+        name: "set_collection_folder",
+        description: "Move a collection to a different virtual folder — changes only folder_path, not title or contents. Pass an empty string to move it to root (no folder). folder_path is just a string field on each collection, not a real directory: this moves one collection at a time, it does not rename/merge a folder across every collection under it.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "Collection id, from list_collections." },
+                folder_path: { type: "string", description: "New virtual folder path, e.g. '/Openings/Sicilian'. Empty string moves the collection to root." },
+            },
+            required: ["id", "folder_path"],
+        },
+    },
     {
         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.2",
+  "version": "0.49.3",
   "description": "Model Context Protocol server for chess.ceo — 11.7M+ games, ~1.5M FIDE player profiles, opening preparation, live broadcasts.",
   "type": "module",
   "bin": {