@jtalk22/slack-mcp 1.2.1 → 1.2.2

package/README.md

@@ -6,7 +6,7 @@
 
 <p align="center">
   <em>Give Claude the same Slack access you have.<br>
-  DMs, threads, history—no admin approval.</em>
+  DMs, threads, history—using your existing Slack session.</em>
 </p>
 
 <p align="center">
@@ -39,7 +39,7 @@
 
 ### Why This Exists
 
-I built this because I was working with someone to help me manage a complex workload, and we kept hitting walls. They needed context from my messages—"what did X say about Y?"—but Slack's API blocks access to DMs without admin approval.
+I built this because I was working with someone to help me manage a complex workload, and we kept hitting walls. They needed context from my messages—"what did X say about Y?"—and standard app/OAuth flows were too constrained for that workflow.
 
 Screenshotting messages is not a workflow.
 
@@ -100,6 +100,16 @@ Instead of authenticating as a bot, this server leverages your existing Chrome s
 
 **Runtime:** Node.js 20+
 
+### 2-Minute Verify
+
+```bash
+npx -y @jtalk22/slack-mcp --version
+npx -y @jtalk22/slack-mcp --setup
+npx -y @jtalk22/slack-mcp --status
+```
+
+If `--status` returns valid workspace/user info, your install path is working.
+
 ### Option A: npm (Recommended)
 
 ```bash
@@ -131,7 +141,7 @@ docker pull ghcr.io/jtalk22/slack-mcp-server:latest
 The interactive setup wizard handles token extraction and validation automatically:
 
 ```bash
-npx @jtalk22/slack-mcp --setup
+npx -y @jtalk22/slack-mcp --setup
 ```
 
 - **macOS**: Auto-extracts tokens from Chrome (have Slack open in a tab)
@@ -142,7 +152,7 @@ npx @jtalk22/slack-mcp --setup
 #### Check Token Status
 
 ```bash
-npx @jtalk22/slack-mcp --status
+npx -y @jtalk22/slack-mcp --status
 ```
 
 #### Alternative: Manual Token Scripts
@@ -283,14 +293,14 @@ If you're using claude.ai in a browser (which doesn't support MCP), you can use
 
 ```bash
 npm run web
-# Or: npx @jtalk22/slack-mcp web
+# Or: npx -y @jtalk22/slack-mcp web
 ```
 
 **Magic Link:** The console prints a one-click URL with the API key embedded:
 
 ```
 ════════════════════════════════════════════════════════════
-  Slack Web API Server v1.2.1
+  Slack Web API Server v1.2.2
 ════════════════════════════════════════════════════════════
 
   Dashboard: http://localhost:3000/?key=smcp_xxxxxxxxxxxx
@@ -309,6 +319,16 @@ Just click the link - no copy-paste needed. The key is saved to your browser and
 
 ---
 
+## Operations Guides
+
+- [Deployment Modes](docs/DEPLOYMENT-MODES.md) - Choose the right operating model (`stdio`, `web`, hosted HTTP, Smithery/Worker)
+- [Use Case Recipes](docs/USE_CASE_RECIPES.md) - 12 copy/paste prompts mapped to current tool contracts
+- [Support Boundaries](docs/SUPPORT-BOUNDARIES.md) - Scope, response targets, and solo-maintainer capacity limits
+
+If you're evaluating team rollout, start with [Deployment Modes](docs/DEPLOYMENT-MODES.md) before exposing remote endpoints.
+
+---
+
 ## Troubleshooting
 
 ### Tokens Expired

package/docs/COMMUNICATION-STYLE.md

@@ -0,0 +1,58 @@
+# Communication Style Guide
+
+Use this guide for release notes, issue replies, and changelog entries.
+
+## Rules
+
+1. Keep text technical, concise, and factual.
+2. Do not include model/tool credit lines.
+3. Do not include co-author trailers from tooling.
+4. State exact versions and commands when relevant.
+5. Avoid speculative claims.
+
+## Issue Reply Template
+
+```md
+Thanks for reporting this.
+
+Status: fixed in `<version>`.
+
+Included:
+- `<change 1>`
+- `<change 2>`
+
+Install/update:
+- `npx -y @jtalk22/slack-mcp`
+- `npm i -g @jtalk22/slack-mcp@<version>`
+```
+
+## Release Notes Template
+
+````md
+## <version> — <short title>
+
+### Fixed
+- <item>
+- <item>
+
+### Runtime / Security
+- <item>
+
+### Verify
+```bash
+<command>
+<command>
+```
+````
+
+## Changelog Entry Template
+
+```md
+## [<version>] - YYYY-MM-DD
+
+### Fixed
+- <item>
+
+### Changed
+- <item>
+```

