@plur-ai/mcp 0.9.8 → 0.9.10

package/README.md

@@ -2,7 +2,7 @@
 
 Give your AI agent persistent memory. One line in your MCP config — corrections, preferences, and conventions persist across sessions. No workflow changes, no cloud, no API costs for search.
 
-Part of [PLUR](https://plur.ai) — where **Haiku with memory outperforms Opus without it** at 10x less cost.
+Part of [PLUR](https://plur.ai) — where, in our tool-routing and local-knowledge benchmark, **Haiku with memory outperformed Opus without it** at 10x less cost.
 
 ## Setup (30 seconds)
 

package/dist/index.js

@@ -4,8 +4,8 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, statSync } from "fs";
 import { join } from "path";
 import { fileURLToPath } from "url";
-import { homedir } from "os";
-var VERSION = "0.9.8";
+import { homedir, platform } from "os";
+var VERSION = "0.9.10";
 var HELP = `plur-mcp v${VERSION} \u2014 persistent memory for AI agents
 
 Usage:
@@ -53,7 +53,9 @@ function extractManifestVersion(skillMdPath) {
     return null;
   }
 }
-var CLI = "npx @plur-ai/cli";
+var _shimName = platform() === "win32" ? "plur-hook.cmd" : "plur-hook";
+var _shimCandidate = join(homedir(), ".plur", "bin", _shimName);
+var CLI = existsSync(_shimCandidate) ? _shimCandidate : "npx @plur-ai/cli";
 var PLUR_HOOKS = {
   // --- Session lifecycle ---
   UserPromptSubmit: [{
@@ -277,7 +279,7 @@ if (arg === "init") {
   process.exit(0);
 }
 if (arg === "serve" || arg === void 0) {
-  const { runStdio } = await import("./server-4IHAOMXN.js");
+  const { runStdio } = await import("./server-GRHXPO6E.js");
   runStdio().catch((err) => {
     console.error("Failed to start PLUR MCP server:", err);
     process.exit(1);

package/dist/{server-4IHAOMXN.js → server-GRHXPO6E.js}

@@ -14,7 +14,12 @@ import {
 import { Plur as Plur2, checkForUpdate } from "@plur-ai/core";
 
 // src/tools.ts
-import { extractMetaEngrams, validateMetaEngram, confidenceBand, generateProfile, getProfileForInjection, selectModelForOperation } from "@plur-ai/core";
+import { extractMetaEngrams, validateMetaEngram, confidenceBand, generateProfile, getProfileForInjection, selectModelForOperation, getCachedUpdateCheck, minorVersionsBehind, scanForTensions, CapabilityCanary } from "@plur-ai/core";
+
+// src/version.ts
+var VERSION = "0.9.10";
+
+// src/tools.ts
 function makeHttpLlm(baseUrl, apiKey, model = "gpt-4o-mini") {
   return async (prompt) => {
     const response = await fetch(`${baseUrl.replace(/\/$/, "")}/chat/completions`, {
@@ -72,6 +77,26 @@ function getLlmFunction() {
   if (openaiKey) return makeHttpLlm("https://api.openai.com/v1", openaiKey, "gpt-4o-mini");
   return void 0;
 }
+function sanitizeStatement(raw) {
+  const markers = ["</statement>", "<parameter name="];
+  let cut = raw.length;
+  for (const m of markers) {
+    const pos = raw.indexOf(m);
+    if (pos !== -1 && pos < cut) cut = pos;
+  }
+  return raw.slice(0, cut).trimEnd();
+}
+var mcpCanary = new CapabilityCanary({ threshold: 10 });
+mcpCanary.expect({
+  id: "session_start_hook",
+  description: "Automatic memory injection via hooks",
+  fix: "Run: npx @plur-ai/mcp init"
+});
+mcpCanary.expect({
+  id: "learn_activity",
+  description: "Learning from corrections",
+  fix: "Call plur_learn when corrected. If using hooks, verify they are installed."
+});
 function getToolDefinitions() {
   return [
     {
@@ -89,38 +114,12 @@ function getToolDefinitions() {
           },
           scope: { type: "string", description: "Namespace, e.g. global, project:myapp" },
           domain: { type: "string", description: "Domain tag, e.g. software.deployment" },
-          source: { type: "string", description: "Origin of this knowledge" },
-          tags: { type: "array", items: { type: "string" }, description: "Searchable keyword tags" },
-          rationale: { type: "string", description: "Why this knowledge matters" },
-          visibility: { type: "string", enum: ["private", "public", "template"], description: "Visibility level" },
-          knowledge_anchors: {
-            type: "array",
-            items: {
-              type: "object",
-              properties: {
-                path: { type: "string", description: "Path to related document" },
-                relevance: { type: "string", enum: ["primary", "supporting", "example"] },
-                snippet: { type: "string", description: "Short snippet (max 200 chars)" }
-              },
-              required: ["path"]
-            },
-            description: "Links to related knowledge documents"
-          },
-          dual_coding: {
-            type: "object",
-            properties: {
-              example: { type: "string", description: "Concrete example" },
-              analogy: { type: "string", description: "Analogy to aid understanding" }
-            },
-            description: "Dual coding for richer encoding"
-          },
-          abstract: { type: "string", description: "Abstract engram ID this was derived from" },
-          derived_from: { type: "string", description: "Source engram ID this was derived from" },
-          commitment: { type: "string", enum: ["exploring", "leaning", "decided", "locked"], description: "Commitment level (default: leaning)" },
-          locked_reason: { type: "string", description: "Reason for locking (when commitment=locked)" },
-          memory_class: { type: "string", enum: ["semantic", "episodic", "procedural", "metacognitive"], description: "Memory classification (auto-set from type if omitted)" },
-          session_episode_id: { type: "string", description: "Link to current session episode for episodic anchoring" },
-          pinned: { type: "boolean", description: "Always-load flag. If true, this engram bypasses the keyword-relevance gate and is eligible for injection on every session, regardless of overlap with the user task. Use sparingly: meta-rules, safety conventions, core operating principles only." }
+          tags: { type: "array", items: { type: "string" }, description: "Searchable keyword tags \u2014 contribute to BM25/embedding recall, so concrete keywords pay off" },
+          rationale: { type: "string", description: "Why this knowledge matters \u2014 also enters the search corpus, helps recall by intent not just statement" },
+          source: { type: "string", description: "Origin of this knowledge (URL, conversation ref, etc.)" },
+          pinned: { type: "boolean", description: "Always-load flag. If true, this engram bypasses the keyword-relevance gate at injection time. Use sparingly: meta-rules, safety conventions, core operating principles only." },
+          commitment: { type: "string", enum: ["exploring", "leaning", "decided", "locked"], description: "How firmly the user has committed to this belief (default: leaning)" },
+          locked_reason: { type: "string", description: "Why this engram is locked (only meaningful when commitment=locked)" }
         },
         required: ["statement"]
       },
@@ -133,37 +132,37 @@ function getToolDefinitions() {
           source: args.source,
           tags: args.tags,
           rationale: args.rationale,
-          visibility: args.visibility,
-          knowledge_anchors: args.knowledge_anchors,
-          dual_coding: args.dual_coding,
-          abstract: args.abstract,
-          derived_from: args.derived_from,
           commitment: args.commitment,
           locked_reason: args.locked_reason,
-          memory_class: args.memory_class,
-          session_episode_id: args.session_episode_id,
           pinned: args.pinned,
           llm
         };
+        const statement = sanitizeStatement(args.statement);
         try {
-          const engram = await plur.learnRouted(args.statement, context);
+          const engram = await plur.learnRouted(statement, context);
+          const isOutbox = !!engram.structured_data?._outbox;
+          mcpCanary.signal("learn_activity");
           return {
             id: engram.id,
             statement: engram.statement,
             scope: engram.scope,
             type: engram.type,
             pinned: engram.pinned === true,
-            decision: "ADD"
+            decision: "ADD",
+            ...isOutbox ? { outbox: true, warning: "Remote write failed; engram queued locally for retry on next session start or plur_sync." } : {}
           };
         } catch (err) {
-          const engram = plur.learn(args.statement, context);
+          const engram = plur.learn(statement, context);
+          const isOutbox = !!engram.structured_data?._outbox;
+          mcpCanary.signal("learn_activity");
           return {
             id: engram.id,
             statement: engram.statement,
             scope: engram.scope,
             type: engram.type,
             decision: "ADD",
-            warning: `Remote write failed (${err.message}); fell back to local. The id above is the local placeholder \u2014 the canonical engram is NOT on the server.`
+            ...isOutbox ? { outbox: true } : {},
+            warning: `Remote write failed (${err.message}); engram queued for retry.`
           };
         }
       }
@@ -179,7 +178,6 @@ function getToolDefinitions() {
           scope: { type: "string", description: "Filter by scope (also includes global)" },
           domain: { type: "string", description: "Filter by domain prefix" },
           limit: { type: "number", description: "Max results to return (default 20)" },
-          min_strength: { type: "number", description: "Minimum retrieval strength (0-1)" },
           budget: { type: "object", description: "Budget constraints for sub-agents", properties: { max_tokens: { type: "number" }, max_results: { type: "number" } } },
           caller_session_id: { type: "string", description: "Caller session ID for budget enforcement" }
         },
@@ -189,8 +187,7 @@ function getToolDefinitions() {
         const results = plur.recall(args.query, {
           scope: args.scope,
           domain: args.domain,
-          limit: args.limit,
-          min_strength: args.min_strength
+          limit: args.limit
         });
         return {
           results: results.map((e) => ({
@@ -216,7 +213,6 @@ function getToolDefinitions() {
           scope: { type: "string", description: "Filter by scope (also includes global)" },
           domain: { type: "string", description: "Filter by domain prefix" },
           limit: { type: "number", description: "Max results to return (default 20)" },
-          min_strength: { type: "number", description: "Minimum retrieval strength (0-1)" },
           budget: { type: "object", description: "Budget constraints for sub-agents", properties: { max_tokens: { type: "number" }, max_results: { type: "number" }, ttl_seconds: { type: "number" } } },
           caller_session_id: { type: "string", description: "Session ID of calling agent for budget enforcement" },
           include_episodes: { type: "boolean", description: "If true, include linked episode summaries for each engram (SP2 episodic anchoring)" }
@@ -229,8 +225,7 @@ function getToolDefinitions() {
         const meta = await plur.recallHybridWithMeta(args.query, {
           scope: args.scope,
           domain: args.domain,
-          limit: effectiveLimit,
-          min_strength: args.min_strength
+          limit: effectiveLimit
         });
         const results = meta.engrams;
         let truncated = false;
@@ -369,7 +364,7 @@ function getToolDefinitions() {
           const summary = { positive: 0, negative: 0, neutral: 0 };
           for (const { id, signal } of args.signals) {
             try {
-              plur.feedback(id, signal);
+              await plur.feedback(id, signal);
               results.push({ id, signal, success: true });
               summary[signal]++;
             } catch (err) {
@@ -379,7 +374,7 @@ function getToolDefinitions() {
           return { mode: "batch", results, summary };
         }
         try {
-          plur.feedback(args.id, args.signal);
+          await plur.feedback(args.id, args.signal);
           return { success: true, id: args.id, signal: args.signal };
         } catch (err) {
           if (err.message?.includes("readonly store")) {
@@ -434,16 +429,19 @@ function getToolDefinitions() {
       handler: async (args, plur) => {
         if (args.id) {
           const engram = plur.getById(args.id);
-          if (!engram) throw new Error(`Engram not found: ${args.id}`);
-          if (engram.status === "retired") return { success: false, error: `Already retired: ${args.id}` };
-          plur.forget(args.id);
-          return { success: true, retired: { id: engram.id, statement: engram.statement } };
+          if (engram) {
+            if (engram.status === "retired") return { success: false, error: `Already retired: ${args.id}` };
+            await plur.forget(args.id);
+            return { success: true, retired: { id: engram.id, statement: engram.statement } };
+          }
+          await plur.forget(args.id);
+          return { success: true, retired: { id: args.id } };
         }
         if (args.search) {
           const matches = plur.recall(args.search, { limit: 100 });
           if (matches.length === 0) return { success: false, error: `No active engrams matching "${args.search}"` };
           if (matches.length === 1) {
-            plur.forget(matches[0].id);
+            await plur.forget(matches[0].id);
             return { success: true, retired: { id: matches[0].id, statement: matches[0].statement } };
           }
           return {
@@ -670,7 +668,21 @@ function getToolDefinitions() {
       },
       handler: async (args, plur) => {
         const result = plur.sync(args.remote);
-        return result;
+        let outbox_result;
+        try {
+          outbox_result = await plur.flushOutbox();
+        } catch {
+        }
+        return {
+          ...result,
+          ...outbox_result && (outbox_result.flushed > 0 || outbox_result.failed > 0) ? {
+            outbox: {
+              flushed: outbox_result.flushed,
+              pending: outbox_result.failed,
+              warnings: outbox_result.expired_warnings
+            }
+          } : {}
+        };
       }
     },
     {
@@ -835,7 +847,7 @@ function getToolDefinitions() {
     },
     {
       name: "plur_status",
-      description: "Return system health \u2014 engram count, episode count, pack count, storage root",
+      description: "Return system health \u2014 running version, engram count, episode count, pack count, storage root",
       annotations: { title: "Status", readOnlyHint: true, idempotentHint: true },
       inputSchema: {
         type: "object",
@@ -843,14 +855,26 @@ function getToolDefinitions() {
       },
       handler: async (_args, plur) => {
         const status = plur.status();
+        const versionCheck = getCachedUpdateCheck("@plur-ai/mcp");
         return {
+          version: VERSION,
           engram_count: status.engram_count,
           episode_count: status.episode_count,
           pack_count: status.pack_count,
           storage_root: status.storage_root,
           locked_count: status.locked_count,
           tension_count: status.tension_count,
-          versioned_engram_count: status.versioned_engram_count ?? 0
+          versioned_engram_count: status.versioned_engram_count ?? 0,
+          outbox_count: status.outbox_count ?? 0,
+          // Version check (issue #151)
+          ...versionCheck?.updateAvailable && versionCheck.latest ? {
+            update_available: {
+              current: versionCheck.current,
+              latest: versionCheck.latest,
+              behind: minorVersionsBehind(versionCheck.current, versionCheck.latest)
+            }
+          } : {},
+          capabilities: mcpCanary.status()
         };
       }
     },
@@ -919,6 +943,13 @@ function getToolDefinitions() {
             "  \u2022 Or opt out: set PLUR_DISABLE_EMBEDDINGS=1, or write `embeddings: { enabled: false }` to ~/.plur/config.yaml \u2014 hybrid search will run BM25-only"
           );
         }
+        const canaryStatuses = mcpCanary.status();
+        for (const cs of canaryStatuses) {
+          if (!cs.healthy) {
+            checks.push({ check: `capability: ${cs.capability}`, ok: false, detail: cs.warning });
+            if (cs.warning) remediation.push(cs.warning);
+          }
+        }
         return {
           ok: checks.every((c) => c.ok),
           checks,
@@ -926,6 +957,7 @@ function getToolDefinitions() {
             before_probe: before,
             after_probe: after
           },
+          capabilities: canaryStatuses,
           remediation: remediation.length > 0 ? remediation : ["All checks passed \u2014 PLUR is healthy."]
         };
       }
@@ -943,10 +975,17 @@ function getToolDefinitions() {
         required: ["task"]
       },
       handler: async (args, plur) => {
+        mcpCanary.tick();
+        mcpCanary.signal("session_start_hook");
         const crypto = await import("crypto");
         const session_id = crypto.randomUUID();
         const task = args.task;
         const tags = args.tags;
+        let outbox_result;
+        try {
+          outbox_result = await plur.flushOutbox();
+        } catch {
+        }
         const status = plur.status();
         const store_stats = {
           engram_count: status.engram_count,
@@ -988,6 +1027,19 @@ function getToolDefinitions() {
 You have ${store_stats.engram_count} engrams but none matched this task. Call plur_learn to capture new learnings from this session.`;
         }
         const isFreshInstall = store_stats.engram_count === 0 && store_stats.episode_count === 0;
