@plur-ai/mcp 0.11.0 → 0.12.0

package/README.md

@@ -52,6 +52,7 @@ Your agent gets these tools automatically:
 |------|-------------|
 | `plur_session_start` | Start a session — injects relevant engrams for your task |
 | `plur_learn` | Store a memory — correction, preference, convention, or decision |
+| `plur_learn_batch` | Store many memories in one call — same dedup + policy as `plur_learn`, with per-item failure isolation |
 | `plur_recall_hybrid` | **Best default** — BM25 + embeddings merged via RRF. Zero cost. |
 | `plur_recall` | Keyword search (BM25 only, instant) |
 | `plur_inject_hybrid` | Load relevant memories for the current task |

package/dist/index.js

@@ -5,7 +5,7 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, statSy
 import { join } from "path";
 import { fileURLToPath } from "url";
 import { homedir, platform } from "os";
-var VERSION = "0.11.0";
+var VERSION = "0.12.0";
 var HELP = `plur-mcp v${VERSION} \u2014 persistent memory for AI agents
 
 Usage:
@@ -65,6 +65,12 @@ var PLUR_HOOKS = {
     matcher: "auto|manual",
     hooks: [{ type: "command", command: `${CLI} hook-inject --rehydrate`, timeout: 15 }]
   }],
+  // Auto-close the memory lifecycle at session end (Claude Code SessionEnd,
+  // shipped v1.0.85) — captures a closing episode and cleans up the session
+  // checkpoint even if the agent forgot to call plur_session_end (#217).
+  SessionEnd: [{
+    hooks: [{ type: "command", command: `${CLI} hook-session-end`, timeout: 5 }]
+  }],
   // --- Contextual injection ---
   PreToolUse: [
     { matcher: "EnterPlanMode", hooks: [{ type: "command", command: `${CLI} hook-inject --event plan_mode`, timeout: 10 }] },
@@ -98,7 +104,7 @@ Hooks inject engrams automatically on every first message \u2014 you do not need
 2. **Learn**: When corrected or discovering something new, call \`plur_learn\` immediately
 3. **Recall**: Before answering factual questions, call \`plur_recall_hybrid\` \u2014 check memory first
 4. **Feedback**: Rate injected engrams with \`plur_feedback\` (positive/negative) \u2014 trains relevance
-5. **End**: Call \`plur_session_end\` with summary + engram_suggestions
+5. **End**: Call \`plur_session_end\` with summary + engram_suggestions \u2014 a SessionEnd hook auto-closes the lifecycle if you forget, but calling it yourself captures higher-quality learnings
 
 Do not ask permission to use these tools \u2014 they are your memory system.
 
@@ -279,7 +285,7 @@ if (arg === "init") {
   process.exit(0);
 }
 if (arg === "serve" || arg === void 0) {
-  const { runStdio } = await import("./server-M7GBKD4M.js");
+  const { runStdio } = await import("./server-6CNGJXSW.js");
   runStdio().catch((err) => {
     console.error("Failed to start PLUR MCP server:", err);
     process.exit(1);

package/dist/{server-M7GBKD4M.js → server-6CNGJXSW.js}

@@ -31,9 +31,10 @@ function recordTelemetry(event) {
 }
 
 // src/version.ts
-var VERSION = "0.11.0";
+var VERSION = "0.12.0";
 
 // src/tools.ts
+import { z } from "zod";
 function makeHttpLlm(baseUrl, apiKey, model = "gpt-4o-mini") {
   return async (prompt) => {
     const response = await fetch(`${baseUrl.replace(/\/$/, "")}/chat/completions`, {
@@ -55,6 +56,73 @@ function makeHttpLlm(baseUrl, apiKey, model = "gpt-4o-mini") {
     return data.choices?.[0]?.message?.content ?? "";
   };
 }
+function jsonSchemaPropToZod(prop) {
+  if (!prop || typeof prop !== "object") return z.unknown();
+  const variants = prop.anyOf ?? prop.oneOf;
+  if (Array.isArray(variants) && variants.length > 0) {
+    const zodVariants = variants.map(jsonSchemaPropToZod);
+    if (zodVariants.length === 1) return zodVariants[0];
+    return z.union(zodVariants);
+  }
+  if (prop.type === "string") return prop.enum ? z.enum(prop.enum) : z.string();
+  if (prop.type === "number" || prop.type === "integer") return z.number();
+  if (prop.type === "boolean") return z.boolean();
+  if (prop.type === "array") {
+    const itemSchema = prop.items ? jsonSchemaPropToZod(prop.items) : z.unknown();
+    return z.preprocess((val) => {
+      if (typeof val !== "string") return val;
+      const trimmed = val.trim();
+      if (trimmed.startsWith("[")) {
+        try {
+          const parsed = JSON.parse(trimmed);
+          return Array.isArray(parsed) ? parsed : val;
+        } catch {
+          return val;
+        }
+      }
+      if (prop.items?.type === "string") {
+        return trimmed.length === 0 ? [] : trimmed.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+      }
+      return val;
+    }, z.array(itemSchema));
+  }
+  if (prop.type === "object" && prop.properties) {
+    const shape = {};
+    for (const [k, p] of Object.entries(prop.properties)) {
+      const field = jsonSchemaPropToZod(p);
+      shape[k] = prop.required?.includes(k) ? field : field.optional();
+    }
+    return z.object(shape).passthrough();
+  }
+  return z.unknown();
+}
+function validateToolArgs(tool, rawArgs) {
+  const schema = tool.inputSchema;
+  if (!schema?.properties) return { ok: true, data: rawArgs };
+  const shape = {};
+  for (const [key, prop] of Object.entries(schema.properties)) {
+    const field = jsonSchemaPropToZod(prop);
+    shape[key] = schema.required?.includes(key) ? field : field.optional();
+  }
+  const parsed = z.object(shape).passthrough().safeParse(rawArgs);
+  if (!parsed.success) {
+    const receivedFields = Object.keys(rawArgs);
+    const details = parsed.error.issues.map((i) => `${i.path.join(".") || "root"}: ${i.message}`).join(", ");
+    const hasArrayParam = Object.values(schema.properties ?? {}).some((p) => p?.type === "array");
+    const arrayBugHint = receivedFields.length === 0 && hasArrayParam ? ' Known client-side bug (plur-ai/plur#297): some MCP clients drop the entire arguments payload when an array-typed parameter is included. Retry passing array parameters as a JSON string (e.g. tags: "[\\"a\\",\\"b\\"]") or a comma-separated string (tags: "a, b") \u2014 the server coerces both back into arrays.' : "";
+    const receivedNote = receivedFields.length > 0 ? `Received fields: [${receivedFields.join(", ")}].` : "Received no fields (the arguments object was empty).";
+    return {
+      ok: false,
+      errorPayload: {
+        error: `Invalid arguments: ${details}. ${receivedNote} The call reached the server \u2014 this is a malformed-arguments error, not a transport failure. Fix the field(s) named above and retry; do not abandon the call.` + arrayBugHint,
+        success: false,
+        received_fields: receivedFields,
+        _isError: true
+      }
+    };
+  }
+  return { ok: true, data: parsed.data };
+}
 var PLUR_GUIDE_EMPTY = `## PLUR \u2014 Empty Store
 
 You have **0 engrams**. This session's learnings will be lost unless you store them.
