@intangle/mcp-server 2.6.5 → 2.6.6

package/dist/tool-definitions.js

@@ -39,7 +39,7 @@ const TOOL_DEFINITIONS = [
     {
         name: "fetch_items",
         title: "Fetch Items by ID",
-        description: "Retrieve full content for specific items by ID. Accepts single ID or array of IDs.",
+        description: "Retrieve full content for specific items by ID, including `artifact_*` and `summary_*` ids. Artifact fetches return content plus render metadata and `config`/`state`/`data` when available.",
         inputSchema: {
             type: "object",
             properties: {
@@ -49,16 +49,17 @@ const TOOL_DEFINITIONS = [
                 },
                 id: {
                     type: "string",
-                    description: "Single ID to fetch (context or task ID like 'mem_123' or 'task_456' or 'skill_789')"
+                    description: "Single ID to fetch (e.g. `mem_123`, `task_456`, `skill_789`, `doc_321`, `artifact_654`, or `summary_987`)."
                 },
                 ids: {
                     type: "array",
                     items: { type: "string" },
-                    description: "Array of IDs to fetch (mix of context, task, and skill IDs). Use this to fetch multiple items in one call."
+                    description: "Array of IDs to fetch (mix of context, task, skill, document, artifact, insight, or conversation IDs). Use this to fetch multiple items in one call."
                 }
             }
         }
     },
+    { name: "read_artifact", title: "Read Artifact", description: "Read one existing artifact by `artifact_id` without asking Tan to restream it in chat. Returns content plus render metadata and `config`/`state`/`data` when available. Prefer this when an external agent already has the artifact id and needs the current artifact payload directly.", inputSchema: { type: "object", properties: { space_id: { type: "string", description: "Optional: Space containing the artifact. Provide this for shared/org spaces so access checks resolve against the correct graph." }, artifact_id: { type: "string", description: "REQUIRED: Existing artifact ID to read (e.g. `artifact_123`)." }, item_id: { type: "string", description: "Optional alias for `artifact_id`." }, organization_id: { type: "string", description: "Optional Clerk org ID when the space belongs to an organization graph." } }, required: ["artifact_id"] } },
     {
         name: "usage_status",
         title: "Usage Status",
@@ -841,6 +842,7 @@ const TOOL_DEFINITIONS = [
 const READ_ONLY_TOOLS = new Set([
     "search",
     "fetch_items",
+    "read_artifact",
     "usage_status",
     "fetch_conversation_messages",
     "list_conversation_inbox",
@@ -856,6 +858,7 @@ const DESTRUCTIVE_TOOLS = new Set([
 const IDEMPOTENT_TOOLS = new Set([
     "search",
     "fetch_items",
+    "read_artifact",
     "usage_status",
     "fetch_conversation_messages",
     "list_conversation_inbox",

package/package.json

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

package/tool-definitions.ts

@@ -46,7 +46,7 @@ const TOOL_DEFINITIONS = [
     name: "fetch_items",
     title: "Fetch Items by ID",
     description:
-      "Retrieve full content for specific items by ID. Accepts single ID or array of IDs.",
+      "Retrieve full content for specific items by ID, including `artifact_*` and `summary_*` ids. Artifact fetches return content plus render metadata and `config`/`state`/`data` when available.",
     inputSchema: {
       type: "object",
       properties: {
@@ -58,17 +58,18 @@ const TOOL_DEFINITIONS = [
         id: {
           type: "string",
           description:
-            "Single ID to fetch (context or task ID like 'mem_123' or 'task_456' or 'skill_789')"
+            "Single ID to fetch (e.g. `mem_123`, `task_456`, `skill_789`, `doc_321`, `artifact_654`, or `summary_987`)."
         },
         ids: {
           type: "array",
           items: { type: "string" },
           description:
-            "Array of IDs to fetch (mix of context, task, and skill IDs). Use this to fetch multiple items in one call."
+            "Array of IDs to fetch (mix of context, task, skill, document, artifact, insight, or conversation IDs). Use this to fetch multiple items in one call."
         }
       }
     }
   },
+  { name: "read_artifact", title: "Read Artifact", description: "Read one existing artifact by `artifact_id` without asking Tan to restream it in chat. Returns content plus render metadata and `config`/`state`/`data` when available. Prefer this when an external agent already has the artifact id and needs the current artifact payload directly.", inputSchema: { type: "object", properties: { space_id: { type: "string", description: "Optional: Space containing the artifact. Provide this for shared/org spaces so access checks resolve against the correct graph." }, artifact_id: { type: "string", description: "REQUIRED: Existing artifact ID to read (e.g. `artifact_123`)." }, item_id: { type: "string", description: "Optional alias for `artifact_id`." }, organization_id: { type: "string", description: "Optional Clerk org ID when the space belongs to an organization graph." } }, required: ["artifact_id"] } },
   {
     name: "usage_status",
     title: "Usage Status",
@@ -941,6 +942,7 @@ const TOOL_DEFINITIONS = [
 const READ_ONLY_TOOLS = new Set([
   "search",
   "fetch_items",
+  "read_artifact",
   "usage_status",
   "fetch_conversation_messages",
   "list_conversation_inbox",
@@ -958,6 +960,7 @@ const DESTRUCTIVE_TOOLS = new Set([
 const IDEMPOTENT_TOOLS = new Set([
   "search",
   "fetch_items",
+  "read_artifact",
   "usage_status",
   "fetch_conversation_messages",
   "list_conversation_inbox",