@stacksfinder/mcp-server 1.3.7 → 1.5.1

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to `@stacksfinder/mcp-server` will be documented in this fil
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.1] - 2026-01-14
+
+### Fixed
+- Added Windows-specific installation instructions with `cmd /c` wrapper
+- Updated README with platform-specific configs for Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code
+
+## [1.5.0] - 2026-01-14
+
+### Added
+- `get_workflow_guide` tool - Intelligent context-aware guidance for next steps
+- `create_api_key` tool - Create API keys via OAuth (no email/password needed)
+- Enhanced tool descriptions with Prerequisites, Next Steps, and Common Pitfalls
+- ChatGPT Actions support via OAuth authentication
+
+### Changed
+- Total tools increased to 25
+- Improved descriptions for all tools with consistent format
+- `setup_api_key` now recommends `create_api_key` for OAuth users
+
 ## [1.3.5] - 2025-01-13
 
 ### Added
@@ -89,12 +108,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-## Tool Categories (v1.3.5)
+## Tool Categories (v1.5.0)
 
 | Category | Tools | Auth Required |
 |----------|-------|---------------|
-| Free | 9 | No |
-| Pro | 6 | API Key |
+| Free | 10 | No |
+| Pro | 7 | API Key |
 | Audit | 6 | API Key |
 | Estimator | 2 | API Key |
