@chessceo/mcp 0.49.2 → 0.49.4

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",
@@ -371,6 +372,7 @@ async function callToolInner(name, args) {
         case "start_cloud_engine":
             return authedRequest("POST", "/api/agent/cloud-engines", {
                 machineType: String(args.machine_type),
+                ...(typeof args.engine_type === "string" ? { engineType: args.engine_type } : {}),
             });
         case "list_cloud_engines":
             return authedRequest("GET", "/api/agent/cloud-engines");
@@ -443,6 +445,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

@@ -258,20 +258,25 @@ export const TOOLS = [
     },
     {
         name: "list_cloud_machine_options",
-        description: "Returns the catalog of combo cloud-engine machine types the user can start (SKU, human display name, cost per hour, availability). ALWAYS call this before start_cloud_engine — SKU strings like 'rtx-5090-64' do not match the display names ('Stockfish 32 CPUs + Lc0 1× RTX 5090') and are NOT guessable. Present the user the display names + prices; pass the SKU to start_cloud_engine.",
+        description: "Returns the catalog of cloud-engine machine types the user can start — every engine shape (stockfish-only, lc0-only, and combo) they're entitled to, same visibility rules as the chess.ceo app (SKU, which engine(s) it runs, human display name, cost per hour, availability). ALWAYS call this before start_cloud_engine — SKU strings like 'rtx-5090-64' do not match the display names ('Stockfish 32 CPUs + Lc0 1× RTX 5090') and are NOT guessable, and a given SKU only supports the engine(s) shown in its `engine` field (a stockfish-only SKU cannot be started as lc0 or combo). Present the user the display names + prices; pass the SKU to start_cloud_engine.",
         inputSchema: { type: "object", properties: {} },
     },
     {
         name: "start_cloud_engine",
-        description: "Rent a combo GPU instance (Stockfish + Lc0 in the same container) on the user's chess.ceo account. Real money — billed per second while running.\n\n" +
-            "CRITICAL: `machine_type` must be an exact SKU from `list_cloud_machine_options` (e.g. 'rtx-5090-64', NOT 'rtx-5090'). Guessing SKUs will fail. Call list_cloud_machine_options first, show the user the display names + prices, get their confirmation, then pass the SKU here.\n\n" +
-            "Use list_cloud_engines first to check if the user already has one running; don't start a second combo unless the user asked for it. Requires an MCP token with agent access.",
+        description: "Rent a GPU/CPU instance on the user's chess.ceo account — stockfish-only, lc0-only, or combo (both in one container), whichever the chosen SKU provides. Real money — billed per second while running.\n\n" +
+            "CRITICAL: `machine_type` must be an exact SKU from `list_cloud_machine_options` (e.g. 'rtx-5090-64', NOT 'rtx-5090'). Guessing SKUs will fail. Call list_cloud_machine_options first, show the user the display names + prices, get their confirmation, then pass the SKU here. `engine_type` must match what that SKU actually provides (its `engine` field from the catalog) — omit it to default to whatever the SKU is (a combo SKU defaults to \"combo\").\n\n" +
+            "Use list_cloud_engines first to check if the user already has one running; don't start a second instance unless the user asked for it. Requires an MCP token with agent access.",
         inputSchema: {
             type: "object",
             properties: {
                 machine_type: {
                     type: "string",
-                    description: "SKU from list_cloud_machine_options (e.g. 'rtx-5090-64', 'rtx-5090-dual-64'). MUST be the exact SKU, not the display name and not a guess.",
+                    description: "SKU from list_cloud_machine_options (e.g. 'rtx-5090-64', 'rtx-5090', 'epyc-256'). MUST be the exact SKU, not the display name and not a guess.",
+                },
+                engine_type: {
+                    type: "string",
+                    enum: ["stockfish", "lc0", "combo"],
+                    description: "Which engine(s) to run. Must match the SKU's own `engine` field from list_cloud_machine_options — e.g. a stockfish-only SKU can only be started as \"stockfish\". Optional; defaults to \"combo\".",
                 },
             },
             required: ["machine_type"],
@@ -499,6 +504,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.4",
   "description": "Model Context Protocol server for chess.ceo — 11.7M+ games, ~1.5M FIDE player profiles, opening preparation, live broadcasts.",
   "type": "module",
   "bin": {