+        const versionCheck = getCachedUpdateCheck("@plur-ai/mcp");
+        let version_warning;
+        if (versionCheck?.updateAvailable && versionCheck.latest) {
+          const behind = minorVersionsBehind(versionCheck.current, versionCheck.latest);
+          if (behind > 2) {
+            version_warning = `CRITICAL: Running PLUR v${versionCheck.current} \u2014 latest is v${versionCheck.latest} (${behind} minor versions behind). Known bugs may be present. Update immediately: npx @plur-ai/mcp@latest`;
+            guide = `\u26A0\uFE0F ${version_warning}
+
+${guide}`;
+          } else {
+            version_warning = `Update available: PLUR v${versionCheck.current} \u2192 v${versionCheck.latest}. Run: npx @plur-ai/mcp@latest`;
+          }
+        }
         return {
           session_id,
           engrams: engrams ?? [],
@@ -996,7 +1048,17 @@ You have ${store_stats.engram_count} engrams but none matched this task. Call pl
           // Ask LLM to check back — MCP can't push, but we can request a follow-up
           follow_up: store_stats.engram_count === 0 ? "This is a fresh store with 0 engrams. After your first exchange with the user, review what you learned and call plur_learn for any corrections, preferences, or patterns. Build the memory from this session." : void 0,
           // On fresh install, suggest hook setup for reliable injection
-          setup_hint: isFreshInstall ? "IMPORTANT: For reliable memory injection, ask the user to run: npx @plur-ai/cli init \u2014 this installs Claude Code hooks that automatically inject engrams at conversation start and after context compaction. Without hooks, memory injection depends on you remembering to call plur_session_start." : void 0
+          setup_hint: isFreshInstall ? "IMPORTANT: For reliable memory injection, ask the user to run: npx @plur-ai/cli init \u2014 this installs Claude Code hooks that automatically inject engrams at conversation start and after context compaction. Without hooks, memory injection depends on you remembering to call plur_session_start." : void 0,
+          // Outbox flush results (issue #26)
+          ...outbox_result && (outbox_result.flushed > 0 || outbox_result.failed > 0) ? {
+            outbox: {
+              flushed: outbox_result.flushed,
+              pending: outbox_result.failed,
+              warnings: outbox_result.expired_warnings
+            }
+          } : {},
+          // Version staleness warning (issue #151)
+          ...version_warning ? { version_warning, version: VERSION } : {}
         };
       }
     },
