@contextstream/mcp-server 0.3.40 → 0.3.41

package/README.md

@@ -48,9 +48,10 @@ npx -y @contextstream/mcp-server setup
 
 Notes:
 - Uses browser/device login by default and creates an API key for you.
+- Prompts for **toolset selection**: `core` (default, ~17 essential tools) or `full` (~86 tools including workspaces, projects, search, memory, graph, AI, and integrations).
 - To avoid re-auth prompts on subsequent runs, the wizard saves that API key to `~/.contextstream/credentials.json` (and also writes it into the MCP config files it generates). Delete that file to force a fresh login.
 - Codex CLI MCP config is global-only (`~/.codex/config.toml`), so the wizard will always write Codex config globally when selected.
-- Some tools still require UI/CLI-based MCP setup (the wizard will tell you when it can’t write a config).
+- Some tools still require UI/CLI-based MCP setup (the wizard will tell you when it can't write a config).
 - Preview changes without writing files: `npx -y @contextstream/mcp-server setup --dry-run`
 
 ### Run the server
@@ -74,7 +75,9 @@ contextstream-mcp
 
 If you ran the [setup wizard](#setup-wizard-recommended), you can usually skip this section.
 
-If you prefer to configure things by hand (or your tool can’t be auto-configured), add the ContextStream MCP server to your client using one of the examples below.
+If you prefer to configure things by hand (or your tool can't be auto-configured), add the ContextStream MCP server to your client using one of the examples below.
+
+**Toolset**: By default, the server exposes `core` tools (~17 essential session/context tools). To expose all ~86 tools (workspaces, projects, search, memory, graph, AI, integrations), add `"CONTEXTSTREAM_TOOLSET": "full"` to the `env` block. See the [full tool catalog](https://contextstream.io/docs/mcp/tools).
 
 ### Cursor / Windsurf / Claude Desktop (JSON)
 
@@ -204,7 +207,7 @@ You can authenticate using either:
 | `CONTEXTSTREAM_WORKSPACE_ID` | No | Default workspace ID fallback |
 | `CONTEXTSTREAM_PROJECT_ID` | No | Default project ID fallback |
 | `CONTEXTSTREAM_USER_AGENT` | No | Custom user agent string |
-| `CONTEXTSTREAM_TOOLSET` | No | Tool bundle to expose (`core` default, or `full`) |
+| `CONTEXTSTREAM_TOOLSET` | No | Tool bundle to expose: `core` (default, ~17 tools) or `full` (~86 tools). Claude Code/Desktop may warn about large tool contexts with `full`. |
 | `CONTEXTSTREAM_TOOL_ALLOWLIST` | No | Comma-separated tool names to expose (overrides toolset) |
 | `CONTEXTSTREAM_PRO_TOOLS` | No | Comma-separated tool names treated as PRO (default: `ai_context,ai_enhanced_context,ai_context_budget,ai_embeddings,ai_plan,ai_tasks`) |
 | `CONTEXTSTREAM_UPGRADE_URL` | No | Upgrade link shown when Free users call PRO tools (default: `https://contextstream.io/pricing`) |

package/dist/index.js

@@ -6885,6 +6885,44 @@ W:${wsHint}
     if (params?.limit) query.set("limit", String(params.limit));
     return request(this.config, `/workspaces/${withDefaults.workspace_id}/github/search?${query.toString()}`, { method: "GET" });
   }
+  /**
+   * Get knowledge extracted from GitHub (decisions, lessons, insights)
+   */
+  async githubKnowledge(params) {
+    const withDefaults = this.withDefaults(params || {});
+    if (!withDefaults.workspace_id) {
+      throw new Error("workspace_id is required for GitHub knowledge");
+    }
+    const query = new URLSearchParams();
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.node_type) query.set("node_type", params.node_type);
+    const suffix = query.toString() ? `?${query.toString()}` : "";
+    return request(this.config, `/workspaces/${withDefaults.workspace_id}/github/knowledge${suffix}`, { method: "GET" });
+  }
+  /**
+   * Get knowledge extracted from Slack (decisions, lessons, insights)
+   */
+  async slackKnowledge(params) {
+    const withDefaults = this.withDefaults(params || {});
+    if (!withDefaults.workspace_id) {
+      throw new Error("workspace_id is required for Slack knowledge");
+    }
+    const query = new URLSearchParams();
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.node_type) query.set("node_type", params.node_type);
+    const suffix = query.toString() ? `?${query.toString()}` : "";
+    return request(this.config, `/workspaces/${withDefaults.workspace_id}/slack/knowledge${suffix}`, { method: "GET" });
+  }
+  /**
+   * Get integration status for all providers in a workspace
+   */
+  async integrationsStatus(params) {
+    const withDefaults = this.withDefaults(params || {});
+    if (!withDefaults.workspace_id) {
+      throw new Error("workspace_id is required for integrations status");
+    }
+    return request(this.config, `/workspaces/${withDefaults.workspace_id}/integrations/status`, { method: "GET" });
+  }
 };
 
 // src/tools.ts
