@intangle/mcp-server 2.1.6 → 2.1.8

package/README.md

@@ -1,10 +1,10 @@
 # @intangle/mcp-server
 
-Model Context Protocol server for [Intangle](https://intangle.app) - Intelligent AI memory that persists across conversations.
+Model Context Protocol server for [Intangle](https://intangle.app) - Intelligent AI context that persists across conversations.
 
 ## What is Intangle?
 
-Intangle is an AI memory system that gives Claude and other AI assistants persistent, searchable memory across all your conversations and isolated spaces. Unlike traditional chat interfaces where context is lost between sessions, Intangle maintains your personal memory across isolated spaces, with intelligent storing and retriveal.
+Intangle is an AI context system that gives Claude and other AI assistants persistent, searchable context across all your conversations and isolated spaces. Unlike traditional chat interfaces where context is lost between sessions, Intangle maintains your personal context across isolated spaces, with intelligent storing and retrieval.
 
 **Important: You need an Intangle account to use this MCP server. Sign up at [intangle.app](https://intangle.app)**
 
@@ -46,29 +46,29 @@ Standard MCP (Claude desktop, Cursor): by adding to your `claude_desktop_config.
 
 ## Usage
 
-Once configured, Claude will automatically have access to your Intangle memory. You can:
+Once configured, Claude will automatically have access to your Intangle context. You can:
 
-- **Store memories**: "Remember that I prefer TypeScript over JavaScript"
-- **Search memories**: "What did we discuss about the authentication system?"
-- **Organize with spaces**: Separate memories for personal, work, and different projects
-- **Tag with topics**: Memories are automatically tagged and organized
-- **Access across conversations**: All memories persist between chat sessions
+- **Store context**: "Remember that I prefer TypeScript over JavaScript"
+- **Search context**: "What did we discuss about the authentication system?"
+- **Organize with spaces**: Separate context for personal, work, and different projects
+- **Tag with topics**: Context is automatically tagged and organized
+- **Access across conversations**: All context persists between chat sessions
 
 ## Available Tools
 
 The MCP server provides these tools to Claude:
 
-- `add_memory` - Store new memories with topics
-- `search_memories` - Search across all your memories
-- `get_recent_memories` - Retrieve recent memories
-- `list_spaces` - View available memory spaces
+- `add_context` - Store new context with topics
+- `search_context` - Search across all your context
+- `get_recent_context` - Retrieve recent context
+- `list_spaces` - View available context spaces
 - `get_space_info` - Get details about a specific space
-- `get_entities` - Extract entities from memories
-- `delete_memory` - Remove specific memories
+- `get_entities` - Extract entities from context
+- `delete_context` - Remove specific context
 
 ## Features
 
-- **Multi-space support**: Organize memories into separate spaces (personal, work, projects)
+- **Multi-space support**: Organize context into separate spaces (personal, work, projects)
 - **Intelligent search**: Combines semantic search with text matching
 - **Entity extraction**: Automatically identifies people, places, and concepts
 - **Temporal awareness**: Tracks when events happened vs when they were recorded
@@ -76,7 +76,7 @@ The MCP server provides these tools to Claude:
 
 ## Troubleshooting
 
-If Claude can't access your memories:
+If Claude can't access your context:
 
 1. Verify your API key is correct
 2. Check that the MCP server is listed in Claude's tool menu

package/biome.json

@@ -1,39 +1,39 @@
 {
-	"$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-	"vcs": {
-		"enabled": false,
-		"clientKind": "git",
-		"useIgnoreFile": false
-	},
-	"files": {
-		"ignoreUnknown": false
-	},
-	"formatter": {
-		"enabled": true,
-		"formatWithErrors": false,
-		"indentStyle": "space",
-		"indentWidth": 2,
-		"lineEnding": "lf",
-		"lineWidth": 80,
-		"attributePosition": "auto"
-	},
-	"linter": {
-		"enabled": true,
-		"rules": {
-			"recommended": true
-		}
-	},
-	"javascript": {
-		"formatter": {
-			"jsxQuoteStyle": "double",
-			"quoteProperties": "asNeeded",
-			"trailingCommas": "es5",
-			"semicolons": "asNeeded",
-			"arrowParentheses": "always",
-			"bracketSpacing": true,
-			"bracketSameLine": false,
-			"quoteStyle": "double",
-			"attributePosition": "auto"
-		}
-	}
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "vcs": {
+    "enabled": false,
+    "clientKind": "git",
+    "useIgnoreFile": false
+  },
+  "files": {
+    "ignoreUnknown": false
+  },
+  "formatter": {
+    "enabled": true,
+    "formatWithErrors": false,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 80,
+    "attributePosition": "auto"
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "trailingCommas": "es5",
+      "semicolons": "asNeeded",
+      "arrowParentheses": "always",
+      "bracketSpacing": true,
+      "bracketSameLine": false,
+      "quoteStyle": "double",
+      "attributePosition": "auto"
+    }
+  }
 }

package/dist/index.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 /**
- * Endure MCP Server - Exposes Endure memory functionality through MCP
+ * Endure MCP Server - Exposes Endure context functionality through MCP
  */
-import { config } from "dotenv";
-import fetch from "node-fetch";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
-import { readFileSync } from "fs";
-import { fileURLToPath } from "url";
-import { dirname, join } from "path";
+import { config } from "dotenv";
+import fetch from "node-fetch";
 import { TOOLS } from "./tool-definitions.js";
 // ... imports ...
 // Debug logging
@@ -22,6 +22,9 @@ function log(msg) {
     catch (e) { }
 }
 log("--- Server Starting ---");
+// Client info captured from MCP initialize handshake
+let mcpClientName;
+let mcpClientVersion;
 try {
     // Load environment variables from .env and .env.local
     config({ quiet: true });
@@ -76,14 +79,38 @@ try {
     }
     // Check version on startup (non-blocking)
     checkVersion();
+    // Helper to ensure client info is captured (called before API requests)
+    function ensureClientInfo() {
+        if (!mcpClientName) {
+            const clientInfo = server.getClientVersion();
+            if (clientInfo) {
+                mcpClientName = clientInfo.name;
+                mcpClientVersion = clientInfo.version;
+                log(`Client identified (on-demand): ${mcpClientName} v${mcpClientVersion}`);
+            }
+        }
+    }
     async function makeApiCall(endpoint, data) {
+        // Ensure we have client info before making requests
+        ensureClientInfo();
+        // Build headers with client info if available
+        const headers = {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${MCP_API_KEY}`,
+            "User-Agent": mcpClientName
+                ? `${mcpClientName}/${mcpClientVersion || "unknown"} (mcp-stdio)`
+                : "MCP-Client-Stdio/1.1.2 (mcp)",
+        };
+        // Add explicit client info headers for backend processing
+        if (mcpClientName) {
+            headers["X-MCP-Client-Name"] = mcpClientName;
+        }
+        if (mcpClientVersion) {
+            headers["X-MCP-Client-Version"] = mcpClientVersion;
+        }
         const response = await fetch(`${API_BASE_URL}/api/mcp/${endpoint}`, {
             method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                Authorization: `Bearer ${MCP_API_KEY}`,
-                "User-Agent": "MCP-Client-Stdio/1.1.2 (mcp)",
-            },
+            headers,
             body: JSON.stringify(data),
         });
         if (!response.ok) {
@@ -92,7 +119,7 @@ try {
         return response.json();
     }
     const server = new Server({
-        name: "intangle-memory",
+        name: "intangle-context",
         version: "1.0.0",
         vendor: "Intangle",
         icon: "https://intangle.tools/icon.png",
@@ -104,13 +131,13 @@ try {
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: TOOLS,
     }));
-    async function handleSearchMemories(args) {
+    async function handleSearchContext(args) {
         const { space_id, query, topics } = args;
         // Require space_id
         if (!space_id) {
             throw new Error("space_id is required. Use list_spaces to see available options.");
         }
-        return makeApiCall("search-memories", {
+        return makeApiCall("search-context", {
             space_id,
             space_ids: [space_id], // Convert to array for backend compatibility
             query,
@@ -172,7 +199,7 @@ try {
             let result;
             switch (name) {
                 case "search":
-                    result = await handleSearchMemories(args);
+                    result = await handleSearchContext(args);
                     break;
                 case "fetch_items":
                     result = await handleFetch(args);
@@ -231,6 +258,7 @@ try {
         const transport = new StdioServerTransport();
         await server.connect(transport);
         log("Server connected to transport");
+        // Client info is captured on-demand in ensureClientInfo() before first API call
     }
     main().catch((err) => {
         log(`Error in main: ${err}`);

package/dist/tool-definitions.js

@@ -3,7 +3,7 @@ export const TOOLS = [
     {
         name: "search",
         title: "Search Space",
-        description: "Search for information within a space. System automatically extracts quantity from natural language ('show 3 tasks' → 3 results, 'the last one' → 1 result) and intelligently formats results (1-3 items → summaries, 4+ items → IDs only). Use fetch tool to get full content for specific IDs when needed.",
+        description: "Search for context, tasks, and processes within a space. System automatically extracts quantity from natural language ('show 3 tasks' → 3 results, 'the last one' → 1 result) and intelligently formats results (1-3 items → summaries, 4+ items → IDs only). Use fetch tool to get full content for specific IDs when needed.",
         inputSchema: {
             type: "object",
             properties: {
@@ -33,12 +33,12 @@ export const TOOLS = [
             properties: {
                 id: {
                     type: "string",
-                    description: "Single ID to fetch (context or task ID like 'mem_123' or 'task_456')",
+                    description: "Single ID to fetch (context or task ID like 'mem_123' or 'task_456' or 'proc_789')",
                 },
                 ids: {
                     type: "array",
                     items: { type: "string" },
-                    description: "Array of IDs to fetch (mix of context and task IDs). Use this to fetch multiple items in one call.",
+                    description: "Array of IDs to fetch (mix of context, task, and process IDs). Use this to fetch multiple items in one call.",
                 },
             },
         },
@@ -46,7 +46,7 @@ export const TOOLS = [
     {
         name: "view_topic",
         title: "View Topic",
-        description: "View all memories and tasks tagged with a specific topic. Perfect for exploring a topic area or following up on topics from the start briefing.",
+        description: "View all context, tasks, and processes tagged with a specific topic. Perfect for exploring a topic area or following up on topics from the start briefing.",
         inputSchema: {
             type: "object",
             properties: {
@@ -115,7 +115,7 @@ export const TOOLS = [
                 config_badges: {
                     type: "array",
                     items: { type: "string" },
-                    description: "Array of keywords for start tool keywords in this NEW space. These keywords help steer what context gets loaded when running 'start' for this space. Examples: ['fitness', 'recipes', 'travel planning'], ['client work', 'meetings', 'proposals'], ['TypeScript', 'React', 'API design']. They act as search terms to prioritize relevant memories.",
+                    description: "Array of keywords for start tool keywords in this NEW space. These keywords help steer what context gets loaded when running 'start' for this space. Examples: ['fitness', 'recipes', 'travel planning'], ['client work', 'meetings', 'proposals'], ['TypeScript', 'React', 'API design']. They act as search terms to prioritize relevant context.",
                 },
                 startup_preferences: {
                     type: "string",
@@ -153,7 +153,7 @@ export const TOOLS = [
                 },
                 add: {
                     type: "object",
-                    description: "Add new items to memory with automatic intelligent classification and topic suggestion",
+                    description: "Add new items to context with automatic intelligent classification and topic suggestion",
                     properties: {
                         items: {
                             type: "array",
@@ -163,25 +163,25 @@ export const TOOLS = [
                                     title: { type: "string", description: "Item title" },
                                     content: {
                                         type: "string",
-                                        description: "Item content - system automatically classifies as task (actionable) or context (knowledge) and suggests relevant topics",
+                                        description: "Item content - system automatically classifies as task (actionable), context (knowledge), or process (workflow/procedure) and suggests relevant topics",
                                     },
                                 },
                                 required: ["title", "content"],
                             },
-                            description: "Array of items to add. System intelligently: (1) classifies as task or context, (2) suggests 1-3 relevant topics based on content and existing topics. Examples: 'Need to fix auth bug' → task with topics like 'authentication', 'bug-fix'. 'Learned React batches updates' → context with topics like 'react', 'learning'.",
+                            description: "Array of items to add. System intelligently: (1) classifies as task, context, or process, (2) suggests 1-3 relevant topics based on content and existing topics. Examples: 'Need to fix auth bug' → task with topics like 'authentication', 'bug-fix'. 'Learned React batches updates' → context with topics like 'react', 'learning'.",
                         },
                     },
                 },
                 update: {
                     type: "object",
-                    description: "Update existing items (context or tasks) - system detects type from ID prefix",
+                    description: "Update existing items (context, tasks, or processes) - system detects type from ID prefix",
                     properties: {
                         items: {
                             type: "array",
                             items: {
                                 type: "object",
                                 properties: {
-                                    id: { type: "string", description: "Item ID to update (mem_* for context, task_* for tasks)" },
+                                    id: { type: "string", description: "Item ID to update (mem_* for context, task_* for tasks, proc_* for processes)" },
                                     title: {
                                         type: "string",
                                         description: "New title (optional)",
@@ -213,7 +213,7 @@ export const TOOLS = [
                                 },
                                 required: ["id"],
                             },
-                            description: "Array of items to update. Type automatically detected from ID prefix (mem_* = context, task_* = task). For context items, status/priority are ignored.",
+                            description: "Array of items to update. Type automatically detected from ID prefix (mem_* = context, task_* = task, proc_* = process). For context/process items, status/priority are ignored.",
                         },
                     },
                 },
@@ -224,7 +224,7 @@ export const TOOLS = [
                         item_ids: {
                             type: "array",
                             items: { type: "string" },
-                            description: "Array of item IDs to delete (mem_* for context, task_* for tasks). Type automatically detected from ID prefix.",
+                            description: "Array of item IDs to delete (mem_* for context, task_* for tasks, proc_* for processes). Type automatically detected from ID prefix.",
                         },
                     },
                 },

package/index.ts

@@ -1,315 +1,347 @@
 #!/usr/bin/env node
 
 /**
- * Endure MCP Server - Exposes Endure memory functionality through MCP
+ * Endure MCP Server - Exposes Endure context functionality through MCP
  */
 
-import { config } from "dotenv";
-import fetch from "node-fetch";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { readFileSync } from "fs"
+import { dirname, join } from "path"
+import { fileURLToPath } from "url"
+import { Server } from "@modelcontextprotocol/sdk/server/index.js"
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import {
-	CallToolRequestSchema,
-	ErrorCode,
-	ListToolsRequestSchema,
-	McpError,
-} from "@modelcontextprotocol/sdk/types.js";
-import { readFileSync } from "fs";
-import { fileURLToPath } from "url";
-import { dirname, join } from "path";
-import { TOOLS } from "./tool-definitions.js";
+  CallToolRequestSchema,
+  ErrorCode,
+  ListToolsRequestSchema,
+  McpError,
+} from "@modelcontextprotocol/sdk/types.js"
+import { config } from "dotenv"
+import fetch from "node-fetch"
+import { TOOLS } from "./tool-definitions.js"
 
 // ... imports ...
 
 // Debug logging
-import { appendFileSync } from "fs";
-const DEBUG_LOG = "/tmp/intangle-mcp-debug.log";
+import { appendFileSync } from "fs"
+const DEBUG_LOG = "/tmp/intangle-mcp-debug.log"
 function log(msg: string) {
-	try {
-		appendFileSync(DEBUG_LOG, `${new Date().toISOString()}: ${msg}\n`);
-	} catch (e) { }
+  try {
+    appendFileSync(DEBUG_LOG, `${new Date().toISOString()}: ${msg}\n`)
+  } catch (e) {}
 }
 
-log("--- Server Starting ---");
+log("--- Server Starting ---")
 
-try {
-	// Load environment variables from .env and .env.local
-	config({ quiet: true });
-	config({ path: ".env.local", quiet: true });
-
-	// Base URL for API calls to Next.js app
-	const API_BASE_URL = process.env.NEXT_APP_URL || "https://intangle.app";
-	const MCP_API_KEY = process.env.MCP_API_KEY;
-
-	log(`CWD: ${process.cwd()}`);
-	log(`Has API Key: ${!!MCP_API_KEY}`);
-	log(`Node Version: ${process.version}`);
-
-	if (!MCP_API_KEY) {
-		log("Error: MCP_API_KEY environment variable is required");
-		console.error("Error: MCP_API_KEY environment variable is required");
-		console.error(
-			"Please set your Intangle API key in the Claude Desktop configuration",
-		);
-		process.exit(1);
-	}
-
-	console.error("Intangle MCP Server starting - connecting to", API_BASE_URL);
-
-	// Version checking - automatically read from package.json
-	const __dirname = dirname(fileURLToPath(import.meta.url));
-	let packageJson;
-	try {
-		packageJson = JSON.parse(
-			readFileSync(join(__dirname, "package.json"), "utf-8"),
-		);
-	} catch {
-		packageJson = JSON.parse(
-			readFileSync(join(__dirname, "../package.json"), "utf-8"),
-		);
-	}
-	const CURRENT_VERSION = packageJson.version;
-	let latestVersion: string | null = null;
-	let versionCheckDone = false;
-
-	async function checkVersion() {
-		if (versionCheckDone) return;
-
-		try {
-			const response = await fetch(
-				"https://registry.npmjs.org/@intangle/mcp-server/latest",
-			);
-			const data = (await response.json()) as { version: string };
-			latestVersion = data.version;
-			versionCheckDone = true;
-
-			if (latestVersion && latestVersion !== CURRENT_VERSION) {
-				console.error("\n UPDATE AVAILABLE ");
-				console.error(`Current version: ${CURRENT_VERSION}`);
-				console.error(`Latest version: ${latestVersion}`);
-				console.error("Update with: npx @intangle/mcp-server@latest\n");
-			} else {
-				console.error(`✓ Running latest version (${CURRENT_VERSION})`);
-			}
-		} catch (error) {
-			// Silently fail version check - don't block startup
-			versionCheckDone = true;
-		}
-	}
-
-	// Check version on startup (non-blocking)
-	checkVersion();
-
-	async function makeApiCall(endpoint: string, data: any) {
-		const response = await fetch(`${API_BASE_URL}/api/mcp/${endpoint}`, {
-			method: "POST",
-			headers: {
-				"Content-Type": "application/json",
-				Authorization: `Bearer ${MCP_API_KEY}`,
-				"User-Agent": "MCP-Client-Stdio/1.1.2 (mcp)",
-			},
-			body: JSON.stringify(data),
-		});
-
-		if (!response.ok) {
-			throw new Error(
-				`API call failed: ${response.status} ${response.statusText}`,
-			);
-		}
-
-		return response.json();
-	}
-
-	const server = new Server(
-		{
-			name: "intangle-memory",
-			version: "1.0.0",
-			vendor: "Intangle",
-			icon: "https://intangle.tools/icon.png",
-		},
-		{
-			capabilities: {
-				tools: {},
-			},
-		},
-	);
-
-	server.setRequestHandler(ListToolsRequestSchema, async () => ({
-		tools: TOOLS,
-	}));
-
-	async function handleSearchMemories(args: any) {
-		const { space_id, query, topics } = args as {
-			space_id: string;
-			query: string;
-			topics?: string[];
-		};
-
-		// Require space_id
-		if (!space_id) {
-			throw new Error(
-				"space_id is required. Use list_spaces to see available options.",
-			);
-		}
-
-		return makeApiCall("search-memories", {
-			space_id,
-			space_ids: [space_id], // Convert to array for backend compatibility
-			query,
-			topics,
-		});
-	}
-
-	async function handleFetch(args: any) {
-		const { id, ids } = args as { id?: string; ids?: string[] };
-
-		return makeApiCall("fetch", { id, ids });
-	}
-
-	async function handleViewSpaces() {
-		return makeApiCall("list-spaces", {});
-	}
-
-	async function handleViewTopics(args: any) {
-		const { space_id } = args as { space_id: string };
-		if (!space_id) {
-			throw new Error(
-				"space_id is required. Use view_spaces to see available options.",
-			);
-		}
-		return makeApiCall("view-topics", { space_id });
-	}
-
-	async function handleViewTopic(args: any) {
-		const { topic_id } = args as { topic_id: string };
-		if (!topic_id) {
-			throw new Error(
-				"topic_id is required. Use view_topics to get valid IDs.",
-			);
-		}
-		// Pass directly to API; ensure API expects 'topic_id' or adjust if it expects 'id'
-		// Usually view-topic endpoint takes 'topic_id' or 'id'
-		return makeApiCall("view-topic", { topic_id });
-	}
-
-	async function handleCreateSpace(args: any) {
-		return makeApiCall("create-space", args);
-	}
-
-	async function handleViewSpace(args: any) {
-		const { space_id } = args as { space_id: string };
-		return makeApiCall("view-space", { space_id });
-	}
-
-	async function handleStart(args: any) {
-		const { space_id } = args as { space_id: string };
-		return makeApiCall("start", { space_id });
-	}
-
-	async function handleUpdateSpace(args: any) {
-		if (!args.space_id) {
-			throw new Error(
-				"space_id is required. Use view_spaces to see available options.",
-			);
-		}
-
-		if (!args.add && !args.update && !args.delete) {
-			throw new Error(
-				"At least one operation (add, update, delete) must be provided",
-			);
-		}
-
-		// Pass through to API with new structure
-		return makeApiCall("update-memory", {
-			space_id: args.space_id,
-			add: args.add,
-			update: args.update,
-			delete: args.delete,
-		});
-	}
-
-	server.setRequestHandler(CallToolRequestSchema, async (request: any) => {
-		const { name, arguments: args } = request.params;
-
-		try {
-			let result: any;
-
-			switch (name) {
-				case "search":
-					result = await handleSearchMemories(args);
-					break;
-				case "fetch_items":
-					result = await handleFetch(args);
-					break;
-				case "view_spaces":
-					result = await handleViewSpaces();
-					break;
-				case "view_topics":
-					result = await handleViewTopics(args);
-					break;
-				case "view_topic":
-					result = await handleViewTopic(args);
-					break;
-				case "create_space":
-					result = await handleCreateSpace(args);
-					break;
-				case "view_space":
-					result = await handleViewSpace(args);
-					break;
-				case "start":
-					result = await handleStart(args);
-					break;
-				case "update_space":
-					result = await handleUpdateSpace(args);
-					break;
-				default:
-					throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
-			}
-
-			// Extract response field for Layer 2 compressed tools, otherwise stringify full result
-			let responseText: string;
-			if (
-				result &&
-				typeof result === "object" &&
-				"response" in result &&
-				typeof result.response === "string"
-			) {
-				// Tool has Layer 2 compression - use the formatted response field
-				responseText = result.response;
-			} else {
-				// Standard tool - return full JSON
-				responseText = JSON.stringify(result, null, 2);
-			}
-
-			// Add version warning to response if outdated
-			if (latestVersion && latestVersion !== CURRENT_VERSION) {
-				const warning = `\n\n UPDATE AVAILABLE: MCP Server v${latestVersion} is available (you're on v${CURRENT_VERSION}). Update with: npx @intangle/mcp-server@latest`;
-				responseText += warning;
-			}
-
-			return {
-				content: [{ type: "text", text: responseText }],
-			};
-		} catch (error) {
-			throw new McpError(
-				ErrorCode.InternalError,
-				`Error executing tool ${name}: ${error instanceof Error ? error.message : String(error)}`,
-			);
-		}
-	});
-
-	async function main() {
-		const transport = new StdioServerTransport();
-		await server.connect(transport);
-		log("Server connected to transport");
-	}
-
-	main().catch((err) => {
-		log(`Error in main: ${err}`);
-		process.exit(1);
-	});
+// Client info captured from MCP initialize handshake
+let mcpClientName: string | undefined
+let mcpClientVersion: string | undefined
 
+try {
+  // Load environment variables from .env and .env.local
+  config({ quiet: true })
+  config({ path: ".env.local", quiet: true })
+
+  // Base URL for API calls to Next.js app
+  const API_BASE_URL = process.env.NEXT_APP_URL || "https://intangle.app"
+  const MCP_API_KEY = process.env.MCP_API_KEY
+
+  log(`CWD: ${process.cwd()}`)
+  log(`Has API Key: ${!!MCP_API_KEY}`)
+  log(`Node Version: ${process.version}`)
+
+  if (!MCP_API_KEY) {
+    log("Error: MCP_API_KEY environment variable is required")
+    console.error("Error: MCP_API_KEY environment variable is required")
+    console.error(
+      "Please set your Intangle API key in the Claude Desktop configuration"
+    )
+    process.exit(1)
+  }
+
+  console.error("Intangle MCP Server starting - connecting to", API_BASE_URL)
+
+  // Version checking - automatically read from package.json
+  const __dirname = dirname(fileURLToPath(import.meta.url))
+  let packageJson
+  try {
+    packageJson = JSON.parse(
+      readFileSync(join(__dirname, "package.json"), "utf-8")
+    )
+  } catch {
+    packageJson = JSON.parse(
+      readFileSync(join(__dirname, "../package.json"), "utf-8")
+    )
+  }
+  const CURRENT_VERSION = packageJson.version
+  let latestVersion: string | null = null
+  let versionCheckDone = false
+
+  async function checkVersion() {
+    if (versionCheckDone) return
+
+    try {
+      const response = await fetch(
+        "https://registry.npmjs.org/@intangle/mcp-server/latest"
+      )
+      const data = (await response.json()) as { version: string }
+      latestVersion = data.version
+      versionCheckDone = true
+
+      if (latestVersion && latestVersion !== CURRENT_VERSION) {
+        console.error("\n UPDATE AVAILABLE ")
+        console.error(`Current version: ${CURRENT_VERSION}`)
+        console.error(`Latest version: ${latestVersion}`)
+        console.error("Update with: npx @intangle/mcp-server@latest\n")
+      } else {
+        console.error(`✓ Running latest version (${CURRENT_VERSION})`)
+      }
+    } catch (error) {
+      // Silently fail version check - don't block startup
+      versionCheckDone = true
+    }
+  }
+
+  // Check version on startup (non-blocking)
+  checkVersion()
+
+  // Helper to ensure client info is captured (called before API requests)
+  function ensureClientInfo() {
+    if (!mcpClientName) {
+      const clientInfo = server.getClientVersion()
+      if (clientInfo) {
+        mcpClientName = clientInfo.name
+        mcpClientVersion = clientInfo.version
+        log(
+          `Client identified (on-demand): ${mcpClientName} v${mcpClientVersion}`
+        )
+      }
+    }
+  }
+
+  async function makeApiCall(endpoint: string, data: any) {
+    // Ensure we have client info before making requests
+    ensureClientInfo()
+
+    // Build headers with client info if available
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${MCP_API_KEY}`,
+      "User-Agent": mcpClientName
+        ? `${mcpClientName}/${mcpClientVersion || "unknown"} (mcp-stdio)`
+        : "MCP-Client-Stdio/1.1.2 (mcp)",
+    }
+
+    // Add explicit client info headers for backend processing
+    if (mcpClientName) {
+      headers["X-MCP-Client-Name"] = mcpClientName
+    }
+    if (mcpClientVersion) {
+      headers["X-MCP-Client-Version"] = mcpClientVersion
+    }
+
+    const response = await fetch(`${API_BASE_URL}/api/mcp/${endpoint}`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(data),
+    })
+
+    if (!response.ok) {
+      throw new Error(
+        `API call failed: ${response.status} ${response.statusText}`
+      )
+    }
+
+    return response.json()
+  }
+
+  const server = new Server(
+    {
+      name: "intangle-context",
+      version: "1.0.0",
+      vendor: "Intangle",
+      icon: "https://intangle.tools/icon.png",
+    },
+    {
+      capabilities: {
+        tools: {},
+      },
+    }
+  )
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+  }))
+
+  async function handleSearchContext(args: any) {
+    const { space_id, query, topics } = args as {
+      space_id: string
+      query: string
+      topics?: string[]
+    }
+
+    // Require space_id
+    if (!space_id) {
+      throw new Error(
+        "space_id is required. Use list_spaces to see available options."
+      )
+    }
+
+    return makeApiCall("search-context", {
+      space_id,
+      space_ids: [space_id], // Convert to array for backend compatibility
+      query,
+      topics,
+    })
+  }
+
+  async function handleFetch(args: any) {
+    const { id, ids } = args as { id?: string; ids?: string[] }
+
+    return makeApiCall("fetch", { id, ids })
+  }
+
+  async function handleViewSpaces() {
+    return makeApiCall("list-spaces", {})
+  }
+
+  async function handleViewTopics(args: any) {
+    const { space_id } = args as { space_id: string }
+    if (!space_id) {
+      throw new Error(
+        "space_id is required. Use view_spaces to see available options."
+      )
+    }
+    return makeApiCall("view-topics", { space_id })
+  }
+
+  async function handleViewTopic(args: any) {
+    const { topic_id } = args as { topic_id: string }
+    if (!topic_id) {
+      throw new Error("topic_id is required. Use view_topics to get valid IDs.")
+    }
+    // Pass directly to API; ensure API expects 'topic_id' or adjust if it expects 'id'
+    // Usually view-topic endpoint takes 'topic_id' or 'id'
+    return makeApiCall("view-topic", { topic_id })
+  }
+
+  async function handleCreateSpace(args: any) {
+    return makeApiCall("create-space", args)
+  }
+
+  async function handleViewSpace(args: any) {
+    const { space_id } = args as { space_id: string }
+    return makeApiCall("view-space", { space_id })
+  }
+
+  async function handleStart(args: any) {
+    const { space_id } = args as { space_id: string }
+    return makeApiCall("start", { space_id })
+  }
+
+  async function handleUpdateSpace(args: any) {
+    if (!args.space_id) {
+      throw new Error(
+        "space_id is required. Use view_spaces to see available options."
+      )
+    }
+
+    if (!args.add && !args.update && !args.delete) {
+      throw new Error(
+        "At least one operation (add, update, delete) must be provided"
+      )
+    }
+
+    // Pass through to API with new structure
+    return makeApiCall("update-memory", {
+      space_id: args.space_id,
+      add: args.add,
+      update: args.update,
+      delete: args.delete,
+    })
+  }
+
+  server.setRequestHandler(CallToolRequestSchema, async (request: any) => {
+    const { name, arguments: args } = request.params
+
+    try {
+      let result: any
+
+      switch (name) {
+        case "search":
+          result = await handleSearchContext(args)
+          break
+        case "fetch_items":
+          result = await handleFetch(args)
+          break
+        case "view_spaces":
+          result = await handleViewSpaces()
+          break
+        case "view_topics":
+          result = await handleViewTopics(args)
+          break
+        case "view_topic":
+          result = await handleViewTopic(args)
+          break
+        case "create_space":
+          result = await handleCreateSpace(args)
+          break
+        case "view_space":
+          result = await handleViewSpace(args)
+          break
+        case "start":
+          result = await handleStart(args)
+          break
+        case "update_space":
+          result = await handleUpdateSpace(args)
+          break
+        default:
+          throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`)
+      }
+
+      // Extract response field for Layer 2 compressed tools, otherwise stringify full result
+      let responseText: string
+      if (
+        result &&
+        typeof result === "object" &&
+        "response" in result &&
+        typeof result.response === "string"
+      ) {
+        // Tool has Layer 2 compression - use the formatted response field
+        responseText = result.response
+      } else {
+        // Standard tool - return full JSON
+        responseText = JSON.stringify(result, null, 2)
+      }
+
+      // Add version warning to response if outdated
+      if (latestVersion && latestVersion !== CURRENT_VERSION) {
+        const warning = `\n\n UPDATE AVAILABLE: MCP Server v${latestVersion} is available (you're on v${CURRENT_VERSION}). Update with: npx @intangle/mcp-server@latest`
+        responseText += warning
+      }
+
+      return {
+        content: [{ type: "text", text: responseText }],
+      }
+    } catch (error) {
+      throw new McpError(
+        ErrorCode.InternalError,
+        `Error executing tool ${name}: ${error instanceof Error ? error.message : String(error)}`
+      )
+    }
+  })
+
+  async function main() {
+    const transport = new StdioServerTransport()
+    await server.connect(transport)
+    log("Server connected to transport")
+    // Client info is captured on-demand in ensureClientInfo() before first API call
+  }
+
+  main().catch((err) => {
+    log(`Error in main: ${err}`)
+    process.exit(1)
+  })
 } catch (err) {
-	log(`Fatal startup error: ${err}`);
-	process.exit(1);
+  log(`Fatal startup error: ${err}`)
+  process.exit(1)
 }

package/package.json

@@ -1,53 +1,53 @@
 {
-	"name": "@intangle/mcp-server",
-	"version": "2.1.6",
-	"description": "Model Context Protocol server for Intangle - AI memory that persists across conversations",
-	"main": "dist/index.js",
-	"type": "module",
-	"scripts": {
-		"start": "node dist/index.js",
-		"dev": "tsx watch index.ts",
-		"prebuild": "cp ../web/src/app/api/mcp-remote/tool-definitions.ts ./tool-definitions.ts",
-		"build": "tsc",
-		"lint": "biome check .",
-		"lint:fix": "biome check --fix .",
-		"prepublishOnly": "npm run build"
-	},
-	"bin": {
-		"intangle-mcp": "dist/index.js"
-	},
-	"keywords": [
-		"mcp",
-		"model-context-protocol",
-		"claude",
-		"claude-code",
-		"ai",
-		"memory",
-		"knowledge-management",
-		"intangle",
-		"claude-desktop",
-		"anthropic"
-	],
-	"author": "Intangle",
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/intangle/mcp-server.git"
-	},
-	"homepage": "https://intangle.app",
-	"engines": {
-		"node": ">=18.0.0"
-	},
-	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.0.0",
-		"dotenv": "^17.2.0",
-		"node-fetch": "^3.3.2"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "^1.9.4",
-		"@types/node": "^22.0.0",
-		"@types/node-fetch": "^2.6.12",
-		"tsx": "^4.0.0",
-		"typescript": "^5.0.0"
-	}
+  "name": "@intangle/mcp-server",
+  "version": "2.1.8",
+  "description": "Model Context Protocol server for Intangle - AI context that persists across conversations",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch index.ts",
+    "prebuild": "cp ../web/src/app/api/mcp-remote/tool-definitions.ts ./tool-definitions.ts",
+    "build": "tsc",
+    "lint": "biome check .",
+    "lint:fix": "biome check --fix .",
+    "prepublishOnly": "npm run build"
+  },
+  "bin": {
+    "intangle-mcp": "dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "claude-code",
+    "ai",
+    "context",
+    "knowledge-management",
+    "intangle",
+    "claude-desktop",
+    "anthropic"
+  ],
+  "author": "Intangle",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intangle/mcp-server.git"
+  },
+  "homepage": "https://intangle.app",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "dotenv": "^17.2.0",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^22.0.0",
+    "@types/node-fetch": "^2.6.12",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
 }

package/tool-definitions.ts

@@ -4,7 +4,7 @@ export const TOOLS = [
 		name: "search",
 		title: "Search Space",
 		description:
-			"Search for information within a space. System automatically extracts quantity from natural language ('show 3 tasks' → 3 results, 'the last one' → 1 result) and intelligently formats results (1-3 items → summaries, 4+ items → IDs only). Use fetch tool to get full content for specific IDs when needed.",
+			"Search for context, tasks, and processes within a space. System automatically extracts quantity from natural language ('show 3 tasks' → 3 results, 'the last one' → 1 result) and intelligently formats results (1-3 items → summaries, 4+ items → IDs only). Use fetch tool to get full content for specific IDs when needed.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -37,13 +37,13 @@ export const TOOLS = [
 				id: {
 					type: "string",
 					description:
-						"Single ID to fetch (context or task ID like 'mem_123' or 'task_456')",
+						"Single ID to fetch (context or task ID like 'mem_123' or 'task_456' or 'proc_789')",
 				},
 				ids: {
 					type: "array",
 					items: { type: "string" },
 					description:
-						"Array of IDs to fetch (mix of context and task IDs). Use this to fetch multiple items in one call.",
+						"Array of IDs to fetch (mix of context, task, and process IDs). Use this to fetch multiple items in one call.",
 				},
 			},
 		},
@@ -52,7 +52,7 @@ export const TOOLS = [
 		name: "view_topic",
 		title: "View Topic",
 		description:
-			"View all memories and tasks tagged with a specific topic. Perfect for exploring a topic area or following up on topics from the start briefing.",
+			"View all context, tasks, and processes tagged with a specific topic. Perfect for exploring a topic area or following up on topics from the start briefing.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -128,7 +128,7 @@ export const TOOLS = [
 					type: "array",
 					items: { type: "string" },
 					description:
-						"Array of keywords for start tool keywords in this NEW space. These keywords help steer what context gets loaded when running 'start' for this space. Examples: ['fitness', 'recipes', 'travel planning'], ['client work', 'meetings', 'proposals'], ['TypeScript', 'React', 'API design']. They act as search terms to prioritize relevant memories.",
+						"Array of keywords for start tool keywords in this NEW space. These keywords help steer what context gets loaded when running 'start' for this space. Examples: ['fitness', 'recipes', 'travel planning'], ['client work', 'meetings', 'proposals'], ['TypeScript', 'React', 'API design']. They act as search terms to prioritize relevant context.",
 				},
 				startup_preferences: {
 					type: "string",
@@ -170,7 +170,7 @@ export const TOOLS = [
 				},
 				add: {
 					type: "object",
-					description: "Add new items to memory with automatic intelligent classification and topic suggestion",
+					description: "Add new items to context with automatic intelligent classification and topic suggestion",
 					properties: {
 						items: {
 							type: "array",
@@ -180,25 +180,25 @@ export const TOOLS = [
 									title: { type: "string", description: "Item title" },
 									content: {
 										type: "string",
-										description: "Item content - system automatically classifies as task (actionable) or context (knowledge) and suggests relevant topics",
+										description: "Item content - system automatically classifies as task (actionable), context (knowledge), or process (workflow/procedure) and suggests relevant topics",
 									},
 								},
 								required: ["title", "content"],
 							},
-							description: "Array of items to add. System intelligently: (1) classifies as task or context, (2) suggests 1-3 relevant topics based on content and existing topics. Examples: 'Need to fix auth bug' → task with topics like 'authentication', 'bug-fix'. 'Learned React batches updates' → context with topics like 'react', 'learning'.",
+							description: "Array of items to add. System intelligently: (1) classifies as task, context, or process, (2) suggests 1-3 relevant topics based on content and existing topics. Examples: 'Need to fix auth bug' → task with topics like 'authentication', 'bug-fix'. 'Learned React batches updates' → context with topics like 'react', 'learning'.",
 						},
 					},
 				},
 				update: {
 					type: "object",
-					description: "Update existing items (context or tasks) - system detects type from ID prefix",
+					description: "Update existing items (context, tasks, or processes) - system detects type from ID prefix",
 					properties: {
 						items: {
 							type: "array",
 							items: {
 								type: "object",
 								properties: {
-									id: { type: "string", description: "Item ID to update (mem_* for context, task_* for tasks)" },
+									id: { type: "string", description: "Item ID to update (mem_* for context, task_* for tasks, proc_* for processes)" },
 									title: {
 										type: "string",
 										description: "New title (optional)",
@@ -230,7 +230,7 @@ export const TOOLS = [
 								},
 								required: ["id"],
 							},
-							description: "Array of items to update. Type automatically detected from ID prefix (mem_* = context, task_* = task). For context items, status/priority are ignored.",
+							description: "Array of items to update. Type automatically detected from ID prefix (mem_* = context, task_* = task, proc_* = process). For context/process items, status/priority are ignored.",
 						},
 					},
 				},
@@ -241,7 +241,7 @@ export const TOOLS = [
 						item_ids: {
 							type: "array",
 							items: { type: "string" },
-							description: "Array of item IDs to delete (mem_* for context, task_* for tasks). Type automatically detected from ID prefix.",
+							description: "Array of item IDs to delete (mem_* for context, task_* for tasks, proc_* for processes). Type automatically detected from ID prefix.",
 						},
 					},
 				},

package/tsconfig.json

@@ -15,4 +15,4 @@
   },
   "include": ["**/*.ts"],
   "exclude": ["node_modules", "dist"]
-}
+}