stock-scanner-mcp 1.16.1 → 1.16.2

package/README.md

@@ -393,11 +393,17 @@ Any MCP client that supports stdio servers can run this package. Use the same JS
 
 ## HTTP Sidecar
 
-An optional HTTP server exposing all tools as REST endpoints for non-MCP integrations (trading bots, chat UIs, LLM pipelines).
+An optional HTTP server exposing all tools as REST endpoints for non-MCP integrations (GPT Actions, chat UIs, LLM pipelines). It includes an **OpenAPI 3.1** specification for automated tool discovery.
 
 ```bash
 npx stock-scanner-sidecar              # Start on port 3200
 npx stock-scanner-sidecar --port 8080  # Custom port
+
+# Access the OpenAPI spec
+curl http://localhost:3200/openapi.json
+```
+
+See [Sidecar HTTP API](wiki-repo/Sidecar-HTTP-API.md) for endpoint details.
 ```
 
 55 endpoints including `/tradingview/quote`, `/options/chain`, `/frankfurter/convert`, and more. See [wiki](https://github.com/yyordanov-tradu/stock-scanner-mcp/wiki/Sidecar-HTTP-API) for the full route table.

package/dist/sidecar/index.js

@@ -43,6 +43,11 @@ import {
 
 // src/sidecar/server.ts
 import * as http from "http";
+import { readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
 var SYMBOL_RE = /^[A-Z][A-Z0-9._-]{0,19}$/i;
 var MAX_BODY_BYTES = 1024 * 1024;
 var LOCALHOST_ORIGINS = /* @__PURE__ */ new Set(["http://localhost", "http://127.0.0.1"]);
@@ -128,6 +133,16 @@ function createServer2(config) {
         json(res, req, 200, { status: "ok" });
         return;
       }
+      if (path === "/openapi.json" && req.method === "GET") {
+        try {
+          const specPath = join(__dirname, "../../docs/sidecar-openapi.json");
+          const spec = JSON.parse(readFileSync(specPath, "utf-8"));
+          json(res, req, 200, spec);
+        } catch (e) {
+          json(res, req, 404, { error: "OpenAPI specification not found" });
+        }
+        return;
+      }
       if (path === "/tradingview/scan" && req.method === "POST") {
         const body = await parseBody(req);
         if (typeof body !== "object" || body === null || Array.isArray(body)) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stock-scanner-mcp",
   "mcpName": "io.github.yyordanov-tradu/stock-scanner-mcp",
-  "version": "1.16.1",
+  "version": "1.16.2",
   "description": "MCP server providing Claude Code with real-time stock and crypto market data, SEC filings, insider trades, and technical analysis",
   "type": "module",
   "bin": {
@@ -10,11 +10,12 @@
     "stock-scanner-sidecar": "./dist/sidecar/index.js"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/install-skills.ts src/sidecar/index.ts --format esm --dts --clean",
+    "build": "npm run generate-openapi && tsup src/index.ts src/install-skills.ts src/sidecar/index.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts --format esm --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
+    "generate-openapi": "tsx src/scripts/generate-sidecar-openapi.ts",
     "validate-tools": "tsx src/scripts/validate-tools.ts",
     "validate-structure": "tsx src/scripts/validate-structure.ts",
     "prepublishOnly": "npm run build && npm test"