@@ -6894,6 +6932,7 @@ import * as path4 from "node:path";
 // src/rules-templates.ts
 var DEFAULT_CLAUDE_MCP_SERVER_NAME = "contextstream";
 var CONTEXTSTREAM_TOOL_NAMES = [
+  // Session/Context (core)
   "session_init",
   "context_smart",
   "session_summary",
@@ -6906,9 +6945,90 @@ var CONTEXTSTREAM_TOOL_NAMES = [
   "session_smart_search",
   "session_compress",
   "session_delta",
+  // Editor Rules
   "generate_editor_rules",
+  // Workspaces
   "workspace_associate",
-  "workspace_bootstrap"
+  "workspace_bootstrap",
+  "workspaces_list",
+  "workspaces_create",
+  "workspaces_update",
+  "workspaces_delete",
+  "workspaces_get",
+  "workspaces_overview",
+  "workspaces_analytics",
+  "workspaces_content",
+  // Projects
+  "projects_list",
+  "projects_create",
+  "projects_update",
+  "projects_delete",
+  "projects_get",
+  "projects_overview",
+  "projects_statistics",
+  "projects_files",
+  "projects_index",
+  "projects_index_status",
+  "projects_ingest_local",
+  // Search
+  "search_semantic",
+  "search_hybrid",
+  "search_keyword",
+  "search_pattern",
+  "search_suggestions",
+  // Memory
+  "memory_create_event",
+  "memory_bulk_ingest",
+  "memory_list_events",
+  "memory_create_node",
+  "memory_list_nodes",
+  "memory_search",
+  "memory_decisions",
+  "memory_get_event",
+  "memory_update_event",
+  "memory_delete_event",
+  "memory_distill_event",
+  "memory_get_node",
+  "memory_update_node",
+  "memory_delete_node",
+  "memory_supersede_node",
+  "memory_timeline",
+  "memory_summary",
+  // Graph
+  "graph_related",
+  "graph_path",
+  "graph_decisions",
+  "graph_dependencies",
+  "graph_call_path",
+  "graph_impact",
+  "graph_circular_dependencies",
+  "graph_unused_code",
+  "graph_contradictions",
+  // AI (PRO)
+  "ai_context",
+  "ai_enhanced_context",
+  "ai_context_budget",
+  "ai_embeddings",
+  "ai_plan",
+  "ai_tasks",
+  // GitHub Integration (PRO)
+  "github_stats",
+  "github_repos",
+  "github_contributors",
+  "github_activity",
+  "github_issues",
+  "github_search",
+  // Slack Integration (PRO)
+  "slack_stats",
+  "slack_channels",
+  "slack_contributors",
+  "slack_activity",
+  "slack_discussions",
+  "slack_search",
+  "slack_sync_users",
+  // Auth/Meta
+  "auth_me",
+  "mcp_server_version"
 ];
 function applyMcpToolPrefix(markdown, toolPrefix) {
   const toolPattern = CONTEXTSTREAM_TOOL_NAMES.join("|");
@@ -7069,6 +7189,41 @@ session_capture(event_type="decision", title="Auth Implementation Complete", con
 # Check past decisions
 session_recall(query="what did we decide about caching?")
 \`\`\`
+
+---
+
+### Full Tool Catalog
+
+The following tools are available when \`CONTEXTSTREAM_TOOLSET=full\` (default is \`core\`, which includes only the essential session/context tools above):
+
+**Session/Context** (included in core):
+\`session_init\`, \`context_smart\`, \`session_summary\`, \`session_capture\`, \`session_capture_lesson\`, \`session_get_lessons\`, \`session_recall\`, \`session_remember\`, \`session_get_user_context\`, \`session_smart_search\`, \`session_compress\`, \`session_delta\`, \`generate_editor_rules\`, \`workspace_associate\`, \`workspace_bootstrap\`
+
+**Workspaces**:
+\`workspaces_list\`, \`workspaces_create\`, \`workspaces_update\`, \`workspaces_delete\`, \`workspaces_get\`, \`workspaces_overview\`, \`workspaces_analytics\`, \`workspaces_content\`
+
+**Projects**:
+\`projects_list\`, \`projects_create\`, \`projects_update\`, \`projects_delete\`, \`projects_get\`, \`projects_overview\`, \`projects_statistics\`, \`projects_files\`, \`projects_index\`, \`projects_index_status\`, \`projects_ingest_local\`
+
+**Search**:
+\`search_semantic\`, \`search_hybrid\`, \`search_keyword\`, \`search_pattern\`, \`search_suggestions\`
+
+**Memory**:
+\`memory_create_event\`, \`memory_bulk_ingest\`, \`memory_list_events\`, \`memory_create_node\`, \`memory_list_nodes\`, \`memory_search\`, \`memory_decisions\`, \`memory_get_event\`, \`memory_update_event\`, \`memory_delete_event\`, \`memory_distill_event\`, \`memory_get_node\`, \`memory_update_node\`, \`memory_delete_node\`, \`memory_supersede_node\`, \`memory_timeline\`, \`memory_summary\`
+
+**Graph** (code analysis):
+\`graph_related\`, \`graph_path\`, \`graph_decisions\`, \`graph_dependencies\`, \`graph_call_path\`, \`graph_impact\`, \`graph_circular_dependencies\`, \`graph_unused_code\`, \`graph_contradictions\`
+
+**AI** (PRO):
+\`ai_context\`, \`ai_enhanced_context\`, \`ai_context_budget\`, \`ai_embeddings\`, \`ai_plan\`, \`ai_tasks\`
+
+**GitHub Integration** (PRO):
+\`github_stats\`, \`github_repos\`, \`github_contributors\`, \`github_activity\`, \`github_issues\`, \`github_search\`
+
+**Slack Integration** (PRO):
+\`slack_stats\`, \`slack_channels\`, \`slack_contributors\`, \`slack_activity\`, \`slack_discussions\`, \`slack_search\`, \`slack_sync_users\`
+
+See full documentation: https://contextstream.io/docs/mcp/tools
 `.trim();
 var CONTEXTSTREAM_RULES_MINIMAL = `
 ## ContextStream (Minimal)
@@ -7080,6 +7235,7 @@ var CONTEXTSTREAM_RULES_MINIMAL = `
 - For code/file discovery, use \`session_smart_search\` before raw repo scans (\`rg\`, \`ls\`, \`find\`); fall back only if needed.
 - After meaningful work/decisions/preferences: \`session_capture(event_type=decision|preference|task|insight, title="\u2026", content="\u2026")\`.
 - On frustration/corrections/tool mistakes: \`session_capture_lesson(...)\`.
+- Full tool catalog (workspaces, projects, search, memory, graph, AI, integrations): see https://contextstream.io/docs/mcp/tools
 `.trim();
 var TEMPLATES = {
   codex: {
@@ -9668,6 +9824,95 @@ Use this to find specific issues, PRs, or discussions.`,
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
+  registerTool(
+    "github_knowledge",
+    {
+      title: "GitHub extracted knowledge",
+      description: `Get knowledge extracted from GitHub issues and PRs.
+Returns: decisions, lessons, and insights automatically distilled from GitHub conversations.
+This surfaces key decisions and learnings from your repository discussions.
+
+Example queries:
+- "What decisions were made about authentication?"
+- "What lessons learned from production incidents?"
+- "Show recent architectural decisions"`,
+      inputSchema: external_exports.object({
+        workspace_id: external_exports.string().uuid().optional(),
+        limit: external_exports.number().optional().describe("Maximum items to return (default: 20)"),
+        node_type: external_exports.enum(["decision", "lesson", "fact", "insight"]).optional().describe("Filter by knowledge type")
+      })
+    },
+    async (input) => {
+      const workspaceId = resolveWorkspaceId(input.workspace_id);
+      if (!workspaceId) {
+        return errorResult("Error: workspace_id is required. Please call session_init first or provide workspace_id explicitly.");
+      }
+      const result = await client.githubKnowledge({ workspace_id: workspaceId, limit: input.limit, node_type: input.node_type });
+      if (result.length === 0) {
+        return { content: [{ type: "text", text: "No knowledge extracted from GitHub yet. Knowledge is distilled from issues/PRs after sync." }] };
+      }
+      return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+    }
+  );
+  registerTool(
+    "slack_knowledge",
+    {
+      title: "Slack extracted knowledge",
+      description: `Get knowledge extracted from Slack conversations.
+Returns: decisions, lessons, and insights automatically distilled from Slack discussions.
+This surfaces key decisions and learnings from your team conversations.
+
+Example queries:
+- "What decisions were made in #engineering this week?"
+- "Show lessons learned from outages"
+- "What architectural insights came from Slack?"`,
+      inputSchema: external_exports.object({
+        workspace_id: external_exports.string().uuid().optional(),
+        limit: external_exports.number().optional().describe("Maximum items to return (default: 20)"),
+        node_type: external_exports.enum(["decision", "lesson", "fact", "insight"]).optional().describe("Filter by knowledge type")
+      })
+    },
+    async (input) => {
+      const workspaceId = resolveWorkspaceId(input.workspace_id);
+      if (!workspaceId) {
+        return errorResult("Error: workspace_id is required. Please call session_init first or provide workspace_id explicitly.");
+      }
+      const result = await client.slackKnowledge({ workspace_id: workspaceId, limit: input.limit, node_type: input.node_type });
+      if (result.length === 0) {
+        return { content: [{ type: "text", text: "No knowledge extracted from Slack yet. Knowledge is distilled from high-engagement threads after sync." }] };
+      }
+      return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+    }
+  );
+  registerTool(
+    "integrations_status",
+    {
+      title: "Integration health status",
+      description: `Check the status of all integrations (GitHub, Slack, etc.) for a workspace.
+Returns: connection status, last sync time, next sync time, and any errors.
+Use this to verify integrations are healthy and syncing properly.`,
+      inputSchema: external_exports.object({
+        workspace_id: external_exports.string().uuid().optional()
+      })
+    },
+    async (input) => {
+      const workspaceId = resolveWorkspaceId(input.workspace_id);
+      if (!workspaceId) {
+        return errorResult("Error: workspace_id is required. Please call session_init first or provide workspace_id explicitly.");
+      }
+      const result = await client.integrationsStatus({ workspace_id: workspaceId });
+      if (result.length === 0) {
+        return { content: [{ type: "text", text: "No integrations configured for this workspace." }] };
+      }
+      const formatted = result.map((i) => {
+        const status = i.status === "connected" ? "\u2705" : i.status === "error" ? "\u274C" : "\u23F3";
+        const lastSync = i.last_sync_at ? new Date(i.last_sync_at).toLocaleString() : "Never";
+        const error = i.error_message ? ` (Error: ${i.error_message})` : "";
+        return `${status} ${i.provider}: ${i.status} | Last sync: ${lastSync} | Resources: ${i.resources_synced}${error}`;
+      }).join("\n");
+      return { content: [{ type: "text", text: formatted }], structuredContent: toStructured(result) };
+    }
+  );
 }
 
 // src/resources.ts
@@ -10535,6 +10780,12 @@ Created API key: ${maskApiKey(apiKey)}
     console.log("  2) Extended \u2014 more guidance + examples (higher token overhead)");
     const modeChoice = normalizeInput(await rl.question("Choose [1/2] (default 1): ")) || "1";
     const mode = modeChoice === "2" ? "full" : "minimal";
+    console.log("\nMCP toolset (which tools to expose to the AI):");
+    console.log("  1) Core (recommended) \u2014 essential session/context tools (~17 tools, lower token overhead)");
+    console.log("  2) Full \u2014 all tools including workspaces, projects, search, memory, graph, AI, integrations (~86 tools)");
+    console.log("     Note: Claude Code/Desktop may warn about large tool lists when using full toolset.");
+    const toolsetChoice = normalizeInput(await rl.question("Choose [1/2] (default 1): ")) || "1";
+    const toolset = toolsetChoice === "2" ? "full" : "core";
     const editors = ["codex", "claude", "cursor", "windsurf", "cline", "kilo", "roo", "aider"];
     console.log('\nSelect editors to configure (comma-separated numbers, or "all"):');
     editors.forEach((e, i) => console.log(`  ${i + 1}) ${EDITOR_LABELS[e]}`));
@@ -10565,9 +10816,9 @@ Created API key: ${maskApiKey(apiKey)}
     const mcpChoiceDefault = hasCodex && !hasProjectMcpEditors ? "1" : "3";
     const mcpChoice = normalizeInput(await rl.question(`Choose [${hasCodex && !hasProjectMcpEditors ? "1/2" : "1/2/3/4"}] (default ${mcpChoiceDefault}): `)) || mcpChoiceDefault;
     const mcpScope = mcpChoice === "2" && hasCodex && !hasProjectMcpEditors ? "skip" : mcpChoice === "4" ? "skip" : mcpChoice === "1" ? "global" : mcpChoice === "2" ? "project" : "both";
-    const mcpServer = buildContextStreamMcpServer({ apiUrl, apiKey });
-    const mcpServerClaude = buildContextStreamMcpServer({ apiUrl, apiKey, toolset: "core" });
-    const vsCodeServer = buildContextStreamVsCodeServer({ apiUrl, apiKey });
+    const mcpServer = toolset === "full" ? buildContextStreamMcpServer({ apiUrl, apiKey, toolset: "full" }) : buildContextStreamMcpServer({ apiUrl, apiKey });
+    const mcpServerClaude = buildContextStreamMcpServer({ apiUrl, apiKey, toolset });
+    const vsCodeServer = toolset === "full" ? buildContextStreamVsCodeServer({ apiUrl, apiKey, toolset: "full" }) : buildContextStreamVsCodeServer({ apiUrl, apiKey });
     const needsGlobalMcpConfig = mcpScope === "global" || mcpScope === "both" || mcpScope === "project" && hasCodex;
     if (needsGlobalMcpConfig) {
       console.log("\nInstalling global MCP config...");
@@ -10614,7 +10865,7 @@ Created API key: ${maskApiKey(apiKey)}
               }
             }
             console.log("- Claude Code: global MCP config is best done via `claude mcp add --transport stdio ...` (see docs).");
-            console.log("  macOS/Linux: claude mcp add --transport stdio contextstream --scope user --env CONTEXTSTREAM_API_URL=... --env CONTEXTSTREAM_API_KEY=... --env CONTEXTSTREAM_TOOLSET=core -- npx -y @contextstream/mcp-server");
+            console.log(`  macOS/Linux: claude mcp add --transport stdio contextstream --scope user --env CONTEXTSTREAM_API_URL=... --env CONTEXTSTREAM_API_KEY=... --env CONTEXTSTREAM_TOOLSET=${toolset} -- npx -y @contextstream/mcp-server`);
             console.log("  Windows (native): use `cmd /c npx -y @contextstream/mcp-server` after `--` if `npx` is not found.");
             continue;
           }
@@ -10817,10 +11068,15 @@ Applying to ${projects.length} project(s)...`);
       const skipped = writeActions.filter((a) => a.status === "skipped").length;
       const dry = writeActions.filter((a) => a.status === "dry-run").length;
       console.log(`Summary: ${created} created, ${updated} updated, ${appended} appended, ${skipped} skipped, ${dry} dry-run.`);
+      console.log(`Toolset: ${toolset} (${toolset === "full" ? "~86 tools" : "~17 core tools"})`);
     }
     console.log("\nNext steps:");
     console.log("- Restart your editor/CLI after changing MCP config or rules.");
+    console.log("- Prefer ContextStream search first: use session_smart_search (or mcp__contextstream__session_smart_search) before raw repo scans (rg/ls/find).");
     console.log("- If any tools require UI-based MCP setup (e.g. Cline/Kilo/Roo global), follow https://contextstream.io/docs/mcp.");
+    if (toolset === "full") {
+      console.log("- Note: Claude Code/Desktop may warn about large tool contexts. This is expected with the full toolset.");
+    }
   } finally {
     rl.close();
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextstream/mcp-server",
-  "version": "0.3.40",
+  "version": "0.3.41",
   "description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
   "type": "module",
   "license": "MIT",