@intangle/mcp-server 2.5.4 → 2.5.5

package/dist/index.js

@@ -7,7 +7,7 @@ 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 { CallToolRequestSchema, ErrorCode, ListResourceTemplatesRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, McpError, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { config } from "dotenv";
 import fetch from "node-fetch";
 import { TOOLS } from "./tool-definitions.js";
@@ -101,6 +101,13 @@ try {
         }
         return url.toString();
     }
+    function buildRemoteApiUrl() {
+        const url = new URL("/api/mcp-remote", API_BASE_URL);
+        if (VERCEL_BYPASS_TOKEN) {
+            url.searchParams.set("x-vercel-protection-bypass", VERCEL_BYPASS_TOKEN);
+        }
+        return url.toString();
+    }
     async function makeApiCall(endpoint, data, timeoutMs) {
         // Ensure we have client info before making requests
         ensureClientInfo();
@@ -160,6 +167,57 @@ try {
             clearTimeout(timeoutId);
         }
     }
+    async function makeRemoteRpcCall(method, params) {
+        ensureClientInfo();
+        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)",
+        };
+        if (mcpClientName) {
+            headers["X-MCP-Client-Name"] = mcpClientName;
+        }
+        if (mcpClientVersion) {
+            headers["X-MCP-Client-Version"] = mcpClientVersion;
+        }
+        if (VERCEL_BYPASS_TOKEN) {
+            headers["x-vercel-protection-bypass"] = VERCEL_BYPASS_TOKEN;
+        }
+        const requestId = Date.now();
+        const rpcBody = {
+            jsonrpc: "2.0",
+            id: requestId,
+            method,
+            params,
+        };
+        const response = await fetch(buildRemoteApiUrl(), {
+            method: "POST",
+            headers,
+            body: JSON.stringify(rpcBody),
+        });
+        const responseText = await response.text();
+        let responseJson = {};
+        try {
+            responseJson = responseText ? JSON.parse(responseText) : {};
+        }
+        catch {
+            throw new Error(`Failed to parse MCP remote ${method} response`);
+        }
+        if (!response.ok) {
+            const message = responseJson?.error?.message ||
+                responseJson?.message ||
+                `${response.status} ${response.statusText}`;
+            throw new Error(`MCP remote ${method} failed: ${message}`);
+        }
+        if (responseJson?.error) {
+            const code = responseJson.error.code;
+            const message = responseJson.error.message || "Unknown MCP remote error";
+            throw new Error(`MCP remote ${method} error (${code}): ${message}`);
+        }
+        return responseJson?.result ?? {};
+    }
     const server = new Server({
         name: "intangle-context",
         version: "1.0.0",
@@ -171,12 +229,33 @@ try {
         ],
     }, {
         capabilities: {
+            resources: {},
             tools: {},
         },
     });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: TOOLS,
     }));
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        const result = await makeRemoteRpcCall("resources/list", {});
+        return {
+            resources: Array.isArray(result?.resources) ? result.resources : [],
+            nextCursor: typeof result?.nextCursor === "string" ? result.nextCursor : undefined,
+        };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const uri = request?.params?.uri;
+        if (!uri || typeof uri !== "string") {
+            throw new McpError(ErrorCode.InvalidParams, "uri is required for resources/read");
+        }
+        const result = await makeRemoteRpcCall("resources/read", { uri });
+        return {
+            contents: Array.isArray(result?.contents) ? result.contents : [],
+        };
+    });
+    server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({
+        resourceTemplates: [],
+    }));
     async function handleSearchContext(args) {
         const { space_id, query, topics } = args;
         // Require space_id

package/dist/tool-definitions.js

@@ -312,7 +312,7 @@ export const TOOLS = [
     {
         name: "message",
         title: "Message Assistant",
-        description: "Send a user message to the Intangle assistant and wait for one assistant turn to complete. Returns assistant text, stop reason, session_id, and conversation_id for continuity.",
+        description: "Primary orchestration tool. Send a request to the Intangle assistant and wait for one assistant turn to complete. Returns assistant text plus continuity IDs (`session_id`, `conversation_id`) so callers can continue the same thread reliably across turns.",
         inputSchema: {
             type: "object",
             properties: {
@@ -330,11 +330,11 @@ export const TOOLS = [
                 },
                 conversation_id: {
                     type: "string",
-                    description: "Optional existing conversation/chat summary ID to resume continuity."
+                    description: "Optional existing conversation/chat summary ID to resume a specific conversation. If omitted, Intangle uses/creates the active conversation for this space."
                 },
                 session_id: {
                     type: "string",
-                    description: "Optional runtime session ID to reuse across multiple message calls."
+                    description: "Optional runtime session ID to reuse across calls. Reuse the returned session_id for best continuity and lower warm-up overhead."
                 },
                 project_id: {
                     type: "string",
@@ -355,7 +355,7 @@ export const TOOLS = [
             },
             required: ["space_id", "content"]
         }
-    },
+    }
     // DISABLED: memory_action tool is broken and causing errors.
     // Pending OHM protocol fix. Use update_space, search, or fetch_items instead.
     // {

package/index.ts

@@ -12,8 +12,11 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import {
   CallToolRequestSchema,
   ErrorCode,
+  ListResourceTemplatesRequestSchema,
+  ListResourcesRequestSchema,
   ListToolsRequestSchema,
   McpError,
+  ReadResourceRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js"
 import { config } from "dotenv"
 import fetch from "node-fetch"
@@ -134,6 +137,16 @@ try {
     return url.toString()
   }
 
+  function buildRemoteApiUrl() {
+    const url = new URL("/api/mcp-remote", API_BASE_URL)
+
+    if (VERCEL_BYPASS_TOKEN) {
+      url.searchParams.set("x-vercel-protection-bypass", VERCEL_BYPASS_TOKEN)
+    }
+
+    return url.toString()
+  }
+
   async function makeApiCall(endpoint: string, data: any, timeoutMs?: number) {
     // Ensure we have client info before making requests
     ensureClientInfo()
@@ -187,7 +200,9 @@ try {
           )
         }
 
-        throw new Error(`API call failed: ${response.status} ${response.statusText}`)
+        throw new Error(
+          `API call failed: ${response.status} ${response.statusText}`
+        )
       }
 
       if (responseBody.trim() === "") {
@@ -207,6 +222,70 @@ try {
     }
   }
 
+  async function makeRemoteRpcCall(
+    method: string,
+    params: Record<string, unknown>
+  ) {
+    ensureClientInfo()
+
+    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)",
+    }
+
+    if (mcpClientName) {
+      headers["X-MCP-Client-Name"] = mcpClientName
+    }
+    if (mcpClientVersion) {
+      headers["X-MCP-Client-Version"] = mcpClientVersion
+    }
+    if (VERCEL_BYPASS_TOKEN) {
+      headers["x-vercel-protection-bypass"] = VERCEL_BYPASS_TOKEN
+    }
+
+    const requestId = Date.now()
+    const rpcBody = {
+      jsonrpc: "2.0",
+      id: requestId,
+      method,
+      params,
+    }
+
+    const response = await fetch(buildRemoteApiUrl(), {
+      method: "POST",
+      headers,
+      body: JSON.stringify(rpcBody),
+    })
+
+    const responseText = await response.text()
+    let responseJson: any = {}
+
+    try {
+      responseJson = responseText ? JSON.parse(responseText) : {}
+    } catch {
+      throw new Error(`Failed to parse MCP remote ${method} response`)
+    }
+
+    if (!response.ok) {
+      const message =
+        responseJson?.error?.message ||
+        responseJson?.message ||
+        `${response.status} ${response.statusText}`
+      throw new Error(`MCP remote ${method} failed: ${message}`)
+    }
+
+    if (responseJson?.error) {
+      const code = responseJson.error.code
+      const message = responseJson.error.message || "Unknown MCP remote error"
+      throw new Error(`MCP remote ${method} error (${code}): ${message}`)
+    }
+
+    return responseJson?.result ?? {}
+  }
+
   const server = new Server(
     {
       name: "intangle-context",
@@ -220,6 +299,7 @@ try {
     },
     {
       capabilities: {
+        resources: {},
         tools: {},
       },
     }
@@ -229,6 +309,34 @@ try {
     tools: TOOLS,
   }))
 
+  server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    const result = await makeRemoteRpcCall("resources/list", {})
+    return {
+      resources: Array.isArray(result?.resources) ? result.resources : [],
+      nextCursor:
+        typeof result?.nextCursor === "string" ? result.nextCursor : undefined,
+    }
+  })
+
+  server.setRequestHandler(ReadResourceRequestSchema, async (request: any) => {
+    const uri = request?.params?.uri
+    if (!uri || typeof uri !== "string") {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        "uri is required for resources/read"
+      )
+    }
+
+    const result = await makeRemoteRpcCall("resources/read", { uri })
+    return {
+      contents: Array.isArray(result?.contents) ? result.contents : [],
+    }
+  })
+
+  server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({
+    resourceTemplates: [],
+  }))
+
   async function handleSearchContext(args: any) {
     const { space_id, query, topics } = args as {
       space_id: string
@@ -278,11 +386,15 @@ try {
     }
 
     if (!project_id && !slug) {
-      throw new Error("Either project_id or slug (with space_id) is required. Use view_projects to get valid IDs.")
+      throw new Error(
+        "Either project_id or slug (with space_id) is required. Use view_projects to get valid IDs."
+      )
     }
 
     if (slug && !space_id) {
-      throw new Error("space_id is required when using slug. Use view_spaces to see available options.")
+      throw new Error(
+        "space_id is required when using slug. Use view_spaces to see available options."
+      )
     }
 
     return makeApiCall("view-project", { project_id, space_id, slug })
@@ -310,9 +422,7 @@ try {
     }
 
     if (!args.add && !args.update && !args.delete) {
-      throw new Error(
-        "At least one operation must be provided"
-      )
+      throw new Error("At least one operation must be provided")
     }
 
     // Ensure all add items have a type field to prevent classification timeout
@@ -320,7 +430,9 @@ try {
     if (add?.items && Array.isArray(add.items)) {
       for (const item of add.items) {
         if (!item.type) {
-          log(`WARNING: Item "${item.title}" missing type field, defaulting to "context" to prevent classification timeout`)
+          log(
+            `WARNING: Item "${item.title}" missing type field, defaulting to "context" to prevent classification timeout`
+          )
           item.type = "context"
         }
       }

package/package.json

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

package/tool-definitions.ts

@@ -346,7 +346,7 @@ export const TOOLS = [
     name: "message",
     title: "Message Assistant",
     description:
-      "Send a user message to the Intangle assistant and wait for one assistant turn to complete. Returns assistant text, stop reason, session_id, and conversation_id for continuity.",
+      "Primary orchestration tool. Send a request to the Intangle assistant and wait for one assistant turn to complete. Returns assistant text plus continuity IDs (`session_id`, `conversation_id`) so callers can continue the same thread reliably across turns.",
     inputSchema: {
       type: "object",
       properties: {
@@ -366,12 +366,12 @@ export const TOOLS = [
         conversation_id: {
           type: "string",
           description:
-            "Optional existing conversation/chat summary ID to resume continuity."
+            "Optional existing conversation/chat summary ID to resume a specific conversation. If omitted, Intangle uses/creates the active conversation for this space."
         },
         session_id: {
           type: "string",
           description:
-            "Optional runtime session ID to reuse across multiple message calls."
+            "Optional runtime session ID to reuse across calls. Reuse the returned session_id for best continuity and lower warm-up overhead."
         },
         project_id: {
           type: "string",
@@ -394,7 +394,7 @@ export const TOOLS = [
       },
       required: ["space_id", "content"]
     }
-  },
+  }
   // DISABLED: memory_action tool is broken and causing errors.
   // Pending OHM protocol fix. Use update_space, search, or fetch_items instead.
   // {