@intangle/mcp-server 1.0.1 → 1.0.3

package/README.md

@@ -8,17 +8,19 @@ Intangle is an AI memory system that gives Claude and other AI assistants persis
 
 **Important: You need an Intangle account to use this MCP server. Sign up at [intangle.app](https://intangle.app)**
 
-## Installation
-
-```bash
-npm install -g @intangle/mcp-server
-```
-
 ## Setup
 
 1. **Create an Intangle account** at [intangle.app](https://intangle.app) and get your API key from Settings → Connect
 
-2. **Configure Claude Desktop** by adding to your `claude_desktop_config.json`:
+2. **Configure Provider Access ** 
+
+Claude code by running the command below (recommend "-s" user for global across projects):
+
+```bash
+claude mcp add intangle -s user --env MCP_API_KEY=<your-api-key-here> --env NEXT_APP_URL=https://intangle.app -- npx -y @intangle/mcp-server
+```
+
+Standard MCP (Claude desktop, Cursor): by adding to your `claude_desktop_config.json` or `mcp.json`:
 
 ```json
 {

package/dist/index.js

@@ -184,6 +184,160 @@ const TOOLS = [
             required: ["space_id"],
         },
     },
+    {
+        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.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "Space to start (e.g., 'renvoi', 'personal')",
+                },
+            },
+            required: ["space_id"],
+        },
+    },
+    {
+        name: "add_task",
+        description: "Create a task in your space with status tracking. Tasks have graph relationships like memories (entities, topics, temporal). REQUIRES space_id parameter.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "REQUIRED: Space to create task in (use list_spaces to see available options)",
+                },
+                title: {
+                    type: "string",
+                    description: "Task title/summary",
+                },
+                content: {
+                    type: "string",
+                    description: "Detailed task description",
+                },
+                topics: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional topics/tags for organization",
+                },
+                status: {
+                    type: "string",
+                    enum: ["pending", "in_progress", "completed", "invalidated"],
+                    description: "Task status (default: pending)",
+                    default: "pending",
+                },
+                parent_id: {
+                    type: "string",
+                    description: "Optional parent task ID to create this as a subtask",
+                },
+            },
+            required: ["space_id", "title", "content"],
+        },
+    },
+    {
+        name: "update_task_status",
+        description: "Change a task's status (pending/in_progress/completed/invalidated)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_id: {
+                    type: "string",
+                    description: "Task ID to update",
+                },
+                status: {
+                    type: "string",
+                    enum: ["pending", "in_progress", "completed", "invalidated"],
+                    description: "New status",
+                },
+            },
+            required: ["task_id", "status"],
+        },
+    },
+    {
+        name: "update_task",
+        description: "Update task title, content, or topics",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_id: {
+                    type: "string",
+                    description: "Task ID to update",
+                },
+                title: {
+                    type: "string",
+                    description: "New title (optional)",
+                },
+                content: {
+                    type: "string",
+                    description: "New content (optional)",
+                },
+                topics: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "New topics array (optional)",
+                },
+            },
+            required: ["task_id"],
+        },
+    },
+    {
+        name: "list_tasks",
+        description: "List tasks in a space with optional filtering",
+        inputSchema: {
+            type: "object",
+            properties: {
+                space_id: {
+                    type: "string",
+                    description: "Space to list tasks from",
+                },
+                status: {
+                    type: "string",
+                    enum: ["pending", "in_progress", "completed", "invalidated"],
+                    description: "Optional: Filter by status",
+                },
+                topics: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional: Filter by topics",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum number of tasks to return",
+                    default: 50,
+                },
+            },
+            required: ["space_id"],
+        },
+    },
+    {
+        name: "delete_task",
+        description: "Delete a task and its relationships",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_id: {
+                    type: "string",
+                    description: "ID of task to delete",
+                },
+            },
+            required: ["task_id"],
+        },
+    },
+    {
+        name: "list_subtasks",
+        description: "Get all subtasks of a parent task",
+        inputSchema: {
+            type: "object",
+            properties: {
+                parent_id: {
+                    type: "string",
+                    description: "Parent task ID",
+                },
+            },
+            required: ["parent_id"],
+        },
+    },
 ];
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: TOOLS,
@@ -243,6 +397,28 @@ async function handleGetSpaceInfo(args) {
     const { space_id } = args;
     return makeApiCall("get-space-info", { space_id });
 }
+async function handleStart(args) {
+    const { space_id } = args;
+    return makeApiCall("start", { space_id });
+}
+async function handleAddTask(args) {
+    return makeApiCall("add-task", args);
+}
+async function handleUpdateTaskStatus(args) {
+    return makeApiCall("update-task-status", args);
+}
+async function handleUpdateTask(args) {
+    return makeApiCall("update-task", args);
+}
+async function handleListTasks(args) {
+    return makeApiCall("list-tasks", args);
+}
+async function handleDeleteTask(args) {
+    return makeApiCall("delete-task", args);
+}
+async function handleListSubtasks(args) {
+    return makeApiCall("list-subtasks", args);
+}
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     try {
@@ -272,6 +448,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "get_space_info":
                 result = await handleGetSpaceInfo(args);
                 break;
+            case "start":
+                result = await handleStart(args);
+                break;
+            case "add_task":
+                result = await handleAddTask(args);
+                break;
+            case "update_task_status":
+                result = await handleUpdateTaskStatus(args);
+                break;
+            case "update_task":
+                result = await handleUpdateTask(args);
+                break;
+            case "list_tasks":
+                result = await handleListTasks(args);
+                break;
+            case "delete_task":
+                result = await handleDeleteTask(args);
+                break;
+            case "list_subtasks":
+                result = await handleListSubtasks(args);
+                break;
             default:
                 throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
         }

package/index.ts

@@ -217,6 +217,163 @@ const TOOLS = [
 			required: ["space_id"],
 		},
 	},
+	{
+		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.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				space_id: {
+					type: "string",
+					description: "Space to start (e.g., 'renvoi', 'personal')",
+				},
+			},
+			required: ["space_id"],
+		},
+	},
+	{
+		name: "add_task",
+		description:
+			"Create a task in your space with status tracking. Tasks have graph relationships like memories (entities, topics, temporal). REQUIRES space_id parameter.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				space_id: {
+					type: "string",
+					description:
+						"REQUIRED: Space to create task in (use list_spaces to see available options)",
+				},
+				title: {
+					type: "string",
+					description: "Task title/summary",
+				},
+				content: {
+					type: "string",
+					description: "Detailed task description",
+				},
+				topics: {
+					type: "array",
+					items: { type: "string" },
+					description: "Optional topics/tags for organization",
+				},
+				status: {
+					type: "string",
+					enum: ["pending", "in_progress", "completed", "invalidated"],
+					description: "Task status (default: pending)",
+					default: "pending",
+				},
+				parent_id: {
+					type: "string",
+					description: "Optional parent task ID to create this as a subtask",
+				},
+			},
+			required: ["space_id", "title", "content"],
+		},
+	},
+	{
+		name: "update_task_status",
+		description: "Change a task's status (pending/in_progress/completed/invalidated)",
+		inputSchema: {
+			type: "object",
+			properties: {
+				task_id: {
+					type: "string",
+					description: "Task ID to update",
+				},
+				status: {
+					type: "string",
+					enum: ["pending", "in_progress", "completed", "invalidated"],
+					description: "New status",
+				},
+			},
+			required: ["task_id", "status"],
+		},
+	},
+	{
+		name: "update_task",
+		description: "Update task title, content, or topics",
+		inputSchema: {
+			type: "object",
+			properties: {
+				task_id: {
+					type: "string",
+					description: "Task ID to update",
+				},
+				title: {
+					type: "string",
+					description: "New title (optional)",
+				},
+				content: {
+					type: "string",
+					description: "New content (optional)",
+				},
+				topics: {
+					type: "array",
+					items: { type: "string" },
+					description: "New topics array (optional)",
+				},
+			},
+			required: ["task_id"],
+		},
+	},
+	{
+		name: "list_tasks",
+		description: "List tasks in a space with optional filtering",
+		inputSchema: {
+			type: "object",
+			properties: {
+				space_id: {
+					type: "string",
+					description: "Space to list tasks from",
+				},
+				status: {
+					type: "string",
+					enum: ["pending", "in_progress", "completed", "invalidated"],
+					description: "Optional: Filter by status",
+				},
+				topics: {
+					type: "array",
+					items: { type: "string" },
+					description: "Optional: Filter by topics",
+				},
+				limit: {
+					type: "number",
+					description: "Maximum number of tasks to return",
+					default: 50,
+				},
+			},
+			required: ["space_id"],
+		},
+	},
+	{
+		name: "delete_task",
+		description: "Delete a task and its relationships",
+		inputSchema: {
+			type: "object",
+			properties: {
+				task_id: {
+					type: "string",
+					description: "ID of task to delete",
+				},
+			},
+			required: ["task_id"],
+		},
+	},
+	{
+		name: "list_subtasks",
+		description: "Get all subtasks of a parent task",
+		inputSchema: {
+			type: "object",
+			properties: {
+				parent_id: {
+					type: "string",
+					description: "Parent task ID",
+				},
+			},
+			required: ["parent_id"],
+		},
+	},
 ];
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -321,6 +478,35 @@ async function handleGetSpaceInfo(args: any) {
 	return makeApiCall("get-space-info", { space_id });
 }
 
+async function handleStart(args: any) {
+	const { space_id } = args as { space_id: string };
+	return makeApiCall("start", { space_id });
+}
+
+async function handleAddTask(args: any) {
+	return makeApiCall("add-task", args);
+}
+
+async function handleUpdateTaskStatus(args: any) {
+	return makeApiCall("update-task-status", args);
+}
+
+async function handleUpdateTask(args: any) {
+	return makeApiCall("update-task", args);
+}
+
+async function handleListTasks(args: any) {
+	return makeApiCall("list-tasks", args);
+}
+
+async function handleDeleteTask(args: any) {
+	return makeApiCall("delete-task", args);
+}
+
+async function handleListSubtasks(args: any) {
+	return makeApiCall("list-subtasks", args);
+}
+
 server.setRequestHandler(CallToolRequestSchema, async (request: any) => {
 	const { name, arguments: args } = request.params;
 
@@ -352,6 +538,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request: any) => {
 			case "get_space_info":
 				result = await handleGetSpaceInfo(args);
 				break;
+			case "start":
+				result = await handleStart(args);
+				break;
+			case "add_task":
+				result = await handleAddTask(args);
+				break;
+			case "update_task_status":
+				result = await handleUpdateTaskStatus(args);
+				break;
+			case "update_task":
+				result = await handleUpdateTask(args);
+				break;
+			case "list_tasks":
+				result = await handleListTasks(args);
+				break;
+			case "delete_task":
+				result = await handleDeleteTask(args);
+				break;
+			case "list_subtasks":
+				result = await handleListSubtasks(args);
+				break;
 			default:
 				throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
 		}

package/package.json

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