package/docs/DEPLOYMENT-MODES.md

@@ -0,0 +1,48 @@
+# Deployment Modes
+
+Use this guide to choose the right operating mode before rollout.
+
+## Quick Chooser
+
+- Choose `stdio` for personal use in Claude Desktop/Claude Code.
+- Choose local `web` for browser workflows and manual Slack browsing.
+- Choose hosted HTTP only when you need remote execution and can handle token operations.
+- Choose Smithery/Worker only when your consumers require registry-hosted MCP transport.
+
+## Mode Matrix
+
+| Mode | Start Command | Best For | Auth Material | Exposure | Notes |
+|------|---------------|----------|---------------|----------|-------|
+| Local MCP (`stdio`) | `npx -y @jtalk22/slack-mcp` | Individual daily usage in Claude | `SLACK_TOKEN` + `SLACK_COOKIE` via token file/env | Local process | Lowest ops burden |
+| Local Web UI (`web`) | `npx -y @jtalk22/slack-mcp web` | Browser-first usage, manual search/send | Same as above + generated API key | `localhost` by default | Useful when MCP is not available |
+| Hosted MCP (`http`) | `node src/server-http.js` | Controlled hosted integration | Env-injected Slack token/cookie | Remote endpoint | Requires runtime hardening and monitoring |
+| Smithery/Worker | `wrangler deploy` + Smithery publish flow | Registry distribution for hosted consumers | Query/env token handoff | Remote endpoint | Keep worker version parity with npm release |
+
+## Team Deployment Guidance
+
+If you are deploying for more than one operator:
+
+1. Start with one maintainer on local `stdio`.
+2. Document token lifecycle and rotation ownership.
+3. Define support window and incident contact before enabling hosted mode.
+4. Validate `/health` and MCP initialize responses on every release.
+
+## Release Checklist by Mode
+
+### Local `stdio`
+
+1. `npx -y @jtalk22/slack-mcp --status`
+2. `npx -y @jtalk22/slack-mcp --help`
+3. Confirm tool list in Claude client.
+
+### Local `web`
+
+1. `npx -y @jtalk22/slack-mcp web`
+2. Verify API key generation at `~/.slack-mcp-api-key`.
+3. Verify `/health`, `/conversations`, and `/search` endpoints.
+
+### Hosted (`http` or Worker)
+
+1. Verify `version` parity across `package.json`, server metadata, and health responses.
+2. Confirm `slack_get_thread`, `slack_search_messages`, and `slack_users_info` behavior.
+3. Confirm token handling mode (ephemeral vs env persistence) is documented.

package/docs/SETUP.md

@@ -25,16 +25,22 @@ npm install
 
 ### 3. Get Slack Tokens
 
-**Option A: Automatic Extraction**
+**Option A: Setup Wizard (recommended)**
 
 1. Open Chrome
 2. Navigate to https://app.slack.com and log in
 3. Run:
    ```bash
-   npm run tokens:auto
+   npx -y @jtalk22/slack-mcp --setup
    ```
 
-**Option B: Manual Extraction**
+**Option B: Automatic Extraction (repo clone workflow)**
+
+```bash
+npm run tokens:auto
+```
+
+**Option C: Manual Extraction**
 
 1. Open https://app.slack.com in Chrome
 2. Press F12 to open DevTools
@@ -114,7 +120,7 @@ You should see your username and team name.
 
 ### "No credentials found"
 
-Run `npm run tokens:auto` with Slack open in Chrome, or `npm run tokens:refresh` to enter manually.
+Run `npx -y @jtalk22/slack-mcp --setup` with Slack open in Chrome, or `npm run tokens:refresh` to enter manually.
 
 ### "invalid_auth" Error
 

package/docs/SUPPORT-BOUNDARIES.md

