@cognivia/mcp 0.1.0 → 0.2.0

package/README.md

@@ -1,7 +1,7 @@
 # @cognivia/mcp
 
 A Model Context Protocol server that gives any AI agent Cognivia's learning
-diagnostics as tools: `diagnose_error`, `get_memory_state`, `generate_report`.
+diagnostics as tools: `diagnose_error`, `get_memory_state`, `generate_report`, and (with a live key) `set_item_misconceptions`, `set_concept_prerequisites` to sharpen diagnosis on your own content.
 
 ```jsonc
 { "mcpServers": { "cognivia": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognivia/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Model Context Protocol server for Cognivia. Gives any AI agent learning diagnostics (error type, memory state, session report) as callable tools.",
   "type": "module",
   "bin": { "cognivia-mcp": "server.mjs" },
@@ -10,7 +10,7 @@
   "homepage": "https://cognivia-platform.vercel.app/intelligence",
   "repository": { "type": "git", "url": "git+https://github.com/Manik-Maurya/cognivia-platform.git", "directory": "packages/mcp" },
   "engines": { "node": ">=18" },
-  "dependencies": { "@cognivia/core": "^0.1.0" },
+  "dependencies": { "@cognivia/core": "^0.2.0" },
   "publishConfig": { "access": "public" },
   "license": "MIT",
   "author": "Manik Maurya"

package/server.mjs

@@ -7,6 +7,8 @@
 //   diagnose_error(subject, question, answer, correct, latencyMs, confidence)
 //   get_memory_state(attempts[])
 //   generate_report(attempts[])
+//   set_item_misconceptions(items[])        (live key; sharpens diagnose on your items)
+//   set_concept_prerequisites(prerequisites[]) (live key; enables prerequisite_gap)
 //
 // All computed by @cognivia/core - the same engine behind the site, console, CLI.
 //
@@ -45,6 +47,34 @@ const TOOLS = [
     description: "Build a full Cognivia Session Report (Learning Genome, per-item diagnosis, recommendation) from a set of attempts.",
     inputSchema: { type: "object", properties: { attempts: { type: "array" } }, required: ["attempts"] },
   },
+  {
+    name: "set_item_misconceptions",
+    description: "Upload item -> misconception maps so diagnose names the misconception behind a wrong answer to YOUR own items. Requires COGNIVIA_API_KEY (a self-serve live key).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        items: {
+          type: "array",
+          description: "[{ item_ref, distractors: { \"the wrong option\": \"the misconception it reveals\" } }]",
+        },
+      },
+      required: ["items"],
+    },
+  },
+  {
+    name: "set_concept_prerequisites",
+    description: "Upload concept -> prerequisite maps so diagnose flags a prerequisite_gap when a learner is weak on a foundation you declared. Requires COGNIVIA_API_KEY (a self-serve live key).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        prerequisites: {
+          type: "array",
+          description: "[{ concept, requires: [\"prerequisite concept\", ...] }]",
+        },
+      },
+      required: ["prerequisites"],
+    },
+  },
 ];
 
 function textResult(obj, text) {
@@ -75,6 +105,15 @@ async function callTool(name, a = {}) {
     const rep = core.buildReport(a.attempts || [], { idPrefix: "CGV-MCP" });
     return textResult(rep, core.renderText(rep));
   }
+  // Content maps are remote-only writes to the partner's account (a live key).
+  if (name === "set_item_misconceptions") {
+    if (!remote) throw new Error("Set COGNIVIA_API_KEY (a self-serve live key) to upload content maps.");
+    return textResult(await client.setItemMisconceptions(a.items || []));
+  }
+  if (name === "set_concept_prerequisites") {
+    if (!remote) throw new Error("Set COGNIVIA_API_KEY (a self-serve live key) to upload content maps.");
+    return textResult(await client.setConceptPrerequisites(a.prerequisites || []));
+  }
   throw new Error("unknown tool: " + name);
 }
 
@@ -90,7 +129,7 @@ rl.on("line", async (line) => {
       ok(id, {
         protocolVersion: "2024-11-05",
         capabilities: { tools: {} },
-        serverInfo: { name: "cognivia", version: "0.1.0" },
+        serverInfo: { name: "cognivia", version: "0.2.0" },
       });
     } else if (method === "tools/list") {
       ok(id, { tools: TOOLS });