From 63b3fe8ec1c3cba498f1598b8e2b5060cf3cebb3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Barros?= <augustoj311@gmail.com>
Date: Mon, 13 Apr 2026 19:49:01 -0300
Subject: [PATCH] fix: update README, remove emojis, add to main README, use
 npx in config

---
 README.md                            | 23 +++++++++++++++++++++++
 packages/slack-advanced/README.md    | 14 ++++++++------
 packages/slack-advanced/package.json |  4 ++++
 3 files changed, 35 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 869cd4f..e2e63b4 100644
--- a/README.md
+++ b/README.md
@@ -291,6 +291,20 @@ Control Arc Browser on macOS via a hybrid AppleScript + Chrome DevTools Protocol
 - JavaScript execution (AppleScript for quick queries, CDP for async/await)
 - Cookie inspection and page content extraction
 
+### [@arvoretech/slack-advanced-mcp](./packages/slack-advanced)
+
+Advanced Slack integration using user tokens -- messages sent as the authenticated user.
+
+**Features:**
+
+- Fuzzy user search with disk cache (47k+ users load instantly)
+- Smart DM: resolve user by name/email/ID, auto-open DM channel
+- Writing style analysis (emoji usage, punctuation, vocabulary, formality)
+- Thread extraction from Slack URLs with participant resolution
+- Audio transcription via ElevenLabs STT
+- Image download and base64 return for model analysis
+- Rate limit retry with backoff
+
 ## 🚀 Quick Start
 
 ### Installation
@@ -319,6 +333,7 @@ npm install -g @arvoretech/agent-teams-chat-mcp
 npm install -g @arvoretech/metabase-mcp
 npm install -g @arvoretech/mgc-mcp
 npm install -g @arvoretech/kanban-mcp
+npm install -g @arvoretech/slack-advanced-mcp
 ```
 
 Or using pnpm:
@@ -492,6 +507,14 @@ Add to your Claude Desktop configuration file:
         "KANBAN_UI": "true",
         "KANBAN_PORT": "4799"
       }
+    },
+    "slack-advanced": {
+      "command": "npx",
+      "args": ["-y", "@arvoretech/slack-advanced-mcp"],
+      "env": {
+        "SLACK_USER_TOKEN": "xoxp-your-user-token",
+        "ELEVENLABS_API_KEY": "sk_your-elevenlabs-key"
+      }
     }
   }
 }
diff --git a/packages/slack-advanced/README.md b/packages/slack-advanced/README.md
index 34e2bae..fc26b8d 100644
--- a/packages/slack-advanced/README.md
+++ b/packages/slack-advanced/README.md
@@ -1,6 +1,6 @@
 # @arvoretech/slack-advanced-mcp
 
-Advanced Slack MCP Server — sends messages as the authenticated user, with fuzzy user search, smart DMs, writing style analysis, thread extraction, audio transcription (ElevenLabs), and image analysis.
+Advanced Slack MCP Server -- sends messages as the authenticated user, with fuzzy user search, smart DMs, writing style analysis, thread extraction, audio transcription (ElevenLabs), and image analysis.
 
 ## Setup
 
@@ -8,8 +8,10 @@ Advanced Slack MCP Server — sends messages as the authenticated user, with fuz
 
 | Variable | Required | Description |
 |---|---|---|
-| `SLACK_USER_TOKEN` | ✅ | Slack user OAuth token (`xoxp-...`) |
-| `ELEVENLABS_API_KEY` | ❌ | ElevenLabs API key for audio transcription |
+| `SLACK_USER_TOKEN` | Yes | Slack user OAuth token (`xoxp-...`) |
+| `ELEVENLABS_API_KEY` | No | ElevenLabs API key for audio transcription |
+| `SLACK_USERS_CACHE_PATH` | No | Path to users cache JSON (default: `~/.slack-advanced-mcp/users_cache.json`) |
+| `SLACK_USERS_CACHE_TTL_MINUTES` | No | Cache TTL in minutes (default: 240) |
 
 ### Slack App Scopes (User Token Scopes)
 
@@ -21,8 +23,8 @@ Advanced Slack MCP Server — sends messages as the authenticated user, with fuz
 {
   "mcpServers": {
     "slack-advanced": {
-      "command": "node",
-      "args": ["./arvore-mcp-servers/packages/slack-advanced/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "@arvoretech/slack-advanced-mcp"],
       "env": {
         "SLACK_USER_TOKEN": "xoxp-...",
         "ELEVENLABS_API_KEY": "sk_..."
@@ -36,7 +38,7 @@ Advanced Slack MCP Server — sends messages as the authenticated user, with fuz
 
 | Tool | Description |
 |---|---|
-| `search_users` | Fuzzy search users by name, email, or display name |
+| `search_users` | Fuzzy search users by name, email, or display name with disk cache |
 | `get_user_profile` | Full user profile (title, status, timezone, avatar) |
 | `send_dm` | Send DM resolving user by name/email/ID. Messages sent as you |
 | `get_dm_history` | DM history with a user, with pagination |
diff --git a/packages/slack-advanced/package.json b/packages/slack-advanced/package.json
index 57680e1..f238ebd 100644
--- a/packages/slack-advanced/package.json
+++ b/packages/slack-advanced/package.json
@@ -4,6 +4,10 @@
   "description": "Advanced Slack MCP Server with semantic user search, smart DMs, style analysis, thread extraction, audio transcription, and image analysis",
   "main": "dist/index.js",
   "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "publishConfig": {
     "access": "public"
   },