@@ -0,0 +1,49 @@
+# Support Boundaries
+
+This document sets expectations for issue triage, support scope, and rollout safety.
+
+## In Scope
+
+- Reproducible bugs in published release behavior.
+- Install and setup blockers for supported Node/runtime paths.
+- Regressions in existing tools (`slack_get_thread`, `slack_search_messages`, etc.).
+- Documentation corrections with clear technical evidence.
+
+## Out of Scope
+
+- Custom Slack policy/legal interpretation for a specific organization.
+- Workspace-specific data migrations or bespoke integrations.
+- Real-time operational support for third-party hosting providers.
+- Urgent production incident ownership for self-hosted external deployments.
+
+## Intake Requirements
+
+Include the following in every issue:
+
+1. Version (`npm view @jtalk22/slack-mcp version` output).
+2. Runtime mode (`stdio`, `web`, `http`, or Worker/Smithery).
+3. OS and Node version.
+4. Minimal reproduction steps and exact error text.
+5. Whether this blocks individual use or team rollout.
+
+## Response Windows (Best Effort)
+
+- Installation/blocker bugs: initial response target within 2 business days.
+- Non-blocking bugs: initial response target within 5 business days.
+- Feature requests: triaged in backlog batches.
+
+## Solo Maintainer Capacity Guardrail
+
+- Weekly support budget target: <= 2 hours/week.
+- If inbound support exceeds this cap, new feature work may be paused.
+- High-context requests may be deferred until reproducible artifacts are provided.
+
+## Security and Data Handling
+
+- Do not post raw tokens/cookies in issues.
+- Use redacted logs.
+- If credentials are exposed, rotate immediately and update issue with redaction.
+
+## Deployment Escalation Rule
+
+For team/hosted usage, open a deployment intake issue before broad rollout.

package/docs/TROUBLESHOOTING.md

@@ -54,10 +54,13 @@ slack_list_conversations limit=50
 # Option 1: In Claude Code/Desktop
 slack_refresh_tokens
 
-# Option 2: CLI
+# Option 2: Package setup wizard
+npx -y @jtalk22/slack-mcp --setup
+
+# Option 3: Repo CLI
 npm run tokens:auto
 
-# Option 3: Manual
+# Option 4: Manual
 npm run tokens:refresh
 ```
 

package/docs/USE_CASE_RECIPES.md

@@ -0,0 +1,69 @@
+# Use Case Recipes
+
+Copy and paste any prompt into your MCP client. Each recipe maps to existing tools and parameters.
+
+## 1) Fast Health Check
+
+Prompt:
+`Run slack_health_check and tell me if my workspace connection is valid.`
+
+## 2) Token Age and Cache Snapshot
+
+Prompt:
+`Run slack_token_status and summarize token age, health, and cache stats.`
+
+## 3) List Recent DMs
+
+Prompt:
+`Use slack_list_conversations with types="im,mpim" and limit=50. Return names and IDs.`
+
+## 4) Summarize a Channel for the Last 3 Days
+
+Prompt:
+`Use slack_conversations_history with channel_id="<CHANNEL_ID>", oldest="<UNIX_TS_3_DAYS_AGO>", limit=100, resolve_users=true, then summarize decisions and action items.`
+
+## 5) Pull a Full Thread
+
+Prompt:
+`Use slack_get_thread with channel_id="<CHANNEL_ID>" and thread_ts="<THREAD_TS>". Summarize timeline and owners.`
+
+## 6) Search for Decisions
+
+Prompt:
+`Use slack_search_messages with query="decision OR approved after:2026-01-01" and count=50. Group results by channel.`
+
+## 7) Find Messages from One Person
+
+Prompt:
+`Use slack_search_messages with query="from:@<USERNAME> after:2026-01-01" and count=30. Return top themes.`
+
+## 8) Export Conversation History
+
+Prompt:
+`Use slack_get_full_conversation with channel_id="<CHANNEL_ID>", max_messages=2000, include_threads=true, output_file="q1-export.json".`
+
+## 9) Lookup a User Profile
+
+Prompt:
+`Use slack_users_info with user_id="<USER_ID>" and return role, timezone, and status fields.`
+
+## 10) Send a Channel Update
+
+Prompt:
+`Use slack_send_message with channel_id="<CHANNEL_ID>" and text="Daily update: build passed, deploy at 4 PM ET."`
+
+## 11) Reply in a Thread
+
+Prompt:
+`Use slack_send_message with channel_id="<CHANNEL_ID>", thread_ts="<THREAD_TS>", text="Acknowledged. I will post follow-up logs in 30 minutes."`
+
+## 12) Directory Snapshot
+
+Prompt:
+`Use slack_list_users with limit=500. Return a compact list of users with admin/bot flags.`
+
+## Notes
+
+- Replace placeholders before running (`<CHANNEL_ID>`, `<THREAD_TS>`, `<USER_ID>`, `<USERNAME>`, timestamps).
+- Timestamp parameters are Unix seconds in string form.
+- For large workspaces, start with smaller limits, then expand.

package/docs/WEB-API.md

@@ -7,6 +7,8 @@ The Slack Web Server exposes all MCP tools as REST endpoints, accessible from an
 ```bash
 cd ~/slack-mcp-server
 npm run web
