@intangle/mcp-server 1.0.9 → 1.0.10

package/dist/index.js

@@ -22,7 +22,7 @@ if (!MCP_API_KEY) {
 console.log("Intangle MCP Server starting - connecting to", API_BASE_URL);
 // Version checking
 // IMPORTANT: Update BOTH package.json version AND this constant when bumping version
-const CURRENT_VERSION = "1.0.8";
+const CURRENT_VERSION = "1.0.10";
 let latestVersion = null;
 let versionCheckDone = false;
 async function checkVersion() {
@@ -75,7 +75,7 @@ const server = new Server({
 const TOOLS = [
     {
         name: "add_memory",
-        description: "Store one or more memories in the user's memory graph with flexible topics. Accepts a single memory object or an array of memory objects for batch creation. REQUIRES space_id parameter.",
+        description: "Store CONTEXT (general information and knowledge) in the user's memory system. For actionable workflow items with status tracking, use add_task instead. Accepts a single context item or an array of context items for batch creation. REQUIRES space_id parameter.",
         inputSchema: {
             type: "object",
             properties: {
@@ -135,7 +135,7 @@ const TOOLS = [
     },
     {
         name: "search_memories",
-        description: "Search through stored memories using advanced hybrid search (semantic + text + entity relationships). ALWAYS provide space_id parameter - this is mandatory for all searches.",
+        description: "Search through ALL stored data including BOTH context (general information) AND tasks (actionable workflow items). Uses advanced hybrid search (semantic + text + entity relationships). When a user asks to 'update memory' or 'check memory', this tool searches BOTH types. ALWAYS provide space_id parameter - this is mandatory for all searches.",
         inputSchema: {
             type: "object",
             properties: {
@@ -163,7 +163,7 @@ const TOOLS = [
     },
     {
         name: "get_recent_memories",
-        description: "Get the most recent memories stored in the system. REQUIRES space_id parameter.",
+        description: "Get the most recent CONTEXT items (general information). For recent tasks, use list_tasks instead. NOTE: This tool is called 'get_recent_memories' (not 'fetch'). Returns fully decrypted data. REQUIRES space_id parameter.",
         inputSchema: {
             type: "object",
             properties: {
@@ -187,20 +187,20 @@ const TOOLS = [
     },
     {
         name: "get_entities",
-        description: "Get extracted entities (people, places, concepts) from memories",
+        description: "Get extracted entities (people, places, concepts) from CONTEXT items (general information). If no memory_id provided, returns top 20 most frequently mentioned entities across all context. WARNING: This tool can return large responses - use sparingly and only when entity information is specifically needed.",
         inputSchema: {
             type: "object",
             properties: {
                 memory_id: {
                     type: "string",
-                    description: "Optional memory ID to get entities for specific memory",
+                    description: "Memory ID to get entities for. RECOMMENDED: Always provide memory_id to get focused results.",
                 },
             },
         },
     },
     {
         name: "delete_memory",
-        description: "Delete one or more memories in a single transaction. Accepts a single memory ID or an array of memory IDs for batch deletion.",
+        description: "Delete one or more CONTEXT items (general information). For deleting tasks, use delete_task instead. Accepts a single memory ID or an array of memory IDs for batch deletion.",
         inputSchema: {
             type: "object",
             properties: {
@@ -222,17 +222,9 @@ const TOOLS = [
             required: ["memory_ids"],
         },
     },
-    {
-        name: "debug_memory_structure",
-        description: "Debug tool to inspect the current memory structure in the database",
-        inputSchema: {
-            type: "object",
-            properties: {},
-        },
-    },
     {
         name: "list_spaces",
-        description: "Get all available spaces with their descriptions and memory counts",
+        description: "Get all available spaces with their descriptions and item counts (both context and tasks). Spaces are top-level containers that isolate different contexts (e.g., personal, work, projects).",
         inputSchema: {
             type: "object",
             properties: {},
@@ -240,7 +232,7 @@ const TOOLS = [
     },
     {
         name: "create_space",
-        description: "Create a new space with optional startup configuration. The 'start' tool loads this configuration when beginning work in this space. Checks user's plan limits and returns upgrade link if limit reached.",
+        description: "Create a new space with optional startup configuration. Spaces are top-level containers that hold both context (general information) and tasks (actionable items). The 'start' tool loads this configuration when beginning work in this space. Checks user's plan limits and returns upgrade link if limit reached.",
         inputSchema: {
             type: "object",
             properties: {
@@ -250,7 +242,7 @@ const TOOLS = [
                 },
                 description: {
                     type: "string",
-                    description: "Brief description of what this space is for (e.g., 'Work-related memories and tasks')",
+                    description: "Brief description of what this space is for (e.g., 'Work-related context and tasks')",
                 },
                 startup_context: {
                     type: "string",
@@ -285,7 +277,7 @@ const TOOLS = [
     },
     {
         name: "start",
-        description: "Start working in a space and get its context. Returns static context, auto-searched memories, preferences, and optionally pending tasks. Call this when starting a conversation in a space to get relevant context.",
+        description: "Start working in a space and get comprehensive initialization. Returns static context, auto-searched context (general information), preferences, and optionally pending tasks. This tool retrieves BOTH context AND tasks based on space configuration. Call this when starting a conversation in a space to get relevant information.",
         inputSchema: {
             type: "object",
             properties: {
@@ -299,7 +291,7 @@ const TOOLS = [
     },
     {
         name: "add_task",
-        description: "Create one or more tasks in your space with status tracking. Accepts a single task object or an array of task objects for batch creation. Tasks have graph relationships like memories (entities, topics, temporal). REQUIRES space_id parameter.",
+        description: "Create one or more tasks in your space with status tracking and priority levels. Accepts a single task object or an array of task objects for batch creation. Tasks have graph relationships like memories (entities, topics, temporal). REQUIRES space_id parameter.",
         inputSchema: {
             type: "object",
             properties: {
@@ -331,6 +323,12 @@ const TOOLS = [
                                     description: "Task status (default: pending)",
                                     default: "pending",
                                 },
+                                priority: {
+                                    type: "string",
+                                    enum: ["urgent", "high", "medium", "low"],
+                                    description: "Task priority level (default: medium). Use 'urgent' for time-sensitive tasks requiring immediate attention, 'high' for important tasks, 'medium' for standard tasks, 'low' for nice-to-have tasks.",
+                                    default: "medium",
+                                },
                                 parent_id: {
                                     type: "string",
                                     description: "Optional parent task ID to create this as a subtask",
@@ -362,6 +360,12 @@ const TOOLS = [
                                         description: "Task status (default: pending)",
                                         default: "pending",
                                     },
+                                    priority: {
+                                        type: "string",
+                                        enum: ["urgent", "high", "medium", "low"],
+                                        description: "Task priority level (default: medium). Use 'urgent' for time-sensitive tasks requiring immediate attention, 'high' for important tasks, 'medium' for standard tasks, 'low' for nice-to-have tasks.",
+                                        default: "medium",
+                                    },
                                     parent_id: {
                                         type: "string",
                                         description: "Optional parent task ID to create this as a subtask",
@@ -398,7 +402,7 @@ const TOOLS = [
     },
     {
         name: "update_task",
-        description: "Update one or more tasks. Accepts a single update object or an array of update objects for batch updates. Each update must include task_id.",
+        description: "Update one or more TASKS (not context/memories - use add_memory to update context by creating new versions). Accepts a single update object or an array of update objects for batch updates. Each update must include task_id.",
         inputSchema: {
             type: "object",
             properties: {
@@ -565,9 +569,6 @@ async function handleDeleteMemory(args) {
     const { memory_ids } = args;
     return makeApiCall("delete-memory", { memory_ids });
 }
-async function handleDebugStructure() {
-    return makeApiCall("debug-structure", {});
-}
 async function handleListSpaces() {
     return makeApiCall("list-spaces", {});
 }
@@ -634,9 +635,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "delete_memory":
                 result = await handleDeleteMemory(args);
                 break;
-            case "debug_memory_structure":
-                result = await handleDebugStructure();
-                break;
             case "list_spaces":
                 result = await handleListSpaces();
                 break;

package/index.ts

@@ -35,7 +35,7 @@ console.log("Intangle MCP Server starting - connecting to", API_BASE_URL);
 
 // Version checking
 // IMPORTANT: Update BOTH package.json version AND this constant when bumping version
-const CURRENT_VERSION = "1.0.8";
+const CURRENT_VERSION = "1.0.10";
 let latestVersion: string | null = null;
 let versionCheckDone = false;
 
@@ -100,7 +100,7 @@ const TOOLS = [
 	{
 		name: "add_memory",
 		description:
-			"Store one or more memories in the user's memory graph with flexible topics. Accepts a single memory object or an array of memory objects for batch creation. REQUIRES space_id parameter.",
+			"Store CONTEXT (general information and knowledge) in the user's memory system. For actionable workflow items with status tracking, use add_task instead. Accepts a single context item or an array of context items for batch creation. REQUIRES space_id parameter.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -164,7 +164,7 @@ const TOOLS = [
 	{
 		name: "search_memories",
 		description:
-			"Search through stored memories using advanced hybrid search (semantic + text + entity relationships). ALWAYS provide space_id parameter - this is mandatory for all searches.",
+			"Search through ALL stored data including BOTH context (general information) AND tasks (actionable workflow items). Uses advanced hybrid search (semantic + text + entity relationships). When a user asks to 'update memory' or 'check memory', this tool searches BOTH types. ALWAYS provide space_id parameter - this is mandatory for all searches.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -194,7 +194,7 @@ const TOOLS = [
 	{
 		name: "get_recent_memories",
 		description:
-			"Get the most recent memories stored in the system. REQUIRES space_id parameter.",
+			"Get the most recent CONTEXT items (general information). For recent tasks, use list_tasks instead. NOTE: This tool is called 'get_recent_memories' (not 'fetch'). Returns fully decrypted data. REQUIRES space_id parameter.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -220,20 +220,20 @@ const TOOLS = [
 	{
 		name: "get_entities",
 		description:
-			"Get extracted entities (people, places, concepts) from memories",
+			"Get extracted entities (people, places, concepts) from CONTEXT items (general information). If no memory_id provided, returns top 20 most frequently mentioned entities across all context. WARNING: This tool can return large responses - use sparingly and only when entity information is specifically needed.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				memory_id: {
 					type: "string",
-					description: "Optional memory ID to get entities for specific memory",
+					description: "Memory ID to get entities for. RECOMMENDED: Always provide memory_id to get focused results.",
 				},
 			},
 		},
 	},
 	{
 		name: "delete_memory",
-		description: "Delete one or more memories in a single transaction. Accepts a single memory ID or an array of memory IDs for batch deletion.",
+		description: "Delete one or more CONTEXT items (general information). For deleting tasks, use delete_task instead. Accepts a single memory ID or an array of memory IDs for batch deletion.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -255,19 +255,10 @@ const TOOLS = [
 			required: ["memory_ids"],
 		},
 	},
-	{
-		name: "debug_memory_structure",
-		description:
-			"Debug tool to inspect the current memory structure in the database",
-		inputSchema: {
-			type: "object",
-			properties: {},
-		},
-	},
 	{
 		name: "list_spaces",
 		description:
-			"Get all available spaces with their descriptions and memory counts",
+			"Get all available spaces with their descriptions and item counts (both context and tasks). Spaces are top-level containers that isolate different contexts (e.g., personal, work, projects).",
 		inputSchema: {
 			type: "object",
 			properties: {},
@@ -276,7 +267,7 @@ const TOOLS = [
 	{
 		name: "create_space",
 		description:
-			"Create a new space with optional startup configuration. The 'start' tool loads this configuration when beginning work in this space. Checks user's plan limits and returns upgrade link if limit reached.",
+			"Create a new space with optional startup configuration. Spaces are top-level containers that hold both context (general information) and tasks (actionable items). The 'start' tool loads this configuration when beginning work in this space. Checks user's plan limits and returns upgrade link if limit reached.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -286,7 +277,7 @@ const TOOLS = [
 				},
 				description: {
 					type: "string",
-					description: "Brief description of what this space is for (e.g., 'Work-related memories and tasks')",
+					description: "Brief description of what this space is for (e.g., 'Work-related context and tasks')",
 				},
 				startup_context: {
 					type: "string",
@@ -322,7 +313,7 @@ const TOOLS = [
 	{
 		name: "start",
 		description:
-			"Start working in a space and get its context. Returns static context, auto-searched memories, preferences, and optionally pending tasks. Call this when starting a conversation in a space to get relevant context.",
+			"Start working in a space and get comprehensive initialization. Returns static context, auto-searched context (general information), preferences, and optionally pending tasks. This tool retrieves BOTH context AND tasks based on space configuration. Call this when starting a conversation in a space to get relevant information.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -337,7 +328,7 @@ const TOOLS = [
 	{
 		name: "add_task",
 		description:
-			"Create one or more tasks in your space with status tracking. Accepts a single task object or an array of task objects for batch creation. Tasks have graph relationships like memories (entities, topics, temporal). REQUIRES space_id parameter.",
+			"Create one or more tasks in your space with status tracking and priority levels. Accepts a single task object or an array of task objects for batch creation. Tasks have graph relationships like memories (entities, topics, temporal). REQUIRES space_id parameter.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -370,6 +361,13 @@ const TOOLS = [
 									description: "Task status (default: pending)",
 									default: "pending",
 								},
+								priority: {
+									type: "string",
+									enum: ["urgent", "high", "medium", "low"],
+									description:
+										"Task priority level (default: medium). Use 'urgent' for time-sensitive tasks requiring immediate attention, 'high' for important tasks, 'medium' for standard tasks, 'low' for nice-to-have tasks.",
+									default: "medium",
+								},
 								parent_id: {
 									type: "string",
 									description: "Optional parent task ID to create this as a subtask",
@@ -401,6 +399,13 @@ const TOOLS = [
 										description: "Task status (default: pending)",
 										default: "pending",
 									},
+									priority: {
+										type: "string",
+										enum: ["urgent", "high", "medium", "low"],
+										description:
+											"Task priority level (default: medium). Use 'urgent' for time-sensitive tasks requiring immediate attention, 'high' for important tasks, 'medium' for standard tasks, 'low' for nice-to-have tasks.",
+										default: "medium",
+									},
 									parent_id: {
 										type: "string",
 										description: "Optional parent task ID to create this as a subtask",
@@ -437,7 +442,7 @@ const TOOLS = [
 	},
 	{
 		name: "update_task",
-		description: "Update one or more tasks. Accepts a single update object or an array of update objects for batch updates. Each update must include task_id.",
+		description: "Update one or more TASKS (not context/memories - use add_memory to update context by creating new versions). Accepts a single update object or an array of update objects for batch updates. Each update must include task_id.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -645,10 +650,6 @@ async function handleDeleteMemory(args: any) {
 	return makeApiCall("delete-memory", { memory_ids });
 }
 
-async function handleDebugStructure() {
-	return makeApiCall("debug-structure", {});
-}
-
 async function handleListSpaces() {
 	return makeApiCall("list-spaces", {});
 }
@@ -734,9 +735,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request: any) => {
 			case "delete_memory":
 				result = await handleDeleteMemory(args);
 				break;
-			case "debug_memory_structure":
-				result = await handleDebugStructure();
-				break;
 			case "list_spaces":
 				result = await handleListSpaces();
 				break;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@intangle/mcp-server",
-	"version": "1.0.9",
+	"version": "1.0.10",
 	"description": "Model Context Protocol server for Intangle - AI memory that persists across conversations",
 	"main": "dist/index.js",
 	"type": "module",