@@ -1099,7 +1161,12 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
       inputSchema: { type: "object", properties: {} },
       handler: async (_args, plur) => {
         const stores = plur.listStores();
-        return { stores, count: stores.length };
+        const outboxCount = plur.outboxCount();
+        return {
+          stores,
+          count: stores.length,
+          ...outboxCount > 0 ? { outbox_pending: outboxCount } : {}
+        };
       }
     },
     {
@@ -1144,13 +1211,19 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
     },
     {
       name: "plur_tensions",
-      description: "List engram pairs that have conflicting knowledge \u2014 shows tensions in your memory that may need resolution",
+      description: "List or scan for engram pairs that have conflicting knowledge. Without scan mode, shows previously detected conflicts. With scan:true, runs an active LLM-powered contradiction scan and returns only high-confidence tensions.",
       annotations: { title: "Tensions", readOnlyHint: true, idempotentHint: true },
       inputSchema: {
         type: "object",
         properties: {
           scope: { type: "string", description: "Filter by scope" },
-          domain: { type: "string", description: "Filter by domain prefix" }
+          domain: { type: "string", description: "Filter by domain prefix" },
+          scan: { type: "boolean", description: "Run an active contradiction scan using an LLM judge. Requires OPENAI_API_KEY or OPENROUTER_API_KEY env var, or explicit llm_base_url + llm_api_key args." },
+          llm_base_url: { type: "string", description: "OpenAI-compatible API base URL for scan mode (e.g. https://api.openai.com/v1)" },
+          llm_api_key: { type: "string", description: "API key for the LLM (scan mode)" },
+          llm_model: { type: "string", description: "Model name for scan mode (default: gpt-4o-mini)" },
+          min_confidence: { type: "number", description: "Minimum confidence threshold for scan mode (0\u20131, default: 0.7)" },
+          max_pairs: { type: "number", description: "Maximum candidate pairs to evaluate in scan mode (default: 50)" }
         }
       },
       handler: async (args, plur) => {
@@ -1158,6 +1231,30 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
           scope: args.scope,
           domain: args.domain
         });