+# Or run directly from npm:
+npx -y @jtalk22/slack-mcp web
 ```
 
 The server will:

package/lib/handlers.js

@@ -116,7 +116,7 @@ export async function handleHealthCheck() {
     return {
       content: [{
         type: "text",
-        text: "NO CREDENTIALS\n\nOptions:\n1. Open Slack in Chrome, then use slack_refresh_tokens\n2. Run: npm run tokens:auto (or npx @jtalk22/slack-mcp tokens:auto)"
+        text: "NO CREDENTIALS\n\nOptions:\n1. Open Slack in Chrome, then use slack_refresh_tokens\n2. Run: npx -y @jtalk22/slack-mcp --setup"
       }],
       isError: true
     };

package/lib/slack-client.js

@@ -150,7 +150,7 @@ export async function slackAPI(method, params = {}, options = {}) {
 
   const creds = loadTokens(false, logger);
   if (!creds) {
-    throw new Error("No credentials available. Run refresh-tokens.sh or open Slack in Chrome.");
+    throw new Error("No credentials available. Run npx -y @jtalk22/slack-mcp --setup or open Slack in Chrome.");
   }
 
   // Proactive token health check (non-blocking, only on first attempt)

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@jtalk22/slack-mcp",
   "mcpName": "io.github.jtalk22/slack-mcp-server",
-  "version": "1.2.1",
-  "description": "Full Slack access for Claude - DMs, channels, search. No OAuth. No admin approval. Just works.",
+  "version": "1.2.2",
+  "description": "Session-based Slack access for Claude - DMs, channels, search, and threads. Local-first with your existing Slack session.",
   "type": "module",
   "main": "src/server.js",
   "bin": {
@@ -17,6 +17,8 @@
     "http": "node src/server-http.js",
     "web": "node src/web-server.js",
     "setup": "node scripts/setup-wizard.js --setup",
+    "hooks:setup": "bash scripts/setup-git-hooks.sh",
+    "verify:owner-attribution": "bash scripts/check-owner-attribution.sh",
     "tokens:status": "node scripts/token-cli.js status",
     "tokens:refresh": "node scripts/token-cli.js refresh",
     "tokens:auto": "node scripts/token-cli.js auto",

package/public/demo-claude.html

@@ -12,19 +12,19 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <meta name="author" content="@jtalk22">
   <title>Slack MCP Server - Claude Desktop Demo</title>
-  <meta name="description" content="See how Claude uses Slack MCP tools to access your workspace - DMs, channels, search, and more.">
+  <meta name="description" content="Session-based Slack access demo showing Claude workflows for DMs, channels, search, and threads.">
 
   <!-- Open Graph -->
-  <meta property="og:title" content="Slack MCP Server - Claude Desktop Demo">
-  <meta property="og:description" content="Interactive demo showing Claude Desktop using MCP tools to access Slack - search messages, read threads, send updates.">
+  <meta property="og:title" content="Slack MCP Server - Session Access Demo">
+  <meta property="og:description" content="Interactive demo showing Claude using session-based Slack MCP tools for search, threads, and messaging workflows.">
   <meta property="og:type" content="website">
   <meta property="og:url" content="https://jtalk22.github.io/slack-mcp-server/public/demo-claude.html">
   <meta property="og:image" content="https://assets-worker.james-20a.workers.dev/projects/slack-mcp-server/demo-claude.gif">
 
   <!-- Twitter Card -->
   <meta name="twitter:card" content="summary_large_image">
-  <meta name="twitter:title" content="Slack MCP Server - Claude Desktop Demo">
-  <meta name="twitter:description" content="Interactive demo showing Claude using MCP tools to access your Slack workspace.">
+  <meta name="twitter:title" content="Slack MCP Server - Session Access Demo">
+  <meta name="twitter:description" content="Interactive demo showing Claude using session-based Slack MCP tools for search, threads, and messaging workflows.">
   <meta name="twitter:image" content="https://assets-worker.james-20a.workers.dev/projects/slack-mcp-server/demo-claude.gif">
 
   <!-- Theme -->
@@ -124,6 +124,43 @@
       color: var(--text-secondary);
       font-size: 16px;
     }
+    .cta-strip {
+      width: 100%;
+      max-width: 960px;
+      margin-bottom: 16px;
+      background: rgba(15, 52, 96, 0.72);
+      border: 1px solid rgba(255, 255, 255, 0.15);
+      border-radius: 12px;
+      padding: 10px 14px;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      gap: 10px;
+      flex-wrap: wrap;
+      font-size: 13px;
+    }
+    .cta-strip .links {
+      display: flex;
+      gap: 8px;
+      flex-wrap: wrap;
+    }
+    .cta-strip .links a {
+      color: #d8efff;
+      text-decoration: none;
+      border: 1px solid rgba(255, 255, 255, 0.25);
+      border-radius: 999px;
+      padding: 4px 8px;
+    }
+    .cta-strip .links a:hover {
+      background: rgba(255, 255, 255, 0.08);
+    }
+    .cta-strip .note {
+      color: rgba(255, 255, 255, 0.78);
+    }
+    .cta-strip .note a {
+      color: #9ee7ff;
+      text-decoration: underline;
+    }
 
     .badge {
       display: inline-flex;
@@ -1111,10 +1148,20 @@
   </style>
 </head>
 <body>
+  <div class="cta-strip">
+    <div class="links">
+      <a href="https://www.npmjs.com/package/@jtalk22/slack-mcp" target="_blank" rel="noopener noreferrer">Install</a>
+      <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/API.md" target="_blank" rel="noopener noreferrer">API Docs</a>
+      <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Changelog</a>
+    </div>
+    <div class="note">
+      Team rollout? Review <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md" target="_blank" rel="noopener noreferrer">Deployment Modes</a>.
+    </div>
+  </div>
   <header class="page-header">
     <h1>
       <span>Slack MCP Server</span>
-      <span class="badge">🔧 MCP Demo v1.2</span>
+      <span class="badge">🔧 MCP Demo v1.2.2</span>
     </h1>
     <p>See how Claude uses MCP tools to access your Slack workspace</p>
   </header>
@@ -1186,7 +1233,7 @@
       <div class="title-logo">💬</div>
       <h1>Slack MCP Server</h1>
       <p class="title-tagline">Full Slack access for Claude Desktop</p>
-      <p class="title-version">v1.2 • @jtalk22</p>
+      <p class="title-version">v1.2.2 • @jtalk22</p>
     </div>
 
     <!-- Scenario Caption Overlay -->
@@ -1196,9 +1243,9 @@
     <div class="closing-card" id="closingCard">
       <div class="closing-check">✅</div>
       <h2>Demo Complete</h2>
-      <p class="closing-cta">Full Slack access. No OAuth. No admin approval.</p>
+      <p class="closing-cta">Session-based Slack access aligned to your existing workspace permissions.</p>
       <div class="closing-links">
-        <code>npm install -g @jtalk22/slack-mcp</code>
+        <code>npx -y @jtalk22/slack-mcp --setup</code>
       </div>
       <p class="closing-github">github.com/jtalk22/slack-mcp-server</p>
       <span class="easter-egg">ê</span>

package/public/demo-video.html

@@ -4,6 +4,16 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Slack MCP Server Demo</title>
+  <meta name="description" content="Video demo of session-based Slack access for Claude with DMs, channels, search, and threads.">
+  <meta property="og:type" content="website">
+  <meta property="og:title" content="Slack MCP Server - Session Access Demo">
+  <meta property="og:description" content="Video walkthrough of session-based Slack workflows in Claude.">
+  <meta property="og:url" content="https://jtalk22.github.io/slack-mcp-server/public/demo-video.html">
+  <meta property="og:image" content="https://raw.githubusercontent.com/jtalk22/slack-mcp-server/main/docs/images/demo-poster.png">
+  <meta name="twitter:card" content="summary_large_image">
+  <meta name="twitter:title" content="Slack MCP Server - Session Access Demo">
+  <meta name="twitter:description" content="Video walkthrough of session-based Slack workflows in Claude.">
+  <meta name="twitter:image" content="https://raw.githubusercontent.com/jtalk22/slack-mcp-server/main/docs/images/demo-poster.png">
   <style>
     * {
       margin: 0;
@@ -37,6 +47,41 @@
       margin-bottom: 1.5rem;
       font-size: 1rem;
     }
+    .cta-strip {
+      margin: 0 auto 1rem;
+      background: rgba(15, 52, 96, 0.72);
+      border: 1px solid rgba(255, 255, 255, 0.16);
+      border-radius: 12px;
+      padding: 10px 14px;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      gap: 10px;
+      flex-wrap: wrap;
+      font-size: 0.8125rem;
+    }
+    .cta-strip .links {
+      display: flex;
+      gap: 8px;
+      flex-wrap: wrap;
+    }
+    .cta-strip .links a {
+      color: #d8efff;
+      text-decoration: none;
+      border: 1px solid rgba(255, 255, 255, 0.24);
+      border-radius: 999px;
+      padding: 4px 8px;
+    }
+    .cta-strip .links a:hover {
+      background: rgba(255, 255, 255, 0.08);
+    }
+    .cta-strip .note {
+      color: rgba(255, 255, 255, 0.82);
+    }
+    .cta-strip .note a {
+      color: #9ee7ff;
+      text-decoration: underline;
+    }
     .video-wrapper {
       position: relative;
       border-radius: 12px;
@@ -98,6 +143,16 @@
   <div class="container">
     <h1>Slack MCP Server</h1>
     <p class="subtitle">Full workspace access via local session mirroring</p>
+    <div class="cta-strip">
+      <div class="links">
+        <a href="https://www.npmjs.com/package/@jtalk22/slack-mcp" target="_blank" rel="noopener noreferrer">Install</a>
+        <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/API.md" target="_blank" rel="noopener noreferrer">API Docs</a>
+        <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Changelog</a>
+      </div>
+      <div class="note">
+        Team rollout? Review <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md" target="_blank" rel="noopener noreferrer">Deployment Modes</a>.
+      </div>
+    </div>
 
     <div class="video-wrapper">
       <video id="demo" poster="../docs/images/demo-poster.png" playsinline>

package/public/demo.html

@@ -8,18 +8,18 @@
   <!-- Open Graph / Social Sharing -->
   <meta property="og:type" content="website">
   <meta property="og:url" content="https://jtalk22.github.io/slack-mcp-server/public/demo.html">
-  <meta property="og:title" content="Slack MCP Server - Direct Access for Claude">
-  <meta property="og:description" content="Give Claude full access to DMs and Channels without OAuth. Try the interactive simulator.">
+  <meta property="og:title" content="Slack MCP Server - Session Access Demo">
+  <meta property="og:description" content="Interactive demo for session-based Slack access in Claude: DMs, channels, search, and threads.">
   <meta property="og:image" content="https://raw.githubusercontent.com/jtalk22/slack-mcp-server/main/docs/images/demo-main.png">
 
   <!-- Twitter Card -->
   <meta name="twitter:card" content="summary_large_image">
-  <meta name="twitter:title" content="Slack MCP Server - Direct Access for Claude">
-  <meta name="twitter:description" content="Give Claude full access to DMs and Channels without OAuth. Try the interactive simulator.">
+  <meta name="twitter:title" content="Slack MCP Server - Session Access Demo">
+  <meta name="twitter:description" content="Interactive demo for session-based Slack access in Claude: DMs, channels, search, and threads.">
   <meta name="twitter:image" content="https://raw.githubusercontent.com/jtalk22/slack-mcp-server/main/docs/images/demo-main.png">
 
   <!-- SEO -->
-  <meta name="description" content="Full Slack access for Claude - DMs, channels, search. No OAuth. No admin approval. Interactive demo simulator.">
+  <meta name="description" content="Session-based Slack access for Claude. Interactive demo for DMs, channels, search, and thread workflows.">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
@@ -74,12 +74,45 @@
       color: white;
       text-decoration: underline;
     }
+    .cta-strip {
+      background: rgba(15, 52, 96, 0.9);
+      border-bottom: 1px solid rgba(255, 255, 255, 0.12);
+      padding: 10px 16px;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      gap: 12px;
+      flex-wrap: wrap;
+      font-size: 13px;
+    }
+    .cta-links {
+      display: flex;
+      gap: 10px;
+      flex-wrap: wrap;
+    }
+    .cta-links a {
+      color: #d8efff;
+      text-decoration: none;
+      padding: 4px 8px;
+      border: 1px solid rgba(255, 255, 255, 0.25);
+      border-radius: 999px;
+    }
+    .cta-links a:hover {
+      background: rgba(255, 255, 255, 0.1);
+    }
+    .cta-note {
+      color: rgba(255, 255, 255, 0.75);
+    }
+    .cta-note a {
+      color: #9ee7ff;
+      text-decoration: underline;
+    }
 
     /* Main Layout */
     .split-container {
       display: grid;
       grid-template-columns: 420px 1fr;
-      height: calc(100vh - 44px);
+      height: calc(100vh - 88px);
       overflow: hidden;
     }
 
@@ -600,6 +633,16 @@
     STATIC PREVIEW - No real data. Run <code>npm run web</code> for live dashboard.
     <a href="https://github.com/jtalk22/slack-mcp-server">View on GitHub</a>
   </div>
+  <div class="cta-strip">
+    <div class="cta-links">
+      <a href="https://www.npmjs.com/package/@jtalk22/slack-mcp" target="_blank" rel="noopener noreferrer">Install</a>
+      <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/API.md" target="_blank" rel="noopener noreferrer">API Docs</a>
+      <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Changelog</a>
+    </div>
+    <div class="cta-note">
+      Team rollout? Review <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md" target="_blank" rel="noopener noreferrer">Deployment Modes</a>.
+    </div>
+  </div>
 
   <div class="split-container">
     <!-- LEFT: Claude Chat Panel -->

package/scripts/check-owner-attribution.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+EXPECTED_NAME="${EXPECTED_GIT_NAME:-jtalk22}"
+EXPECTED_EMAIL="${EXPECTED_GIT_EMAIL:-james@revasser.nyc}"
+BANNED_REGEX='(?i)(co-authored-by|generated with|\bclaude\b|\bgpt\b|\bcopilot\b|\bgemini\b|\bai\b)'
+
+die() {
+  echo "ERROR: $*" >&2
+  exit 1
+}
+
+contains_banned_markers() {
+  local text="$1"
+  if command -v rg >/dev/null 2>&1; then
+    rg -Niq "$BANNED_REGEX" <<<"$text"
+  else
+    grep -Eiq '(Co-authored-by|Generated with|Claude|GPT|Copilot|Gemini)' <<<"$text" \
+      || grep -Eiq '(^|[^[:alnum:]_])[Aa][Ii]([^[:alnum:]_]|$)' <<<"$text"
+  fi
+}
+
+if [[ "${SKIP_LOCAL_CONFIG_CHECK:-0}" != "1" ]]; then
+  local_name="$(git config --get user.name || true)"
+  local_email="$(git config --get user.email || true)"
+
+  [[ -n "$local_name" ]] || die "Missing repo-local git user.name"
+  [[ -n "$local_email" ]] || die "Missing repo-local git user.email"
+
+  [[ "$local_name" == "$EXPECTED_NAME" ]] \
+    || die "Repo-local user.name is '$local_name' (expected '$EXPECTED_NAME')"
+  [[ "$local_email" == "$EXPECTED_EMAIL" ]] \
+    || die "Repo-local user.email is '$local_email' (expected '$EXPECTED_EMAIL')"
+fi
+
+default_range="HEAD"
+if git rev-parse --verify origin/main >/dev/null 2>&1; then
+  default_range="origin/main..HEAD"
+fi
+
+range="${1:-${GIT_CHECK_RANGE:-$default_range}}"
+
+git rev-list --count "$range" >/dev/null 2>&1 || die "Invalid commit range: $range"
+commit_count="$(git rev-list --count "$range")"
+
+if [[ "$commit_count" -eq 0 ]]; then
+  echo "No commits to validate in range '$range'."
+  exit 0
+fi
+
+errors=0
+
+while IFS= read -r sha; do
+  author_name="$(git show -s --format=%an "$sha")"
+  author_email="$(git show -s --format=%ae "$sha")"
+  committer_name="$(git show -s --format=%cn "$sha")"
+  committer_email="$(git show -s --format=%ce "$sha")"
+  body="$(git show -s --format=%B "$sha")"
+
+  if [[ "$author_name" != "$EXPECTED_NAME" || "$author_email" != "$EXPECTED_EMAIL" ]]; then
+    echo "Commit $sha has author '$author_name <$author_email>' (expected '$EXPECTED_NAME <$EXPECTED_EMAIL>')." >&2
+    errors=1
+  fi
+
+  if [[ "$committer_name" != "$EXPECTED_NAME" || "$committer_email" != "$EXPECTED_EMAIL" ]]; then
+    echo "Commit $sha has committer '$committer_name <$committer_email>' (expected '$EXPECTED_NAME <$EXPECTED_EMAIL>')." >&2
+    errors=1
+  fi
+
+  if contains_banned_markers "$body"; then
+    echo "Commit $sha contains disallowed attribution markers in commit message." >&2
+    errors=1
+  fi
+done < <(git rev-list "$range")
+
+if [[ "$errors" -ne 0 ]]; then
+  exit 1
+fi
+
+echo "Owner-only attribution check passed for $commit_count commit(s) in '$range'."

package/scripts/setup-git-hooks.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+repo_root="$(git rev-parse --show-toplevel)"
+cd "$repo_root"
+
+[[ -d .githooks ]] || {
+  echo "Missing .githooks directory." >&2
+  exit 1
+}
+
+git config core.hooksPath .githooks
+find .githooks -maxdepth 1 -type f -exec chmod +x {} +
+
+echo "Configured git hooks path: .githooks"

package/scripts/setup-wizard.js

@@ -16,7 +16,7 @@ import { loadTokens, saveTokens, extractFromChrome, isAutoRefreshAvailable, TOKE
 import { slackAPI } from "../lib/slack-client.js";
 
 const IS_MACOS = platform() === 'darwin';
-const VERSION = "1.2.1";
+const VERSION = "1.2.2";
 
 // ANSI colors
 const colors = {
@@ -232,7 +232,7 @@ async function showStatus() {
   if (!creds) {
     error("No tokens found");
     print();
-    print("Run setup wizard: npx @jtalk22/slack-mcp --setup");
+    print("Run setup wizard: npx -y @jtalk22/slack-mcp --setup");
     process.exit(1);
   }
 
@@ -257,7 +257,7 @@ async function showStatus() {
     error("Status: INVALID");
     print(`Error: ${e.message}`);
     print();
-    print("Run setup wizard to refresh: npx @jtalk22/slack-mcp --setup");
+    print("Run setup wizard to refresh: npx -y @jtalk22/slack-mcp --setup");
     process.exit(1);
   }
 }
@@ -268,11 +268,11 @@ async function showHelp() {
   print("Full Slack access for Claude via MCP. Session mirroring bypasses OAuth.");
   print();
   print(`${colors.bold}Usage:${colors.reset}`);
-  print("  npx @jtalk22/slack-mcp             Start MCP server (stdio)");
-  print("  npx @jtalk22/slack-mcp --setup     Interactive token setup wizard");
-  print("  npx @jtalk22/slack-mcp --status    Check token health");
-  print("  npx @jtalk22/slack-mcp --version   Print version");
-  print("  npx @jtalk22/slack-mcp --help      Show this help");
+  print("  npx -y @jtalk22/slack-mcp             Start MCP server (stdio)");
+  print("  npx -y @jtalk22/slack-mcp --setup     Interactive token setup wizard");
+  print("  npx -y @jtalk22/slack-mcp --status    Check token health");
+  print("  npx -y @jtalk22/slack-mcp --version   Print version");
+  print("  npx -y @jtalk22/slack-mcp --help      Show this help");
   print();
   print(`${colors.bold}npm scripts:${colors.reset}`);
   print("  npm start              Start MCP server");
@@ -345,8 +345,8 @@ async function main() {
       print(`${colors.green}${colors.bold}Setup complete!${colors.reset}`);
       print();
       print("Next steps:");
-      print("  • Verify: npx @jtalk22/slack-mcp --status");
-      print("  • Start server: npx @jtalk22/slack-mcp");
+      print("  • Verify: npx -y @jtalk22/slack-mcp --status");
+      print("  • Start server: npx -y @jtalk22/slack-mcp");
       print("  • Or add to Claude Desktop config");
     } else {
       print(`${colors.red}Setup failed.${colors.reset} See errors above.`);

package/src/server-http.js

@@ -30,7 +30,7 @@ import {
 } from "../lib/handlers.js";
 
 const SERVER_NAME = "slack-mcp-server";
-const SERVER_VERSION = "1.2.1";
+const SERVER_VERSION = "1.2.2";
 const PORT = process.env.PORT || 3000;
 
 // Create MCP server

package/src/server.js

@@ -11,7 +11,7 @@
  * - Network error retry with exponential backoff
  * - Background token health monitoring
  *
- * @version 1.2.1
+ * @version 1.2.2
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -47,7 +47,7 @@ const BACKGROUND_REFRESH_INTERVAL = 4 * 60 * 60 * 1000;
 
 // Package info
 const SERVER_NAME = "slack-mcp-server";
-const SERVER_VERSION = "1.2.1";
+const SERVER_VERSION = "1.2.2";
 
 // MCP Prompts - predefined prompt templates for common Slack operations
 const PROMPTS = [

package/src/web-server.js

@@ -5,7 +5,7 @@
  * Exposes Slack MCP tools as REST endpoints for browser access.
  * Run alongside or instead of the MCP server for web-based access.
  *
- * @version 1.2.1
+ * @version 1.2.2
  */
 
 import express from "express";
@@ -116,7 +116,7 @@ function extractContent(result) {
 app.get("/", (req, res) => {
   res.json({
     name: "Slack Web API Server",
-    version: "1.2.1",
+    version: "1.2.2",
     status: "running",
     endpoints: [
       "GET  /health",
@@ -295,7 +295,7 @@ async function main() {
   app.listen(PORT, '127.0.0.1', () => {
     // Print to stderr to keep logs clean (stdout reserved for JSON in some setups)
     console.error(`\n${"═".repeat(60)}`);
-    console.error(`  Slack Web API Server v1.2.1`);
+    console.error(`  Slack Web API Server v1.2.2`);
     console.error(`${"═".repeat(60)}`);
     console.error(`\n  Dashboard: http://localhost:${PORT}/?key=${API_KEY}`);
     console.error(`\n  API Key:   ${API_KEY}`);