-| **Total** | **23** | - |
+| **Total** | **25** | - |

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025-2026 StacksFinder
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 MCP Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@stacksfinder/mcp-server.svg)](https://www.npmjs.com/package/@stacksfinder/mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![MCP](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io)
+[![MCP Registry](https://img.shields.io/badge/MCP-Registry-8A2BE2.svg)](https://registry.modelcontextprotocol.io)
 [![LobeHub](https://img.shields.io/badge/LobeHub-MCP%20Directory-blue.svg)](https://lobehub.com/fr/mcp/hoklims-stacksfinder-mcp)
 
 MCP (Model Context Protocol) server that brings **deterministic tech stack recommendations** to LLM clients like Claude, Cursor, Windsurf, and other MCP-compatible tools.
@@ -14,10 +14,17 @@ MCP (Model Context Protocol) server that brings **deterministic tech stack recom
 ### Claude Code (CLI)
 
 ```bash
-# Add to Claude Code
+# macOS/Linux
 claude mcp add stacksfinder npx -y @stacksfinder/mcp-server
 
-# With API key for full features
+# Windows (requires cmd wrapper)
+claude mcp add-json stacksfinder '{
+  "command": "cmd",
+  "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],
+  "env": {"STACKSFINDER_API_KEY": "sk_live_xxx"}
+}'
+
+# With API key (macOS/Linux)
 claude mcp add-json stacksfinder '{
   "command": "npx",
   "args": ["-y", "@stacksfinder/mcp-server"],
@@ -25,10 +32,11 @@ claude mcp add-json stacksfinder '{
 }'
 ```
 
-### Claude Code
+### Claude Desktop
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
 
+**macOS/Linux:**
 ```json
 {
   "mcpServers": {
@@ -43,10 +51,26 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 }
 ```
 
+**Windows:**
+```json
+{
+  "mcpServers": {
+    "stacksfinder": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],
+      "env": {
+        "STACKSFINDER_API_KEY": "sk_live_xxx"
+      }
+    }
+  }
+}
+```
+
 ### Cursor / Windsurf
 
 Add to `.cursor/mcp.json` or `.windsurf/mcp.json` in your project root:
 
+**macOS/Linux:**
 ```json
 {
   "mcpServers": {
@@ -61,10 +85,26 @@ Add to `.cursor/mcp.json` or `.windsurf/mcp.json` in your project root:
 }
 ```
 
+**Windows:**
+```json
+{
+  "mcpServers": {
+    "stacksfinder": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],
+      "env": {
+        "STACKSFINDER_API_KEY": "sk_live_xxx"
+      }
+    }
+  }
+}
+```
+
 ### VS Code + Copilot
 
 Add to `.vscode/mcp.json`:
 
+**macOS/Linux:**
 ```json
 {
   "servers": {
@@ -79,6 +119,56 @@ Add to `.vscode/mcp.json`:
 }
 ```
 
+**Windows:**
+```json
+{
+  "servers": {
+    "stacksfinder": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],
+      "env": {
+        "STACKSFINDER_API_KEY": "sk_live_xxx"
+      }
+    }
+  }
+}
+```
+
+### ChatGPT Developer Mode
+
+StacksFinder is compatible with **ChatGPT Developer Mode** (available on Pro, Plus, Business, Enterprise, and Education accounts).
+
+#### Prerequisites
+
+- ChatGPT Pro, Plus, Business, Enterprise, or Education account
+- Developer Mode enabled in ChatGPT settings
+- Note: Business/Enterprise workspaces may require admin approval
+
+#### Setup Steps
+
+1. **Enable Developer Mode**: Go to Settings → Apps → Advanced settings → toggle "Developer mode"
+2. **Create App**: Go to Settings → Apps → Create
+3. **Enter details**:
+   - **Name**: StacksFinder
+   - **URL**: `https://smithery.ai/server/hoklims/stacksfinder-mcp/mcp` (or your self-hosted URL)
+   - **Protocol**: Streaming HTTP
+   - **Description**: Deterministic tech stack recommendations
+4. **Verify**: Click Create and confirm the 23 tools appear
+
+#### Important Notes
+
+- **Developer Mode does NOT require search/fetch tools** (those are only for Deep Research)
+- Tools with `readOnlyHint: true` won't ask for confirmation in ChatGPT
+- Rate limited to 60 requests/minute per IP
+- Uses **Streaming HTTP** transport (not SSE)
+
+#### Supported Protocols
+
+| Protocol | Status |
+|----------|--------|
+| Streaming HTTP | ✅ Supported |
+| SSE | ❌ Not supported |
+
 ## Available Tools
 
 ### Free Tools (no account required)
@@ -477,6 +567,7 @@ For security vulnerabilities, please see our [Security Policy](SECURITY.md).
 
 - **Website**: [stacksfinder.com](https://stacksfinder.com)
 - **Pricing**: [stacksfinder.com/pricing](https://stacksfinder.com/pricing)
+- **MCP Registry**: [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io) (Official Anthropic)
 - **Discord**: [discord.gg/scBHF2EumC](https://discord.gg/scBHF2EumC)
 - **Glama**: [glama.ai/mcp/servers/@stacksfinder/mcp-server](https://glama.ai/mcp/servers/@stacksfinder/mcp-server)
 - **Smithery**: [smithery.ai/server/hoklims/stacksfinder-mcp](https://smithery.ai/server/hoklims/stacksfinder-mcp)

package/dist/annotations.d.ts

@@ -26,6 +26,8 @@ export declare const recommendStackDemoAnnotations: ToolAnnotations;
 export declare const generateMcpKitAnnotations: ToolAnnotations;
 /** Check MCP compatibility - local rule checking, read-only */
 export declare const checkCompatibilityAnnotations: ToolAnnotations;
+/** Workflow guide - intelligent context-aware guidance, read-only */
+export declare const getWorkflowGuideAnnotations: ToolAnnotations;
 /** Analyze repo MCPs - reads local files, no modifications */
 export declare const analyzeRepoMcpsAnnotations: ToolAnnotations;
 /** Prepare MCP installation - creates .env-mcp file */
@@ -44,6 +46,8 @@ export declare const setupApiKeyAnnotations: ToolAnnotations;
 export declare const listApiKeysAnnotations: ToolAnnotations;
 /** Revoke API key - deletes resource */
 export declare const revokeApiKeyAnnotations: ToolAnnotations;
+/** Create API key - creates key via OAuth (no email/password) */
+export declare const createApiKeyAnnotations: ToolAnnotations;
 /** Create audit - creates resource */
 export declare const createAuditAnnotations: ToolAnnotations;
 /** Get audit - fetches from API */

package/dist/annotations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../src/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E;;;;;;GAMG;AAMH,kDAAkD;AAClD,eAAO,MAAM,2BAA2B,EAAE,eAMzC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,6BAA6B,EAAE,eAM3C,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,EAAE,eAMvC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,6BAA6B,EAAE,eAM3C,CAAC;AAMF,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,EAAE,eAMxC,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,iCAAiC,EAAE,eAM/C,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,iCAAiC,EAAE,eAM/C,CAAC;AAMF,+CAA+C;AAC/C,eAAO,MAAM,yBAAyB,EAAE,eAMvC,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,0BAA0B,EAAE,eAMxC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC;AAMF,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,EAAE,eAMjC,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,qBAAqB,EAAE,eAMnC,CAAC;AAEF,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,qCAAqC,EAAE,eAMnD,CAAC;AAMF,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,EAAE,eAMxC,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,EAAE,eAMzC,CAAC"}
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../src/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E;;;;;;GAMG;AAMH,kDAAkD;AAClD,eAAO,MAAM,2BAA2B,EAAE,eAMzC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,6BAA6B,EAAE,eAM3C,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,EAAE,eAMvC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,6BAA6B,EAAE,eAM3C,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,2BAA2B,EAAE,eAMzC,CAAC;AAMF,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,EAAE,eAMxC,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,iCAAiC,EAAE,eAM/C,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,iCAAiC,EAAE,eAM/C,CAAC;AAMF,+CAA+C;AAC/C,eAAO,MAAM,yBAAyB,EAAE,eAMvC,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,0BAA0B,EAAE,eAMxC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC;AAMF,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,EAAE,eAMjC,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,qBAAqB,EAAE,eAMnC,CAAC;AAEF,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,qCAAqC,EAAE,eAMnD,CAAC;AAMF,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,EAAE,eAMxC,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,EAAE,eAMzC,CAAC"}

package/dist/annotations.js

@@ -64,6 +64,14 @@ export const checkCompatibilityAnnotations = {
     idempotentHint: true,
     openWorldHint: false
 };
+/** Workflow guide - intelligent context-aware guidance, read-only */
+export const getWorkflowGuideAnnotations = {
+    title: 'Get Workflow Guide',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
 // ============================================================================
 // LOCAL TOOLS WITH FILE SYSTEM ACCESS
 // ============================================================================
@@ -142,6 +150,14 @@ export const revokeApiKeyAnnotations = {
     idempotentHint: true, // Revoking twice = same result
     openWorldHint: true
 };
+/** Create API key - creates key via OAuth (no email/password) */
+export const createApiKeyAnnotations = {
+    title: 'Create API Key',
+    readOnlyHint: false, // Creates API key
+    destructiveHint: false,
+    idempotentHint: false, // Creates new key each time
+    openWorldHint: true
+};
 // ============================================================================
 // AUDIT TOOLS (API-based)
 // ============================================================================

package/dist/annotations.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../src/annotations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../src/annotations.ts"],"names":[],"mappings":"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"}

package/dist/http.d.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 /**
  * HTTP entry point for Smithery hosted deployments.
+ * Compatible with ChatGPT Developer Mode and other MCP clients.
  */
 /**
  * Creates a sandbox server for Smithery capability scanning.

package/dist/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AAEA;;GAEG;AAUH;;;GAGG;AACH,wBAAgB,mBAAmB,gEAElC;AAGD,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AAEA;;;GAGG;AA2EH;;;GAGG;AACH,wBAAgB,mBAAmB,gEAElC;AAGD,eAAe,mBAAmB,CAAC"}

package/dist/http.js

@@ -1,13 +1,69 @@
 #!/usr/bin/env node
 /**
  * HTTP entry point for Smithery hosted deployments.
+ * Compatible with ChatGPT Developer Mode and other MCP clients.
  */
 import { createServer as createHttpServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { createServer } from './server.js';
-import { loadConfig } from './utils/config.js';
-import { setDebug, info, error } from './utils/logger.js';
+import { loadConfig, setOAuthToken } from './utils/config.js';
+import { setDebug, info, error, debug } from './utils/logger.js';
 const PORT = parseInt(process.env.PORT || '3000', 10);
+// Load version from package.json
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let VERSION = '1.4.0';
+try {
+    const pkg = JSON.parse(readFileSync(resolve(__dirname, '../package.json'), 'utf-8'));
+    VERSION = pkg.version;
+}
+catch {
+    // Fallback to hardcoded version if package.json is not available (e.g., in bundled builds)
+}
+// ============================================================================
+// Rate Limiting (in-memory, 60 req/min per IP)
+// ============================================================================
+const RATE_LIMIT = 60;
+const RATE_WINDOW = 60000; // 1 minute
+const requestCounts = new Map();
+function getRateLimitKey(req) {
+    return (req.headers['x-forwarded-for']?.toString().split(',')[0]?.trim() ||
+        req.socket.remoteAddress ||
+        'unknown');
+}
+function isRateLimited(key) {
+    const now = Date.now();
+    const entry = requestCounts.get(key);
+    if (!entry || now > entry.resetAt) {
+        requestCounts.set(key, { count: 1, resetAt: now + RATE_WINDOW });
+        return { limited: false, remaining: RATE_LIMIT - 1, resetIn: RATE_WINDOW };
+    }
+    entry.count++;
+    const remaining = Math.max(0, RATE_LIMIT - entry.count);
+    const resetIn = entry.resetAt - now;
+    return { limited: entry.count > RATE_LIMIT, remaining, resetIn };
+}
+// Clean up old entries periodically (every 5 minutes)
+setInterval(() => {
+    const now = Date.now();
+    for (const [key, entry] of requestCounts.entries()) {
+        if (now > entry.resetAt) {
+            requestCounts.delete(key);
+        }
+    }
+}, 300000);
+// ============================================================================
+// CORS Headers (optional, for browser-based testing)
+// ============================================================================
+const CORS_HEADERS = {
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Methods': 'POST, GET, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+    Vary: 'Origin'
+};
 /**
  * Creates a sandbox server for Smithery capability scanning.
  * Default export as required by Smithery.
@@ -24,12 +80,46 @@ async function main() {
         info('Debug logging enabled');
     }
     const httpServer = createHttpServer(async (req, res) => {
+        // Generate request ID for log correlation
+        const requestId = randomUUID().slice(0, 8);
+        const clientIp = getRateLimitKey(req);
+        // Apply CORS headers to all responses
+        Object.entries(CORS_HEADERS).forEach(([key, value]) => res.setHeader(key, value));
+        // Handle CORS preflight
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        // Health check endpoint (no rate limiting)
         if (req.method === 'GET' && req.url === '/health') {
             res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ status: 'ok', version: '1.3.5' }));
+            res.end(JSON.stringify({ status: 'ok', version: VERSION }));
+            return;
+        }
+        // Rate limiting for MCP endpoint
+        const rateLimit = isRateLimited(clientIp);
+        res.setHeader('X-RateLimit-Limit', RATE_LIMIT.toString());
+        res.setHeader('X-RateLimit-Remaining', rateLimit.remaining.toString());
+        res.setHeader('X-RateLimit-Reset', Math.ceil(rateLimit.resetIn / 1000).toString());
+        if (rateLimit.limited) {
+            info(`[${requestId}] Rate limit exceeded for ${clientIp}`);
+            res.writeHead(429, { 'Content-Type': 'application/json', 'Retry-After': '60' });
+            res.end(JSON.stringify({ error: 'Rate limit exceeded. Try again in 60 seconds.' }));
             return;
         }
         if (req.method === 'POST' && req.url === '/mcp') {
+            info(`[${requestId}] MCP request from ${clientIp}`);
+            // Extract OAuth token from Authorization header (for ChatGPT integration)
+            const authHeader = req.headers['authorization'];
+            if (authHeader && authHeader.startsWith('Bearer ')) {
+                const token = authHeader.slice(7);
+                setOAuthToken(token);
+                debug(`[${requestId}] OAuth token extracted from Authorization header`);
+            }
+            else {
+                setOAuthToken(null);
+            }
             try {
                 let body = '';
                 for await (const chunk of req) {
@@ -44,12 +134,15 @@ async function main() {
                 res.on('finish', () => {
                     transport.close();
                     server.close();
+                    // Clear OAuth token after request
+                    setOAuthToken(null);
                 });
                 await server.connect(transport);
                 await transport.handleRequest(req, res, jsonBody);
             }
             catch (err) {
-                error('Error handling MCP request', err);
+                error(`[${requestId}] Error handling MCP request`, err);
+                setOAuthToken(null);
                 if (!res.headersSent) {
                     res.writeHead(500, { 'Content-Type': 'application/json' });
                     res.end(JSON.stringify({
@@ -61,6 +154,7 @@ async function main() {
             }
             return;
         }
+        info(`[${requestId}] 404 Not found: ${req.method} ${req.url}`);
         res.writeHead(404, { 'Content-Type': 'application/json' });
         res.end(JSON.stringify({ error: 'Not found' }));
     });

package/dist/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiHpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAsoBxC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8HpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAqrBxC"}

package/dist/server.js

@@ -7,16 +7,17 @@ import { compareTechsToolDefinition, executeCompareTechs, CompareTechsInputSchem
 import { recommendStackToolDefinition, executeRecommendStack, RecommendStackInputSchema } from './tools/recommend.js';
 import { getBlueprintToolDefinition, executeGetBlueprint, GetBlueprintInputSchema, createBlueprintToolDefinition, executeCreateBlueprint, CreateBlueprintInputSchema } from './tools/blueprint.js';
 import { recommendStackDemoToolDefinition, executeRecommendStackDemo, RecommendStackDemoInputSchema } from './tools/recommend-demo.js';
-import { setupApiKeyToolDefinition, executeSetupApiKey, SetupApiKeyInputSchema, listApiKeysToolDefinition, executeListApiKeys, revokeApiKeyToolDefinition, executeRevokeApiKey, RevokeApiKeyInputSchema } from './tools/api-keys.js';
+import { setupApiKeyToolDefinition, executeSetupApiKey, SetupApiKeyInputSchema, listApiKeysToolDefinition, executeListApiKeys, revokeApiKeyToolDefinition, executeRevokeApiKey, RevokeApiKeyInputSchema, createApiKeyToolDefinition, executeCreateApiKey, CreateApiKeyInputSchema } from './tools/api-keys.js';
 import { createAuditToolDefinition, executeCreateAudit, CreateAuditInputSchema, getAuditToolDefinition, executeGetAudit, GetAuditInputSchema, listAuditsToolDefinition, executeListAudits, ListAuditsInputSchema, compareAuditsToolDefinition, executeCompareAudits, CompareAuditsInputSchema, getAuditQuotaToolDefinition, executeGetAuditQuota, getMigrationRecommendationToolDefinition, executeGetMigrationRecommendation, GetMigrationRecommendationInputSchema } from './tools/audit.js';
 import { generateMCPKitTool, generateMCPKit, GenerateMCPKitInputSchema, analyzeRepoMcpsTool, analyzeRepo, AnalyzeRepoMCPsInputSchema, PRIORITIES, PROJECT_TYPES, SCALES } from './tools/project-kit/index.js';
 import { prepareMCPInstallationTool, prepareMCPInstallation } from './tools/project-kit/prepare-installation.js';
 import { executeMCPInstallationTool, executeMCPInstallation } from './tools/project-kit/execute-installation.js';
 import { PrepareMCPInstallationInputSchema, ExecuteMCPInstallationInputSchema } from './tools/project-kit/installation-types.js';
 import { checkCompatibilityToolDefinition, executeCheckCompatibility, CheckCompatibilityInputSchema } from './tools/check-compatibility.js';
+import { getWorkflowGuideToolDefinition, executeGetWorkflowGuide, GetWorkflowGuideInputSchema, WORKFLOW_GOALS, WORKFLOW_CONTEXTS, USER_TIERS } from './tools/workflow-guide.js';
 import { estimateProjectToolDefinition, executeEstimateProject, EstimateProjectInputSchema, getEstimateQuotaToolDefinition, executeGetEstimateQuota } from './tools/estimator.js';
 import { info, debug } from './utils/logger.js';
-import { listTechnologiesAnnotations, analyzeTechAnnotations, compareTechsAnnotations, recommendStackDemoAnnotations, recommendStackAnnotations, getBlueprintAnnotations, createBlueprintAnnotations, setupApiKeyAnnotations, listApiKeysAnnotations, revokeApiKeyAnnotations, createAuditAnnotations, getAuditAnnotations, listAuditsAnnotations, compareAuditsAnnotations, getAuditQuotaAnnotations, getMigrationRecommendationAnnotations, generateMcpKitAnnotations, analyzeRepoMcpsAnnotations, prepareMcpInstallationAnnotations, executeMcpInstallationAnnotations, checkCompatibilityAnnotations, estimateProjectAnnotations, getEstimateQuotaAnnotations } from './annotations.js';
+import { listTechnologiesAnnotations, analyzeTechAnnotations, compareTechsAnnotations, recommendStackDemoAnnotations, recommendStackAnnotations, getBlueprintAnnotations, createBlueprintAnnotations, setupApiKeyAnnotations, listApiKeysAnnotations, revokeApiKeyAnnotations, createApiKeyAnnotations, createAuditAnnotations, getAuditAnnotations, listAuditsAnnotations, compareAuditsAnnotations, getAuditQuotaAnnotations, getMigrationRecommendationAnnotations, generateMcpKitAnnotations, analyzeRepoMcpsAnnotations, prepareMcpInstallationAnnotations, executeMcpInstallationAnnotations, checkCompatibilityAnnotations, estimateProjectAnnotations, getEstimateQuotaAnnotations, getWorkflowGuideAnnotations } from './annotations.js';
 /**
  * Create and configure the MCP server.
  */
@@ -266,6 +267,23 @@ export function createServer() {
             isError
         };
     });
+    // Register create_api_key tool (OAuth-based, no email/password required)
+    server.registerTool(createApiKeyToolDefinition.name, {
+        title: 'Create API Key',
+        description: createApiKeyToolDefinition.description,
+        inputSchema: {
+            keyName: z.string().max(100).optional().describe('Optional name for the API key')
+        },
+        annotations: createApiKeyAnnotations
+    }, async (args) => {
+        debug('create_api_key called');
+        const input = CreateApiKeyInputSchema.parse(args);
+        const { text, isError } = await executeCreateApiKey(input);
+        return {
+            content: [{ type: 'text', text }],
+            isError
+        };
+    });
     // ========================================================================
     // AUDIT TOOLS (Technical Debt Analysis)
     // ========================================================================
@@ -488,6 +506,26 @@ export function createServer() {
             isError
         };
     });
+    // Register get_workflow_guide tool (local, FREE, no API key required)
+    server.registerTool(getWorkflowGuideToolDefinition.name, {
+        title: 'Get Workflow Guide',
+        description: getWorkflowGuideToolDefinition.description,
+        inputSchema: {
+            current_goal: z.enum(WORKFLOW_GOALS).optional().describe('What the user is trying to accomplish'),
+            completed_tools: z.array(z.string()).optional().describe('Tools already called in this session'),
+            user_tier: z.enum(USER_TIERS).optional().describe('User tier: free, pro, or unknown'),
+            known_constraints: z.array(z.string()).optional().describe('Constraints like must_use_postgresql'),
+            context: z.enum(WORKFLOW_CONTEXTS).optional().describe('Client context for adapted snippets')
+        },
+        annotations: getWorkflowGuideAnnotations
+    }, async (args) => {
+        debug('get_workflow_guide called', args);
+        const input = GetWorkflowGuideInputSchema.parse(args);
+        const { text } = executeGetWorkflowGuide(input);
+        return {
+            content: [{ type: 'text', text }]
+        };
+    });
     // ========================================================================
     // ESTIMATOR TOOLS (Project Scope & Pricing)
     // ========================================================================
@@ -510,7 +548,7 @@ export function createServer() {
                 .enum(['france', 'us', 'uk', 'remote-global'])
                 .optional()
                 .describe('Region for pricing (default: france)'),
-            includeMarket: z.boolean().optional().describe('Include market analysis (default: true, Pro tier only)')
+            includeMarket: z.boolean().optional().describe('Include market analysis (default: true)')
         },
         annotations: estimateProjectAnnotations
     }, async (args) => {
@@ -536,7 +574,7 @@ export function createServer() {
             isError
         };
     });
-    info('Registered 23 tools: list_technologies, analyze_tech, compare_techs, recommend_stack_demo, recommend_stack, get_blueprint, create_blueprint, setup_api_key, list_api_keys, revoke_api_key, create_audit, get_audit, list_audits, compare_audits, get_audit_quota, get_migration_recommendation, generate_mcp_kit, analyze_repo_mcps, prepare_mcp_installation, execute_mcp_installation, check_mcp_compatibility, estimate_project, get_estimate_quota');
+    info('Registered 25 tools: list_technologies, analyze_tech, compare_techs, recommend_stack_demo, recommend_stack, get_blueprint, create_blueprint, setup_api_key, list_api_keys, revoke_api_key, create_api_key, create_audit, get_audit, list_audits, compare_audits, get_audit_quota, get_migration_recommendation, generate_mcp_kit, analyze_repo_mcps, prepare_mcp_installation, execute_mcp_installation, check_mcp_compatibility, get_workflow_guide, estimate_project, get_estimate_quota');
     return server;
 }
 // ============================================================================