mindgraph-mcp 0.8.0 → 0.9.0

package/dist/cli.js

@@ -445,6 +445,15 @@ async function handleRetrieve(client2, args) {
       return ok(await client2.getPendingApprovals());
     case "unresolved_contradictions":
       return ok(await client2.getContradictions());
+    case "preferences":
+      return ok(
+        await client2.retrieve({
+          action: "preferences",
+          ...query ? { query, k: limit } : {},
+          limit,
+          agent_id
+        })
+      );
     case "layer":
       if (!layer) return err("layer is required for layer retrieval");
       return ok(
@@ -1002,7 +1011,7 @@ var init_tools = __esm({
       },
       {
         name: "mindgraph_retrieve",
-        description: "Search and explore the knowledge graph. Use 'context' (default) for BM25 keyword retrieval \u2014 returns graph nodes only by default (labels, summaries, types, confidence); set include_chunks=true to also get full source text. Pass 1-3 discriminating keywords, not sentences. GOOD: 'Kissinger NATO'. BAD: 'What is Kissinger\\'s view on NATO?'. Use 'document_index' to list all ingested documents (titles, dates, UIDs) for orientation. Use 'semantic' when keywords return nothing \u2014 conceptual/fuzzy queries. Use 'hybrid' for keyword + semantic. Use 'text' for fast keyword-only. Use 'neighborhood'/'chain'/'path'/'subgraph' for graph traversal. Other actions ('active_goals', 'open_questions', etc.) only when the user explicitly asks.",
+        description: "Search and explore the knowledge graph. Use 'context' (default) for BM25 keyword retrieval \u2014 returns graph nodes only by default (labels, summaries, types, confidence); set include_chunks=true to also get full source text. Pass 1-3 discriminating keywords, not sentences. GOOD: 'Kissinger NATO'. BAD: 'What is Kissinger\\'s view on NATO?'. Use 'document_index' to list all ingested documents (titles, dates, UIDs) for orientation. Use 'semantic' when keywords return nothing \u2014 conceptual/fuzzy queries. Use 'hybrid' for keyword + semantic. Use 'text' for fast keyword-only. Use 'neighborhood'/'chain'/'path'/'subgraph' for graph traversal. Use 'preferences' for advice or recommendation requests ('suggest a hotel', 'what should I read?') \u2014 it returns the user's stated/learned preferences relevant to the query (pass the topic as 'query'), so your answer reflects what they actually like instead of being generic. Other structured actions ('active_goals', 'open_questions', etc.) only when the user explicitly asks.",
         inputSchema: {
           type: "object",
           properties: {
@@ -1018,6 +1027,7 @@ var init_tools = __esm({
                 "weak_claims",
                 "pending_approvals",
                 "unresolved_contradictions",
+                "preferences",
                 "layer",
                 "recent",
                 "chain",
@@ -1383,6 +1393,7 @@ If keyword search returns no results, escalate:
 - User asks "what documents are in my graph?" \u2192 action "document_index"
 - User explicitly asks "what are my goals?" \u2192 action "active_goals"
 - User explicitly asks about open questions \u2192 action "open_questions"
+- User asks for advice or a recommendation ("suggest a hotel", "what should I read?") \u2192 action "preferences", query "topic keywords" \u2014 tailor the answer to what they like
 - Explore around a known node \u2192 action "neighborhood" with start_uid
 - Find connections between nodes \u2192 action "path" with start_uid + end_uid
 

package/dist/index.js

@@ -297,7 +297,7 @@ var TOOLS = [
   },
   {
     name: "mindgraph_retrieve",
-    description: "Search and explore the knowledge graph. Use 'context' (default) for BM25 keyword retrieval \u2014 returns graph nodes only by default (labels, summaries, types, confidence); set include_chunks=true to also get full source text. Pass 1-3 discriminating keywords, not sentences. GOOD: 'Kissinger NATO'. BAD: 'What is Kissinger\\'s view on NATO?'. Use 'document_index' to list all ingested documents (titles, dates, UIDs) for orientation. Use 'semantic' when keywords return nothing \u2014 conceptual/fuzzy queries. Use 'hybrid' for keyword + semantic. Use 'text' for fast keyword-only. Use 'neighborhood'/'chain'/'path'/'subgraph' for graph traversal. Other actions ('active_goals', 'open_questions', etc.) only when the user explicitly asks.",
+    description: "Search and explore the knowledge graph. Use 'context' (default) for BM25 keyword retrieval \u2014 returns graph nodes only by default (labels, summaries, types, confidence); set include_chunks=true to also get full source text. Pass 1-3 discriminating keywords, not sentences. GOOD: 'Kissinger NATO'. BAD: 'What is Kissinger\\'s view on NATO?'. Use 'document_index' to list all ingested documents (titles, dates, UIDs) for orientation. Use 'semantic' when keywords return nothing \u2014 conceptual/fuzzy queries. Use 'hybrid' for keyword + semantic. Use 'text' for fast keyword-only. Use 'neighborhood'/'chain'/'path'/'subgraph' for graph traversal. Use 'preferences' for advice or recommendation requests ('suggest a hotel', 'what should I read?') \u2014 it returns the user's stated/learned preferences relevant to the query (pass the topic as 'query'), so your answer reflects what they actually like instead of being generic. Other structured actions ('active_goals', 'open_questions', etc.) only when the user explicitly asks.",
     inputSchema: {
       type: "object",
       properties: {
@@ -313,6 +313,7 @@ var TOOLS = [
             "weak_claims",
             "pending_approvals",
             "unresolved_contradictions",
+            "preferences",
             "layer",
             "recent",
             "chain",
@@ -1011,6 +1012,15 @@ async function handleRetrieve(client2, args) {
       return ok(await client2.getPendingApprovals());
     case "unresolved_contradictions":
       return ok(await client2.getContradictions());
+    case "preferences":
+      return ok(
+        await client2.retrieve({
+          action: "preferences",
+          ...query ? { query, k: limit } : {},
+          limit,
+          agent_id
+        })
+      );
     case "layer":
       if (!layer) return err("layer is required for layer retrieval");
       return ok(
@@ -1340,6 +1350,7 @@ If keyword search returns no results, escalate:
 - User asks "what documents are in my graph?" \u2192 action "document_index"
 - User explicitly asks "what are my goals?" \u2192 action "active_goals"
 - User explicitly asks about open questions \u2192 action "open_questions"
+- User asks for advice or a recommendation ("suggest a hotel", "what should I read?") \u2192 action "preferences", query "topic keywords" \u2014 tailor the answer to what they like
 - Explore around a known node \u2192 action "neighborhood" with start_uid
 - Find connections between nodes \u2192 action "path" with start_uid + end_uid
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindgraph-mcp",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "MCP server for MindGraph — connect Claude Desktop, Claude Code, and any MCP client to your knowledge graph",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",