@chessceo/mcp 0.17.0 → 0.19.0

package/dist/index.js

@@ -65,6 +65,7 @@ const AUTHED_TOOLS = new Set([
     "create_prep_file",
     "save_prep_file",
     "delete_prep_file",
+    "predict_human_move",
 ]);
 function isAuthedToolCall(body) {
     if (!body || typeof body !== "object")
@@ -269,6 +270,51 @@ const TOOLS = [
             },
         },
     },
+    {
+        name: "predict_human_move",
+        description: "Predicts what a HUMAN of the given rating will most likely play from a position. Rating-conditioned neural net (ResNet-20x256) — you get the top-N most likely moves with their probabilities and a WDL value head (White POV).\n\n" +
+            "This is a completely different question from the engine tools (analyse / cloud_analyse):\n" +
+            "• Engines answer: 'what is objectively best?'\n" +
+            "• predict_human_move answers: 'what will my 2200-rated opponent actually play here?'\n\n" +
+            "Prime use cases in prep:\n" +
+            "• After you've found what the opponent SHOULD do (with the engine), check what they'll ACTUALLY do at their rating. If the top human move is a mistake, you have a real practical advantage.\n" +
+            "• The WDL head is rating-aware — a 400-point gap will show up as a big win probability even in equal positions (the model has learned that human errors compound).\n" +
+            "• Pass `prev_fen` (most recent first) when analysing mid-trade positions — without history the model treats the position as quiet.\n\n" +
+            "Position input is flexible — pass `fen`, or `moves` from startpos, or `fen + moves`. Default rating 2400 both sides. ~1-2s per call. **Premium (or admin/moderator) only** — anonymous calls get 402.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                fen: { type: "string", description: "Starting position as FEN." },
+                moves: {
+                    type: "string",
+                    description: "Optional SAN moves to apply on top of `fen` (or startpos).",
+                },
+                white_elo: {
+                    type: "integer",
+                    minimum: 100,
+                    maximum: 3400,
+                    description: "White's rating (default 2400).",
+                },
+                black_elo: {
+                    type: "integer",
+                    minimum: 100,
+                    maximum: 3400,
+                    description: "Black's rating (default 2400).",
+                },
+                top: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 20,
+                    description: "Number of top predicted moves to return (default 5).",
+                },
+                prev_fens: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Previous FEN(s), most recent first. Optional — omit for quiet-position analysis. Useful mid-trade so the model doesn't assume the position is stable.",
+                },
+            },
+        },
+    },
     {
         name: "get_head_to_head",
         description: "Complete head-to-head record between two players. Includes overall and per-colour W/D/L (from player A's perspective), splits by time control, most-played openings between them, first / last meeting, average game length, and the game list.",
@@ -743,6 +789,24 @@ async function callToolInner(name, args) {
             const raw = await get("/api/chess/database/analyse", params);
             return convertAnalyseResponse(raw, fen);
         }
+        case "predict_human_move": {
+            const fen = resolveFenFromArgs(args);
+            const qs = new URLSearchParams();
+            qs.set("fen", fen);
+            if (typeof args.white_elo === "number")
+                qs.set("white_elo", String(args.white_elo));
+            if (typeof args.black_elo === "number")
+                qs.set("black_elo", String(args.black_elo));
+            if (typeof args.top === "number")
+                qs.set("top", String(args.top));
+            if (Array.isArray(args.prev_fens)) {
+                for (const p of args.prev_fens) {
+                    if (typeof p === "string" && p.length > 0)
+                        qs.append("prev_fen", p);
+                }
+            }
+            return authedRequest("GET", `/api/agent/predict-move?${qs.toString()}`);
+        }
         case "get_head_to_head":
             return get("/api/chess/players/h2h", {
                 a: Number(args.fide_id_a),

package/package.json

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