+        if (args.scan) {
+          const llm = args.llm_base_url && args.llm_api_key ? makeHttpLlm(args.llm_base_url, args.llm_api_key, args.llm_model) : getLlmFunction();
+          if (!llm) {
+            return {
+              error: "scan mode requires an LLM. Set OPENAI_API_KEY or OPENROUTER_API_KEY, or pass llm_base_url + llm_api_key.",
+              tensions: [],
+              count: 0
+            };
+          }
+          const result = await scanForTensions(engrams, llm, {
+            min_confidence: args.min_confidence,
+            max_pairs: args.max_pairs
+          });
+          return {
+            pairs_checked: result.pairs_checked,
+            count: result.new_tensions,
+            tensions: result.tensions.map((t) => ({
+              engram_a: { id: t.id_a, statement: t.statement_a },
+              engram_b: { id: t.id_b, statement: t.statement_b },
+              confidence: t.confidence,
+              reason: t.reason
+            }))
+          };
+        }
         const tensions = [];
         const seen = /* @__PURE__ */ new Set();
         for (const engram of engrams) {
@@ -1171,11 +1268,27 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
             tensions.push({
               engram_a: { id: engram.id, statement: engram.statement, type: engram.type },
               engram_b: { id: other.id, statement: other.statement, type: other.type },
-              detected_at: engram.activation.last_accessed
+              detected_at: engram.activation.last_accessed,
+              purge_hint: "These conflicts are from the legacy detection system. Run plur_tensions_purge to clear them, then use scan:true for active contradiction detection."
             });
           }
         }
