@jtalk22/slack-mcp 1.1.9 → 1.2.1

package/lib/tools.js

@@ -2,6 +2,7 @@
  * MCP Tool Definitions
  *
  * All Slack MCP tools in one place for easy maintenance.
+ * Includes MCP annotations for better tool discovery and safety hints.
  */
 
 export const TOOLS = [
@@ -11,6 +12,12 @@ export const TOOLS = [
     inputSchema: {
       type: "object",
       properties: {}
+    },
+    annotations: {
+      title: "Token Status",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
     }
   },
   {
@@ -19,6 +26,12 @@ export const TOOLS = [
     inputSchema: {
       type: "object",
       properties: {}
+    },
+    annotations: {
+      title: "Health Check",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true
     }
   },
   {
@@ -27,6 +40,13 @@ export const TOOLS = [
     inputSchema: {
       type: "object",
       properties: {}
+    },
+    annotations: {
+      title: "Refresh Tokens",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
     }
   },
   {
@@ -49,6 +69,12 @@ export const TOOLS = [
           description: "If true, actively discover all DMs (slower, may hit rate limits on large workspaces). Default false uses cached DMs."
         }
       }
+    },
+    annotations: {
+      title: "List Conversations",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true
     }
   },
   {
@@ -79,6 +105,12 @@ export const TOOLS = [
         }
       },
       required: ["channel_id"]
+    },
+    annotations: {
+      title: "Conversation History",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true
     }
   },
   {
@@ -113,6 +145,12 @@ export const TOOLS = [
         }
       },
       required: ["channel_id"]
+    },
+    annotations: {
+      title: "Full Conversation Export",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true
     }
   },
   {
@@ -131,6 +169,12 @@ export const TOOLS = [
         }
       },
       required: ["query"]
+    },
+    annotations: {
+      title: "Search Messages",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true
     }
   },
   {
@@ -145,6 +189,12 @@ export const TOOLS = [
         }
       },
       required: ["user_id"]
+    },
+    annotations: {
+      title: "User Info",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true
     }
   },
   {
@@ -167,6 +217,13 @@ export const TOOLS = [
         }
       },
       required: ["channel_id", "text"]
+    },
+    annotations: {
+      title: "Send Message",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
     }
   },
   {
@@ -185,6 +242,12 @@ export const TOOLS = [
         }
       },
       required: ["channel_id", "thread_ts"]
+    },
+    annotations: {
+      title: "Get Thread",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true
     }
   },
   {
@@ -198,6 +261,12 @@ export const TOOLS = [
           description: "Maximum users to return (default 500, supports pagination)"
         }
       }
+    },
+    annotations: {
+      title: "List Users",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true
     }
   }
 ];

package/package.json

@@ -1,23 +1,28 @@
 {
   "name": "@jtalk22/slack-mcp",
   "mcpName": "io.github.jtalk22/slack-mcp-server",
-  "version": "1.1.9",
+  "version": "1.2.1",
   "description": "Full Slack access for Claude - DMs, channels, search. No OAuth. No admin approval. Just works.",
   "type": "module",
   "main": "src/server.js",
   "bin": {
+    "slack-mcp": "./src/cli.js",
     "slack-mcp-server": "./src/server.js",
     "slack-mcp-http": "./src/server-http.js",
-    "slack-mcp-web": "./src/web-server.js"
+    "slack-mcp-web": "./src/web-server.js",
+    "slack-mcp-setup": "./scripts/setup-wizard.js"
   },
   "scripts": {
     "start": "node src/server.js",
     "http": "node src/server-http.js",
     "web": "node src/web-server.js",
+    "setup": "node scripts/setup-wizard.js --setup",
     "tokens:status": "node scripts/token-cli.js status",
     "tokens:refresh": "node scripts/token-cli.js refresh",
     "tokens:auto": "node scripts/token-cli.js auto",
-    "tokens:clear": "node scripts/token-cli.js clear"
+    "tokens:clear": "node scripts/token-cli.js clear",
+    "screenshot": "node scripts/capture-screenshots.js",
+    "record-demo": "node scripts/record-demo.js"
   },
   "keywords": [
     "mcp",
@@ -81,10 +86,10 @@
     "url": "https://github.com/jtalk22/slack-mcp-server/issues"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.27.0",
     "express": "^4.18.2"
   },
   "files": [