@@ -111,7 +179,67 @@ mcpCanary.expect({
   description: "Learning from corrections",
   fix: "Call plur_learn when corrected. If using hooks, verify they are installed."
 });
-function getToolDefinitions() {
+var CURSOR_CORE_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "plur_session_start",
+  "plur_session_end",
+  "plur_learn",
+  "plur_recall_hybrid",
+  "plur_feedback",
+  "plur_forget",
+  "plur_status",
+  "plur_doctor",
+  "plur_packs_uninstall",
+  "plur_tensions_purge"
+]);
+function buildAdminDispatchTool(all) {
+  const byName = new Map(all.map((t) => [t.name, t]));
+  const adminActions = all.map((t) => t.name).filter((n) => !CURSOR_CORE_TOOL_NAMES.has(n)).sort();
+  return {
+    name: "plur_admin",
+    description: `Dispatch for less-common PLUR operations (packs, sync, tensions, stores, timeline, ingest, and more), collapsed into one tool so Cursor's ~40-tool-per-workspace limit is not exhausted by PLUR alone. Set "action" to the underlying tool name and "args" to that tool's normal arguments. Valid actions: ${adminActions.join(", ")}.`,
+    annotations: { title: "Admin dispatch", readOnlyHint: false },
+    inputSchema: {
+      type: "object",
+      properties: {
+        // No `enum` here — an invalid action must reach the handler's custom
+        // Unknown-action message with the full valid-actions list, not fail
+        // at top-level schema validation with a generic "Invalid arguments"
+        // error. If `enum: adminActions` were set, the top-level
+        // CallToolRequestSchema handler's Zod validation would reject
+        // unknown actions before this handler's `if (!target)` branch ever
+        // ran.
+        action: { type: "string", description: "Which underlying plur_* tool to invoke" },
+        args: { type: "object", description: "Arguments for the chosen action, matching that tool's normal input schema", additionalProperties: true }
+      },
+      required: ["action"]
+    },
+    handler: async (args, plur) => {
+      const action = args.action;
+      const target = byName.get(action);
+      if (!target) {
+        return { error: `Unknown action "${action}". Valid actions: ${adminActions.join(", ")}`, success: false, _isError: true };
+      }
+      const innerArgs = args.args ?? {};
+      const validated = validateToolArgs(target, innerArgs);
+      if (!validated.ok) {
+        return { ...validated.errorPayload, error: `${action}: ${validated.errorPayload.error}` };
+      }
+      try {
+        return await target.handler(validated.data, plur);
+      } catch (err) {
+        const message = err?.message ?? String(err);
+        throw new Error(`${action}: ${message}`);
+      }
+    }
+  };
+}
+function getToolDefinitions(profile = "full") {
+  const all = getAllToolDefinitions();
+  if (profile !== "cursor") return all;
+  const core = all.filter((t) => CURSOR_CORE_TOOL_NAMES.has(t.name));
+  return [...core, buildAdminDispatchTool(all)];
+}
+function getAllToolDefinitions() {
   return [
     {
       name: "plur_learn",
@@ -219,6 +347,82 @@ function getToolDefinitions() {
         }
       }
     },
+    {
+      name: "plur_learn_batch",
+      description: "Create many engrams in one call \u2014 the batch form of plur_learn. Accepts an array of engram objects and writes them sequentially through the SAME dedup + policy pipeline as plur_learn (content-hash NOOP \u2192 semantic recall \u2192 LLM ADD/UPDATE/MERGE decision). Dedup also applies WITHIN the batch: a statement duplicating an earlier item in the same array resolves to NOOP against it. Returns the created/affected engram ids in input order, the per-item decisions, aggregate stats, and any per-item failures \u2014 a single bad item does not abort the batch. Use this when an orchestration fans out and wants to persist consolidated findings without N separate calls. LLM dedup calls are capped (default 50, override with max_llm_calls) to bound bulk-import cost. Note: unlike plur_learn, batch items take the LOCAL learn path \u2014 remote-scope auto-routing (learnRouted) is not applied per item, so for shared/remote-store writes prefer plur_learn or pass an explicit local scope. See plur-ai/plur#281.",
+      annotations: { title: "Learn (batch)", destructiveHint: false, idempotentHint: false },
+      inputSchema: {
+        type: "object",
+        properties: {
+          engrams: {
+            type: "array",
+            description: "Engram objects to persist. Each requires `statement`; the other fields mirror plur_learn.",
+            items: {
+              type: "object",
+              properties: {
+                statement: { type: "string", description: "The knowledge assertion to store" },
+                type: { type: "string", enum: ["behavioral", "terminological", "procedural", "architectural"], description: "Category of the engram" },
+                scope: { type: "string", description: "Namespace, e.g. global, project:myapp" },
+                domain: { type: "string", description: "Domain tag, e.g. software.deployment" },
+                tags: { type: "array", items: { type: "string" }, description: "Searchable keyword tags \u2014 contribute to BM25/embedding recall" },
+                rationale: { type: "string", description: "Why this knowledge matters \u2014 also enters the search corpus" },
+                source: { type: "string", description: "Origin of this knowledge (URL, conversation ref, etc.)" },
+                pinned: { type: "boolean", description: "Always-load flag. Use sparingly: meta-rules, safety conventions, core principles." },
+                commitment: { type: "string", enum: ["exploring", "leaning", "decided", "locked"], description: "How firmly the user has committed (default: leaning)" },
+                valid_from: { type: "string", description: "ISO date (YYYY-MM-DD) the knowledge becomes valid" },
+                valid_until: { type: "string", description: "ISO date (YYYY-MM-DD) the knowledge expires" }
+              },
+              required: ["statement"]
+            }
+          },
+          max_llm_calls: { type: "number", description: "Max LLM dedup calls across the whole batch (default 50). Once spent, remaining items use the cheap hash/cosine path. Pass a large number to opt out." }
+        },
+        required: ["engrams"]
+      },
+      handler: async (args, plur) => {
+        const llm = getLlmFunction();
+        const raw = Array.isArray(args.engrams) ? args.engrams : [];
+        if (raw.length === 0) {
+          return { ids: [], results: [], stats: { added: 0, updated: 0, merged: 0, noops: 0, failed: 0 }, failures: [], warning: "No engrams provided \u2014 pass a non-empty `engrams` array." };
+        }
+        const items = raw.map((e) => ({
+          statement: sanitizeStatement(e.statement),
+          context: {
+            type: e.type,
+            scope: e.scope,
+            domain: e.domain,
+            source: e.source,
+            tags: e.tags,
+            rationale: e.rationale,
+            commitment: e.commitment,
+            pinned: e.pinned,
+            valid_from: e.valid_from,
+            valid_until: e.valid_until
+          }
+        }));
+        const maxLlmCalls = typeof args.max_llm_calls === "number" ? args.max_llm_calls : void 0;
+        const { results, stats, failures } = await plur.learnBatch(
+          items,
+          llm,
+          maxLlmCalls !== void 0 ? { maxLlmCalls } : void 0
+        );
+        mcpCanary.signal("learn_activity");
+        recordTelemetry("learn");
+        return {
+          ids: results.map((r) => r.engram.id),
+          results: results.map((r) => ({
+            id: r.engram.id,
+            statement: r.engram.statement,
+            scope: r.engram.scope,
+            type: r.engram.type,
+            decision: r.decision,
+            ...r.existing_id ? { existing_id: r.existing_id } : {}
+          })),
+          stats,
+          ...failures.length > 0 ? { failures, warning: `${failures.length} of ${raw.length} engram(s) failed to persist; the rest were written.` } : {}
+        };
+      }
+    },
     {
       name: "plur_recall",
       description: "Query engrams by BM25 keyword matching \u2014 use plur_recall_hybrid for semantic similarity. Note: a project-scope filter also returns personal-family engrams (local, global, user:*, agent:*); an explicit scope=global recall returns ALL personal-family engrams \u2014 wider than scope=global INJECT, which is targeted to the global namespace only.",
@@ -242,14 +446,18 @@ function getToolDefinitions() {
           limit: args.limit
         });
         return {
-          results: results.map((e) => ({
-            id: e.id,
-            statement: e.statement,
-            type: e.type,
-            scope: e.scope,
-            domain: e.domain,
-            retrieval_strength: e.activation.retrieval_strength
-          })),
+          results: results.map((e) => {
+            const supersededBy = e.relations?.superseded_by;
+            const annotation = supersededBy?.length ? ` [superseded by ${supersededBy.join(", ")}]` : "";
+            return {
+              id: e.id,
+              statement: e.statement + annotation,
+              type: e.type,
+              scope: e.scope,
+              domain: e.domain,
+              retrieval_strength: e.activation.retrieval_strength
+            };
+          }),
           count: results.length
         };
       }