-        return { tensions, count: tensions.length };
+        const purge_hint = tensions.length > 0 ? "These are legacy conflict relations. Run plur_tensions_purge to clear them." : void 0;
+        return { tensions, count: tensions.length, ...purge_hint ? { purge_hint } : {} };
+      }
+    },
+    {
+      name: "plur_tensions_purge",
+      description: "Purge all conflict relations from local engrams \u2014 removes accumulated false positives from the legacy tension-detection system",
+      annotations: { title: "Purge Tensions", destructiveHint: true, idempotentHint: true },
+      inputSchema: { type: "object", properties: {} },
+      handler: async (_args, plur) => {
+        const result = plur.purgeTensions();
+        return {
+          purged_conflict_refs: result.purged_count,
+          engrams_modified: result.engrams_modified,
+          message: `Purged ${result.purged_count} conflict references from ${result.engrams_modified} engrams.`
+        };
       }
     },
     {
@@ -1371,7 +1484,7 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
     },
     {
       name: "plur_batch_decay",
-      description: "Apply ACT-R decay to all engrams. Run weekly. Returns status transitions only.",
+      description: "Apply ACT-R decay to all local engrams. Run weekly. Only decays engrams in the local YAML store \u2014 remote-store engrams are not decayed client-side. Returns status transitions only.",
       annotations: { title: "Batch decay", destructiveHint: false, idempotentHint: false },
       inputSchema: {
         type: "object",
@@ -1424,7 +1537,6 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
 
 // src/server.ts
 import { z } from "zod";
-var VERSION = "0.9.8";
 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.
@@ -1561,7 +1673,7 @@ async function createServer(plur) {
     const tool = tools.find((t) => t.name === request.params.name);
     if (!tool) {
       return {
-        content: [{ type: "text", text: `Unknown tool: ${request.params.name}` }],
+        content: [{ type: "text", text: JSON.stringify({ error: `Unknown tool: ${request.params.name}`, success: false }) }],
         isError: true
       };
     }
@@ -1581,8 +1693,9 @@ async function createServer(plur) {
         }
         const parsed = z.object(shape).passthrough().safeParse(args);
         if (!parsed.success) {
+          const details = parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ");
           return {
-            content: [{ type: "text", text: `Invalid arguments: ${parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ")}` }],
+            content: [{ type: "text", text: JSON.stringify({ error: `Invalid arguments: ${details}`, success: false }) }],
             isError: true
           };
         }
@@ -1593,7 +1706,7 @@ async function createServer(plur) {
       const message = err?.message ?? String(err);
       server.sendLoggingMessage({ level: "error", data: `Tool ${request.params.name} failed: ${message}` });
       return {
-        content: [{ type: "text", text: `Error: ${message}` }],
+        content: [{ type: "text", text: JSON.stringify({ error: message, success: false }) }],
         isError: true
       };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plur-ai/mcp",
-  "version": "0.9.8",
+  "version": "0.9.10",
   "type": "module",
   "bin": {
     "plur-mcp": "dist/index.js"
@@ -13,7 +13,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod": "^3.23.0",
-    "@plur-ai/core": "0.9.8"
+    "@plur-ai/core": "0.9.10"
   },
   "devDependencies": {
     "@types/node": "^25.5.0"