@@ -305,9 +513,11 @@ function getToolDefinitions() {
         const response = {
           results: boundedResults.map((e) => {
             const raw = e;
+            const supersededBy = e.relations?.superseded_by;
+            const annotation = supersededBy?.length ? ` [superseded by ${supersededBy.join(", ")}]` : "";
             const base = {
               id: e.id,
-              statement: e.statement,
+              statement: e.statement + annotation,
               type: e.type,
               scope: e.scope,
               domain: e.domain,
@@ -964,7 +1174,7 @@ function getToolDefinitions() {
     },
     {
       name: "plur_doctor",
-      description: 'Diagnose the PLUR install. Reports whether the embedding model loaded, whether hybrid search is fully operational, and \u2014 for any configured enterprise/remote store \u2014 whether its auth is valid (probes /api/v1/me and decodes token expiry), so a dead or soon-to-expire token surfaces instead of hiding behind a "healthy" report. Run this first when recall feels off or team engrams stop syncing.',
+      description: 'Diagnose the PLUR ENGINE (embedder, hybrid search, remote-store auth) \u2014 not hook/MCP wiring. Reports whether the embedding model loaded, whether hybrid search is fully operational, and \u2014 for any configured enterprise/remote store \u2014 whether its auth is valid (probes /api/v1/me and decodes token expiry), so a dead or soon-to-expire token surfaces instead of hiding behind a "healthy" report. Run this first when recall feels off or team engrams stop syncing. Does NOT check .cursor/mcp.json, .cursor/hooks.json, or the live MCP tool count \u2014 for that, run the `plur doctor` CLI command in a terminal (a different, more thorough check with the same name).',
       annotations: { title: "Doctor", readOnlyHint: false, idempotentHint: false },
       inputSchema: {
         type: "object",
@@ -1056,6 +1266,23 @@ function getToolDefinitions() {
             }
           }
           checks.push({ check: "reranker available", ok: rerankerOk, detail: rerankerDetail });
+          if (rerankerOk) {
+            try {
+              const fitResult = await plur.checkRerankerFit({ rerankerName });
+              const sep = fitResult.separability.toFixed(3);
+              checks.push({
+                check: "reranker domain fit",
+                ok: fitResult.fit,
+                detail: fitResult.n_pairs === 0 ? "Not enough engrams to evaluate fit (< 2) \u2014 assuming fit" : fitResult.fit ? `Good fit \u2014 separability ${sep} on ${fitResult.n_pairs} pairs (threshold \u2265 0.05)` : `Poor fit \u2014 separability ${sep} on ${fitResult.n_pairs} pairs (threshold \u2265 0.05). Reranker may be net-negative on this store's domain mix.`
+              });
+              if (!fitResult.fit && fitResult.n_pairs > 0) {
+                remediation.push(
+                  `Reranker "${rerankerName}" shows poor separability (${sep}) on this store's engrams \u2014 it may be scoring irrelevant pairs higher than relevant ones. Consider unsetting PLUR_RERANKER or switching to a different tier. The fit check compares same-domain vs cross-domain pair scores; low separability means the model lacks signal on your content.`
+                );
+              }
+            } catch {
+            }
+          }
           try {
             let evalStatus;
             let freshlyRun = false;
@@ -1510,11 +1737,27 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
         if (discoveries.length === 0) {
           return { discovered: [], note: "No remote stores configured. Register one scope first with plur_stores_add, then discover the rest." };
         }
+        const enrich = (d) => {
+          if (!d.ok) return d;
+          const byScope = new Map(d.metadata.map((m) => [m.scope, m]));
+          const registeredSet = new Set(d.registered);
+          const scopes = d.authorized.map((scope) => {
+            const m = byScope.get(scope);
+            return {
+              scope,
+              registered: registeredSet.has(scope),
+              ...m?.description ? { description: m.description } : {},
+              ...m && m.covers.length ? { covers: m.covers } : {}
+            };
+          });
+          return { ...d, scopes };
+        };
+        const discovered = discoveries.map(enrich);
         if (!register) {
-          return { discovered: discoveries };
+          return { discovered };
         }
         const registered = await plur.registerDiscoveredScopes({ url });
-        return { discovered: discoveries, registered };
+        return { discovered, registered };
       }
     },
     {
@@ -1931,7 +2174,6 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
 }
 
 // src/server.ts
-import { z } from "zod";
 var INSTRUCTIONS = `PLUR is your persistent memory. Corrections, preferences, and conventions persist across sessions as engrams.
 
 PLUR is a GLOBAL tool \u2014 one MCP server, one engram store (~/.plur/), available in every project. Multi-project scoping uses domain/scope fields on engrams, not separate installations.
@@ -2049,49 +2291,9 @@ Use \`scope\` to namespace engrams per project:
 
 Override with \`PLUR_PATH\` environment variable.
 `;
-function jsonSchemaPropToZod(prop) {
-  if (!prop || typeof prop !== "object") return z.unknown();
-  const variants = prop.anyOf ?? prop.oneOf;
-  if (Array.isArray(variants) && variants.length > 0) {
-    const zodVariants = variants.map(jsonSchemaPropToZod);
-    if (zodVariants.length === 1) return zodVariants[0];
-    return z.union(zodVariants);
-  }
-  if (prop.type === "string") return prop.enum ? z.enum(prop.enum) : z.string();
-  if (prop.type === "number" || prop.type === "integer") return z.number();
-  if (prop.type === "boolean") return z.boolean();
-  if (prop.type === "array") {
-    const itemSchema = prop.items ? jsonSchemaPropToZod(prop.items) : z.unknown();
-    return z.preprocess((val) => {
-      if (typeof val !== "string") return val;
-      const trimmed = val.trim();
-      if (trimmed.startsWith("[")) {
-        try {
-          const parsed = JSON.parse(trimmed);
-          return Array.isArray(parsed) ? parsed : val;
-        } catch {
-          return val;
-        }
-      }
-      if (prop.items?.type === "string") {
-        return trimmed.length === 0 ? [] : trimmed.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
-      }
-      return val;
-    }, z.array(itemSchema));
-  }
-  if (prop.type === "object" && prop.properties) {
-    const shape = {};
-    for (const [k, p] of Object.entries(prop.properties)) {
-      const field = jsonSchemaPropToZod(p);
-      shape[k] = prop.required?.includes(k) ? field : field.optional();
-    }
-    return z.object(shape).passthrough();
-  }
-  return z.unknown();
-}
-async function createServer(plur) {
+async function createServer(plur, options) {
   const instance = plur ?? new Plur2();
-  const tools = getToolDefinitions();
+  const tools = getToolDefinitions(options?.profile ?? "full");
   checkForUpdate("@plur-ai/mcp", VERSION, (r) => {
     if (r.updateAvailable) {
       console.error(`[plur] Update available: ${r.current} \u2192 ${r.latest}. Run: npx @plur-ai/mcp@latest`);
@@ -2128,33 +2330,26 @@ async function createServer(plur) {
     mcpCanary.tick();
     try {
       let args = request.params.arguments ?? {};
-      const schema = tool.inputSchema;
-      if (schema?.properties) {
-        const shape = {};
-        for (const [key, prop] of Object.entries(schema.properties)) {
-          const field = jsonSchemaPropToZod(prop);
-          shape[key] = schema.required?.includes(key) ? field : field.optional();
-        }
-        const parsed = z.object(shape).passthrough().safeParse(args);
-        if (!parsed.success) {
-          const receivedFields = Object.keys(args);
-          const details = parsed.error.issues.map((i) => `${i.path.join(".") || "root"}: ${i.message}`).join(", ");
-          const receivedNote = receivedFields.length > 0 ? `Received fields: [${receivedFields.join(", ")}].` : "Received no fields (the arguments object was empty).";
-          const hasArrayParam = Object.values(schema.properties).some((p) => p?.type === "array");
-          const arrayBugHint = receivedFields.length === 0 && hasArrayParam ? ' Known client-side bug (plur-ai/plur#297): some MCP clients drop the entire arguments payload when an array-typed parameter is included. Retry passing array parameters as a JSON string (e.g. tags: "[\\"a\\",\\"b\\"]") or a comma-separated string (tags: "a, b") \u2014 the server coerces both back into arrays.' : "";
-          return {
-            content: [{ type: "text", text: JSON.stringify({
-              error: `Invalid arguments: ${details}. ${receivedNote} The call reached the server \u2014 this is a malformed-arguments error, not a transport failure. Fix the field(s) named above and retry; do not abandon the call.` + arrayBugHint,
-              success: false,
-              received_fields: receivedFields
-            }) }],
-            isError: true
-          };
-        }
-        args = parsed.data;
+      const validated = validateToolArgs(tool, args);
+      if (!validated.ok) {
+        return {
+          content: [{ type: "text", text: JSON.stringify(validated.errorPayload) }],
+          isError: true
+        };
       }
+      args = validated.data;
       const result = await tool.handler(args, instance);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      let payload = result;
+      let resultIsError = false;
+      if (result && typeof result === "object" && result._isError === true) {
+        resultIsError = true;
+        const { _isError, ...rest } = result;
+        payload = rest;
+      }
+      return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        ...resultIsError ? { isError: true } : {}
+      };
     } catch (err) {
       const message = err?.message ?? String(err);
       server.sendLoggingMessage({ level: "error", data: `Tool ${request.params.name} failed: ${message}` });
@@ -2183,11 +2378,16 @@ async function createServer(plur) {
   server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     const uri = request.params.uri;
     if (uri === "plur://guide") {
+      const cursorNote = options?.profile === "cursor" ? `
+
+## Cursor tool profile
+
+Most tools above are NOT directly callable in this session \u2014 only ${[...CURSOR_CORE_TOOL_NAMES].join(", ")} are top-level tools here. Everything else in this guide is reachable through **plur_admin**: call it with \`{ action: "<tool name above>", args: {...} }\`.` : "";
       return {
         contents: [{
           uri: "plur://guide",
           mimeType: "text/markdown",
-          text: GUIDE_RESOURCE
+          text: GUIDE_RESOURCE + cursorNote
         }]
       };
     }
@@ -2275,7 +2475,8 @@ Please:
   return server;
 }
 async function runStdio() {
-  const server = await createServer();
+  const profile = process.env.PLUR_TOOL_PROFILE === "cursor" ? "cursor" : "full";
+  const server = await createServer(void 0, { profile });
   registerFlushOnExit({});
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@plur-ai/mcp",
   "mcpName": "io.github.plur-ai/plur",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "bin": {
     "plur-mcp": "dist/index.js"
@@ -14,7 +14,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod": "^3.23.0",
-    "@plur-ai/core": "0.11.0"
+    "@plur-ai/core": "0.12.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0"