stock-scanner-mcp 1.16.0 → 1.16.2

package/README.md

@@ -6,7 +6,7 @@
 
 A modular MCP server for Claude Code and Claude Desktop that provides real-time access to stock and crypto market data. Scan markets, check technicals, monitor insider trades, track earnings, analyze options flow, and optionally save your own watchlists and thesis notes from one server.
 
-**61 tools** across **12 modules** — 9 modules work with zero API keys, including an optional stateful Market Workspace.
+**64 tools** across **13 modules** — 9 modules work with zero API keys, including an optional stateful Market Workspace.
 
 ## Quick Start
 
@@ -35,7 +35,7 @@ Copy this complete config block into your config file:
 }
 ```
 
-This gives you **43 tools** immediately with no API keys. API keys are optional and free — they unlock 18 additional tools for real-time quotes, news, earnings, and economic data. See [API Keys](#api-keys-optional) below for where to get them.
+This gives you **46 tools** immediately with no API keys. API keys are optional and free — they unlock 18 additional tools for real-time quotes, news, earnings, and economic data. See [API Keys](#api-keys-optional) below for where to get them.
 
 > **Minimal config** — if you don't want workspace or API keys, use this instead:
 > ```json
@@ -48,7 +48,7 @@ This gives you **43 tools** immediately with no API keys. API keys are optional
 >   }
 > }
 > ```
-> This gives you **36 stateless tools** with no local data storage.
+> This gives you **39 stateless tools** with no local data storage.
 
 Restart Claude Desktop after saving. Claude Code picks up the config automatically.
 
@@ -97,7 +97,7 @@ Once answered, it saves your profile and creates a `core` watchlist:
 
 You can also skip the skill and ask Claude directly: *"Set up my workspace — I'm a swing trader, create a core watchlist with MARA, HOOD, BTC, daily reviews."*
 
-**That's it.** You now have 61 tools, 19 skills, and a personalized workspace. Try `/workspace-morning-brief` for your first tailored market scan.
+**That's it.** You now have 64 tools, 19 skills, and a personalized workspace. Try `/workspace-morning-brief` for your first tailored market scan.
 
 ## What You Can Do
 
@@ -220,6 +220,7 @@ For the full list of workspace tools, see the [tool reference](#workspace--perso
 | options-cboe | 1 | None | CBOE put/call ratio sentiment indicator |
 | sentiment | 2 | None | CNN Fear & Greed Index, Crypto Fear & Greed Index |
 | frankfurter | 5 | None | Forex exchange rates — 31 currencies from ECB (daily reference rates) |
+| reddit | 3 | None | Reddit trending tickers, mention tracking, and sentiment from r/wallstreetbets, r/stocks, r/investing, r/options |
 | workspace | 7 | None | Optional stateful profile, watchlists, and thesis tracking for personalized workflows (`--enable-workspace`) |
 | finnhub | 9 | `FINNHUB_API_KEY` | Quotes, news, earnings, analyst ratings, short interest |
 | alpha-vantage | 5 | `ALPHA_VANTAGE_API_KEY` | Quotes, daily prices, fundamentals, earnings, dividends |
@@ -227,9 +228,9 @@ For the full list of workspace tools, see the [tool reference](#workspace--perso
 
 Modules auto-enable when their API key is set. No-key modules are always enabled, except `workspace`, which requires `--enable-workspace`.
 
-For a complete list of every tool with descriptions, see the [Full Tool Reference](#full-tool-reference-61-tools) below.
+For a complete list of every tool with descriptions, see the [Full Tool Reference](#full-tool-reference-64-tools) below.
 
-## Full Tool Reference (61 tools)
+## Full Tool Reference (64 tools)
 
 ### TradingView — Stock Scanning (no API key)
 
@@ -307,6 +308,14 @@ For a complete list of every tool with descriptions, see the [Full Tool Referenc
 | `frankfurter_convert` | Convert an amount between two currencies |
 | `frankfurter_currencies` | List all supported currency codes |
 
+### Reddit — Trending Tickers & Sentiment (no API key)
+
+| Tool | Description |
+|------|-------------|
+| `reddit_trending` | Trending stock tickers from Reddit by mention frequency across r/wallstreetbets, r/stocks, r/investing, r/options |
+| `reddit_mentions` | Mention count and top posts for a specific ticker across Reddit investing subreddits |
+| `reddit_sentiment` | Keyword-based sentiment analysis (bullish/bearish/neutral) for a ticker from Reddit discussions |
+
 ### Workspace — Personalized Context (optional, no API key)
 
 Enabled only when you start the server with `--enable-workspace`.
@@ -384,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.
@@ -443,7 +458,8 @@ src/
 │   ├── alpha-vantage/    # 5 tools — quotes, fundamentals, dividends
 │   ├── fred/             # 4 tools — economic calendar, indicators, historical data
 │   ├── sentiment/        # 2 tools — Fear & Greed indexes (market + crypto)
-│   └── frankfurter/      # 5 tools — forex exchange rates (ECB, 31 currencies)
+│   ├── frankfurter/      # 5 tools — forex exchange rates (ECB, 31 currencies)
+│   └── reddit/           # 3 tools — trending tickers, mentions, sentiment from Reddit
 ├── sidecar/
 │   ├── index.ts          # HTTP sidecar entry point (port 3200)
 │   └── server.ts         # HTTP request handler (55 endpoints)

package/dist/{chunk-HAYAISNP.js → chunk-T5IF6777.js}

@@ -1602,9 +1602,11 @@ async function getCurrencies() {
 export {
   errorResult,
   successResult,
+  httpGet,
   scanStocks,
   resolveTicker,
   scanCrypto,
+  TtlCache,
   searchFilings,
   getCompanyFilings,
   getCompanyFacts,

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   runInstallSkills
 } from "./chunk-YEZEE6FS.js";
 import {
+  TtlCache,
   convertCurrency,
   errorResult,
   fetchOptionChain,
@@ -38,13 +39,14 @@ import {
   getShortInterest,
   getTimeSeries,
   getTrending,
+  httpGet,
   resolveTicker,
   scanCrypto,
   scanStocks,
   searchFilings,
   searchSeries,
   successResult
-} from "./chunk-HAYAISNP.js";
+} from "./chunk-T5IF6777.js";
 
 // src/index.ts
 import { readFileSync } from "fs";
@@ -52,7 +54,7 @@ import { fileURLToPath } from "url";
 import { dirname as dirname2, join as join2 } from "path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 
 // src/config.ts
 import * as path from "path";
@@ -1454,8 +1456,601 @@ function createFrankfurterModule() {
   };
 }
 
+// src/modules/reddit/index.ts
+import { z as z12 } from "zod";
+
+// src/modules/reddit/client.ts
+var REDDIT_BASE = "https://www.reddit.com";
+var REDDIT_HEADERS = {
+  "User-Agent": "stock-scanner-mcp/1.0 (by /u/stock-scanner-bot)"
+};
+var DEFAULT_SUBREDDITS = [
+  "wallstreetbets",
+  "stocks",
+  "investing",
+  "options"
+];
+var trendingCache = new TtlCache(5 * 60 * 1e3);
+var mentionCache = new TtlCache(2 * 60 * 1e3);
+var STOP_WORDS = /* @__PURE__ */ new Set([
+  // 1-2 letter
+  "I",
+  "A",
+  "AM",
+  "AN",
+  "AS",
+  "AT",
+  "BE",
+  "BY",
+  "DO",
+  "GO",
+  "HE",
+  "IF",
+  "IN",
+  "IS",
+  "IT",
+  "ME",
+  "MY",
+  "NO",
+  "OF",
+  "OK",
+  "ON",
+  "OR",
+  "SO",
+  "TO",
+  "UP",
+  "US",
+  "WE",
+  // 3 letter common English
+  "ALL",
+  "AND",
+  "ANY",
+  "ARE",
+  "BAD",
+  "BIG",
+  "BUT",
+  "CAN",
+  "DAY",
+  "DID",
+  "END",
+  "FAR",
+  "FEW",
+  "FOR",
+  "GET",
+  "GOD",
+  "GOT",
+  "GUY",
+  "HAS",
+  "HAD",
+  "HER",
+  "HIM",
+  "HIS",
+  "HOW",
+  "ITS",
+  "JOB",
+  "LET",
+  "LOT",
+  "MAN",
+  "MAY",
+  "MEN",
+  "MOM",
+  "NEW",
+  "NOT",
+  "NOW",
+  "OLD",
+  "ONE",
+  "OUR",
+  "OUT",
+  "OWN",
+  "PUT",
+  "RAN",
+  "RUN",
+  "SAT",
+  "SAY",
+  "SET",
+  "SHE",
+  "SIT",
+  "THE",
+  "TOO",
+  "TOP",
+  "TRY",
+  "TWO",
+  "USE",
+  "WAR",
+  "WAS",
+  "WAY",
+  "WHO",
+  "WHY",
+  "WIN",
+  "WON",
+  "YES",
+  "YET",
+  "YOU",
+  // 4 letter common English
+  "ALSO",
+  "BACK",
+  "BEEN",
+  "BEST",
+  "BODY",
+  "BOTH",
+  "CALL",
+  "CAME",
+  "COME",
+  "DARK",
+  "DAYS",
+  "DEAD",
+  "DOES",
+  "DONE",
+  "DOWN",
+  "EACH",
+  "EVEN",
+  "EVER",
+  "EYES",
+  "FACE",
+  "FACT",
+  "FEEL",
+  "FIND",
+  "FOUR",
+  "FROM",
+  "FULL",
+  "GAVE",
+  "GIVE",
+  "GOOD",
+  "HALF",
+  "HAND",
+  "HARD",
+  "HAVE",
+  "HEAD",
+  "HEAR",
+  "HELP",
+  "HERE",
+  "HIGH",
+  "HOME",
+  "HOPE",
+  "IDEA",
+  "INTO",
+  "JUST",
+  "KEEP",
+  "KIND",
+  "KNEW",
+  "KNOW",
+  "LAND",
+  "LAST",
+  "LEFT",
+  "LESS",
+  "LIFE",
+  "LIKE",
+  "LINE",
+  "LIST",
+  "LIVE",
+  "LONG",
+  "LOOK",
+  "LOST",
+  "LOVE",
+  "MADE",
+  "MAKE",
+  "MANY",
+  "MIND",
+  "MORE",
+  "MOST",
+  "MUCH",
+  "MUST",
+  "NAME",
+  "NEED",
+  "NEWS",
+  "NEXT",
+  "NICE",
+  "NONE",
+  "ONCE",
+  "ONLY",
+  "OPEN",
+  "OVER",
+  "PAID",
+  "PART",
+  "PAST",
+  "PLAN",
+  "PLAY",
+  "POST",
+  "PULL",
+  "PUSH",
+  "RATE",
+  "READ",
+  "REAL",
+  "REST",
+  "RISK",
+  "ROOM",
+  "SAFE",
+  "SAID",
+  "SAME",
+  "SEEN",
+  "SHOW",
+  "SIDE",
+  "SOME",
+  "SOON",
+  "STOP",
+  "SUCH",
+  "SURE",
+  "TAKE",
+  "TALK",
+  "TELL",
+  "THAN",
+  "THAT",
+  "THEM",
+  "THEN",
+  "THEY",
+  "THIS",
+  "TIME",
+  "TOOK",
+  "TRUE",
+  "TURN",
+  "UPON",
+  "VERY",
+  "WANT",
+  "WEEK",
+  "WELL",
+  "WENT",
+  "WERE",
+  "WHAT",
+  "WHEN",
+  "WILL",
+  "WITH",
+  "WORD",
+  "WORK",
+  "YEAR",
+  "YOUR",
+  // 5 letter common English
+  "ABOUT",
+  "AFTER",
+  "AGAIN",
+  "BEING",
+  "BELOW",
+  "BLACK",
+  "BRING",
+  "COULD",
+  "EARLY",
+  "EVERY",
+  "FIRST",
+  "GREAT",
+  "GREEN",
+  "HEARD",
+  "HOUSE",
+  "LARGE",
+  "LATER",
+  "LEARN",
+  "LEVEL",
+  "LIGHT",
+  "MIGHT",
+  "MONEY",
+  "MONTH",
+  "NEVER",
+  "NIGHT",
+  "OTHER",
+  "PLACE",
+  "POINT",
+  "POWER",
+  "PRICE",
+  "RIGHT",
+  "SHALL",
+  "SINCE",
+  "SMALL",
+  "SORRY",
+  "STAND",
+  "START",
+  "STATE",
+  "STILL",
+  "STUDY",
+  "THEIR",
+  "THERE",
+  "THESE",
+  "THING",
+  "THINK",
+  "THREE",
+  "TODAY",
+  "UNDER",
+  "UNTIL",
+  "WATER",
+  "WHERE",
+  "WHICH",
+  "WHITE",
+  "WHILE",
+  "WHOLE",
+  "WORLD",
+  "WOULD",
+  "WRITE",
+  "YOUNG",
+  // Finance acronyms that aren't tickers
+  "ETF",
+  "IPO",
+  "SEC",
+  "GDP",
+  "FDA",
+  "FED",
+  "CEO",
+  "CFO",
+  "COO",
+  "CTO",
+  "ATH",
+  "ATL",
+  "EOD",
+  "WSB",
+  "OTC",
+  "ITM",
+  "OTM",
+  "IMO",
+  "LOL",
+  "OMG",
+  "USA",
+  "NYSE",
+  "YOLO",
+  "FOMO",
+  "HODL",
+  "MOASS",
+  "TLDR",
+  "IMHO",
+  "LMAO",
+  "EDIT",
+  "TLDR",
+  "INFO",
+  "HUGE",
+  "GAIN",
+  "HOLD",
+  "SELL",
+  "MOON",
+  "CASH",
+  "DEBT",
+  "FUND",
+  "BEAR",
+  "BULL",
+  "BOND",
+  "LOAN",
+  "LOSS",
+  "PUMP",
+  "DUMP",
+  "LONG",
+  "MAMA",
+  "PAPA",
+  "FREE",
+  "ZERO",
+  "PLUS"
+]);
+var CASHTAG_RE = /\$([A-Z]{2,5})\b/g;
+var BARE_TICKER_RE = /\b([A-Z]{2,5})\b/g;
+function extractTickers(text) {
+  const tickers = /* @__PURE__ */ new Set();
+  let match;
+  CASHTAG_RE.lastIndex = 0;
+  while ((match = CASHTAG_RE.exec(text)) !== null) {
+    const ticker = match[1];
+    if (!STOP_WORDS.has(ticker)) {
+      tickers.add(ticker);
+    }
+  }
+  BARE_TICKER_RE.lastIndex = 0;
+  while ((match = BARE_TICKER_RE.exec(text)) !== null) {
+    const word = match[1];
+    if (!STOP_WORDS.has(word)) {
+      tickers.add(word);
+    }
+  }
+  return [...tickers];
+}
+var BULLISH_TERMS = [
+  "bull",
+  "calls",
+  "long",
+  "moon",
+  "rocket",
+  "tendies",
+  "diamond hands",
+  "buy",
+  "buying",
+  "bought",
+  "dip",
+  "undervalued",
+  "breakout",
+  "squeeze",
+  "gamma",
+  "rip",
+  "printing",
+  "lambo",
+  "gains",
+  "green",
+  "upside"
+];
+var BEARISH_TERMS = [
+  "bear",
+  "puts",
+  "short",
+  "dump",
+  "crash",
+  "sell",
+  "selling",
+  "sold",
+  "overvalued",
+  "bubble",
+  "bag",
+  "bagholder",
+  "red",
+  "loss",
+  "losses",
+  "downside",
+  "drill",
+  "tank",
+  "fade",
+  "rug",
+  "rekt",
+  "worthless"
+];
+function scoreSentiment(text) {
+  const lower = text.toLowerCase();
+  let score = 0;
+  for (const term of BULLISH_TERMS) {
+    if (lower.includes(term)) score += 1;
+  }
+  for (const term of BEARISH_TERMS) {
+    if (lower.includes(term)) score -= 1;
+  }
+  return score;
+}
+async function fetchSubredditPosts(subreddit, query, timeFilter, limit = 25) {
+  const url = `${REDDIT_BASE}/r/${encodeURIComponent(subreddit)}/search.json?q=${encodeURIComponent(query)}&sort=new&restrict_sr=on&t=${encodeURIComponent(timeFilter)}&limit=${encodeURIComponent(String(limit))}`;
+  const listing = await httpGet(url, {
+    headers: REDDIT_HEADERS
+  });
+  return listing.data.children.map((child) => ({
+    title: child.data.title,
+    selftext: child.data.selftext,
+    score: child.data.score,
+    numComments: child.data.num_comments,
+    createdUtc: child.data.created_utc,
+    permalink: child.data.permalink,
+    subreddit: child.data.subreddit
+  }));
+}
+async function getTrendingTickers(subreddits = DEFAULT_SUBREDDITS, limit = 20) {
+  const cacheKey = `trending:${[...subreddits].sort().join(",")}:${limit}`;
+  const cached = trendingCache.get(cacheKey);
+  if (cached) return cached;
+  const tickerMap = /* @__PURE__ */ new Map();
+  for (const sub of subreddits) {
+    let posts;
+    try {
+      posts = await fetchSubredditPosts(sub, "stocks OR market OR trading", "week");
+    } catch {
+      continue;
+    }
+    for (const post of posts) {
+      const text = `${post.title} ${post.selftext}`;
+      const tickers = extractTickers(text);
+      for (const ticker of tickers) {
+        const existing = tickerMap.get(ticker) ?? { mentions: 0, subreddits: {} };
+        existing.mentions += 1;
+        existing.subreddits[sub] = (existing.subreddits[sub] ?? 0) + 1;
+        tickerMap.set(ticker, existing);
+      }
+    }
+  }
+  const result = [...tickerMap.entries()].map(([symbol, data]) => ({ symbol, mentions: data.mentions, subreddits: data.subreddits })).sort((a, b) => b.mentions - a.mentions).slice(0, limit);
+  trendingCache.set(cacheKey, result);
+  return result;
+}
+async function getTickerMentions(symbol, period = "week") {
+  const cacheKey = `mentions:${symbol}:${period}`;
+  const cached = mentionCache.get(cacheKey);
+  if (cached) return cached;
+  const subredditCounts = {};
+  const allPosts = [];
+  for (const sub of DEFAULT_SUBREDDITS) {
+    let posts;
+    try {
+      posts = await fetchSubredditPosts(sub, symbol, period);
+    } catch {
+      continue;
+    }
+    subredditCounts[sub] = posts.length;
+    allPosts.push(...posts);
+  }
+  const topPosts = allPosts.sort((a, b) => b.score - a.score).slice(0, 10);
+  const result = {
+    symbol,
+    totalMentions: allPosts.length,
+    subreddits: subredditCounts,
+    topPosts
+  };
+  mentionCache.set(cacheKey, result);
+  return result;
+}
+async function getTickerSentiment(symbol, limit = 50) {
+  const cacheKey = `sentiment:${symbol}:${limit}`;
+  const cached = mentionCache.get(cacheKey);
+  if (cached) return cached;
+  const allPosts = [];
+  for (const sub of DEFAULT_SUBREDDITS) {
+    let posts;
+    try {
+      posts = await fetchSubredditPosts(sub, symbol, "week", limit);
+    } catch {
+      continue;
+    }
+    allPosts.push(...posts);
+  }
+  let bullishCount = 0;
+  let bearishCount = 0;
+  let neutralCount = 0;
+  let totalScore = 0;
+  const scored = allPosts.map((post) => {
+    const text = `${post.title} ${post.selftext}`;
+    const sentimentScore = scoreSentiment(text);
+    totalScore += sentimentScore;
+    if (sentimentScore > 0) bullishCount += 1;
+    else if (sentimentScore < 0) bearishCount += 1;
+    else neutralCount += 1;
+    return { ...post, sentimentScore };
+  });
+  const samplePosts = scored.sort((a, b) => Math.abs(b.sentimentScore) - Math.abs(a.sentimentScore)).slice(0, 10);
+  const result = {
+    symbol,
+    bullishCount,
+    bearishCount,
+    neutralCount,
+    averageScore: allPosts.length > 0 ? totalScore / allPosts.length : 0,
+    samplePosts
+  };
+  mentionCache.set(cacheKey, result);
+  return result;
+}
+
+// src/modules/reddit/index.ts
+var trendingTool2 = {
+  name: "reddit_trending",
+  description: "Get trending stock tickers from Reddit based on mention frequency. Scans r/wallstreetbets, r/stocks, r/investing, and r/options for posts mentioning tickers. Returns tickers sorted by mention count with per-subreddit breakdown. Limitation: uses keyword extraction (cashtags + uppercase words), not NLP \u2014 some false positives possible. Best for gauging retail buzz, not precise sentiment.",
+  inputSchema: z12.object({
+    subreddits: z12.array(z12.string()).max(10).optional().describe("Subreddits to scan (default: wallstreetbets, stocks, investing, options)"),
+    limit: z12.number().min(1).max(50).default(20).describe("Maximum number of trending tickers to return (default: 20)")
+  }),
+  readOnly: true,
+  handler: withMetadata(async (args) => {
+    const result = await getTrendingTickers(args.subreddits ?? [...DEFAULT_SUBREDDITS], args.limit ?? 20);
+    return successResult(JSON.stringify(result, null, 2));
+  }, { source: "reddit", dataDelay: "real-time" })
+};
+var mentionsTool = {
+  name: "reddit_mentions",
+  description: "Get mention count and top posts for a specific stock ticker across Reddit. Searches r/wallstreetbets, r/stocks, r/investing, and r/options. Returns total mentions, per-subreddit breakdown, and top 10 posts by score. Use this to check how much retail attention a ticker is getting.",
+  inputSchema: z12.object({
+    symbol: z12.string().max(10).describe("Stock ticker symbol (e.g. AAPL, TSLA, GME)"),
+    period: z12.enum(["hour", "day", "week"]).default("day").describe("Time period to search (default: day)")
+  }),
+  readOnly: true,
+  handler: withMetadata(async (args) => {
+    const result = await getTickerMentions(args.symbol.toUpperCase(), args.period ?? "day");
+    return successResult(JSON.stringify(result, null, 2));
+  }, { source: "reddit", dataDelay: "real-time" })
+};
+var sentimentTool = {
+  name: "reddit_sentiment",
+  description: "Get sentiment analysis for a stock ticker from Reddit discussions. Searches r/wallstreetbets, r/stocks, r/investing, and r/options, then scores each post using keyword matching (bullish terms like 'moon', 'calls', 'breakout' vs bearish terms like 'crash', 'puts', 'dump'). Returns bullish/bearish/neutral counts, average sentiment score, and sample posts. Limitation: keyword-based scoring, not NLP \u2014 sarcasm and context may be missed.",
+  inputSchema: z12.object({
+    symbol: z12.string().max(10).describe("Stock ticker symbol (e.g. AAPL, TSLA, GME)"),
+    limit: z12.number().min(1).max(100).default(50).describe("Maximum posts to analyze per subreddit (default: 50)")
+  }),
+  readOnly: true,
+  handler: withMetadata(async (args) => {
+    const result = await getTickerSentiment(args.symbol.toUpperCase(), args.limit ?? 50);
+    return successResult(JSON.stringify(result, null, 2));
+  }, { source: "reddit", dataDelay: "real-time" })
+};
+function createRedditModule() {
+  return {
+    name: "reddit",
+    description: "Reddit sentiment \u2014 trending tickers, mention tracking, and sentiment analysis from popular investing subreddits",
+    requiredEnvVars: [],
+    tools: [trendingTool2, mentionsTool, sentimentTool]
+  };
+}
+
 // src/modules/workspace/index.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 
 // src/modules/workspace/storage.ts
 import * as fs from "fs/promises";
@@ -1463,57 +2058,57 @@ import * as path2 from "path";
 import { lock } from "proper-lockfile";
 
 // src/modules/workspace/types.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 var RESERVED_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype", "toString", "valueOf", "hasOwnProperty"]);
-var ProfileSchema = z12.object({
-  defaultExchange: z12.string().max(20).default("NASDAQ"),
-  tradingStyle: z12.string().max(100).optional(),
-  assetFocus: z12.array(z12.string().max(50)).max(20).default([]),
-  preferredTimeframe: z12.string().max(50).optional(),
-  workflowCadence: z12.enum(["daily", "weekly"]).default("daily"),
-  updatedAt: z12.string().default(() => (/* @__PURE__ */ new Date(0)).toISOString())
+var ProfileSchema = z13.object({
+  defaultExchange: z13.string().max(20).default("NASDAQ"),
+  tradingStyle: z13.string().max(100).optional(),
+  assetFocus: z13.array(z13.string().max(50)).max(20).default([]),
+  preferredTimeframe: z13.string().max(50).optional(),
+  workflowCadence: z13.enum(["daily", "weekly"]).default("daily"),
+  updatedAt: z13.string().default(() => (/* @__PURE__ */ new Date(0)).toISOString())
 });
-var InstrumentSchema = z12.object({
-  full: z12.string().max(80),
-  ticker: z12.string().max(50),
-  exchange: z12.string().optional(),
-  isCrypto: z12.boolean(),
-  input: z12.string().max(50),
-  note: z12.string().max(500).optional(),
-  addedAt: z12.string()
+var InstrumentSchema = z13.object({
+  full: z13.string().max(80),
+  ticker: z13.string().max(50),
+  exchange: z13.string().optional(),
+  isCrypto: z13.boolean(),
+  input: z13.string().max(50),
+  note: z13.string().max(500).optional(),
+  addedAt: z13.string()
 });
-var WatchlistSchema = z12.object({
-  id: z12.string().max(100),
-  name: z12.string().max(100),
-  instruments: z12.array(InstrumentSchema).max(200).default([]),
-  createdAt: z12.string(),
-  updatedAt: z12.string()
+var WatchlistSchema = z13.object({
+  id: z13.string().max(100),
+  name: z13.string().max(100),
+  instruments: z13.array(InstrumentSchema).max(200).default([]),
+  createdAt: z13.string(),
+  updatedAt: z13.string()
 });
-var ThesisSchema = z12.object({
-  full: z12.string().max(80),
-  ticker: z12.string().max(50),
-  exchange: z12.string().optional(),
-  isCrypto: z12.boolean(),
-  input: z12.string().max(50),
-  summary: z12.string().max(5e3),
-  bullCase: z12.string().max(2e3).optional(),
-  bearCase: z12.string().max(2e3).optional(),
-  catalyst: z12.string().max(2e3).optional(),
-  invalidation: z12.string().max(2e3).optional(),
-  timeframe: z12.string().max(100).optional(),
-  nextReviewDate: z12.string().optional(),
-  confidence: z12.number().min(0).max(5).optional(),
-  updatedAt: z12.string(),
-  archivedAt: z12.string().optional()
+var ThesisSchema = z13.object({
+  full: z13.string().max(80),
+  ticker: z13.string().max(50),
+  exchange: z13.string().optional(),
+  isCrypto: z13.boolean(),
+  input: z13.string().max(50),
+  summary: z13.string().max(5e3),
+  bullCase: z13.string().max(2e3).optional(),
+  bearCase: z13.string().max(2e3).optional(),
+  catalyst: z13.string().max(2e3).optional(),
+  invalidation: z13.string().max(2e3).optional(),
+  timeframe: z13.string().max(100).optional(),
+  nextReviewDate: z13.string().optional(),
+  confidence: z13.number().min(0).max(5).optional(),
+  updatedAt: z13.string(),
+  archivedAt: z13.string().optional()
 });
-var WorkspaceSchema = z12.object({
-  schemaVersion: z12.number().default(1),
+var WorkspaceSchema = z13.object({
+  schemaVersion: z13.number().default(1),
   profile: ProfileSchema.default(() => ProfileSchema.parse({})),
-  watchlists: z12.record(z12.string(), WatchlistSchema).refine(
+  watchlists: z13.record(z13.string(), WatchlistSchema).refine(
     (rec) => Object.keys(rec).every((k) => !RESERVED_KEYS.has(k)),
     { message: "Workspace contains a reserved key in watchlists" }
   ).default({}),
-  theses: z12.record(z12.string(), ThesisSchema).refine(
+  theses: z13.record(z13.string(), ThesisSchema).refine(
     (rec) => Object.keys(rec).every((k) => !RESERVED_KEYS.has(k)),
     { message: "Workspace contains a reserved key in theses" }
   ).default({})
@@ -1645,7 +2240,7 @@ function createWorkspaceModule(dataDir, defaultExchange = "NASDAQ") {
       {
         name: "workspace_get_profile",
         description: "Get the current user's trading profile and workspace settings.",
-        inputSchema: z13.object({}),
+        inputSchema: z14.object({}),
         readOnly: true,
         openWorld: false,
         handler: withMetadata(async () => {
@@ -1656,10 +2251,10 @@ function createWorkspaceModule(dataDir, defaultExchange = "NASDAQ") {
       {
         name: "workspace_update_profile",
         description: "Update the user's trading profile (style, asset focus, review cadence).",
-        inputSchema: z13.object({
-          tradingStyle: z13.string().max(100).optional().describe("E.g., 'options', 'swing', 'day'"),
-          assetFocus: z13.array(z13.string().max(50)).max(20).optional().describe("Asset classes like 'equities', 'crypto'"),
-          workflowCadence: z13.enum(["daily", "weekly"]).optional()
+        inputSchema: z14.object({
+          tradingStyle: z14.string().max(100).optional().describe("E.g., 'options', 'swing', 'day'"),
+          assetFocus: z14.array(z14.string().max(50)).max(20).optional().describe("Asset classes like 'equities', 'crypto'"),
+          workflowCadence: z14.enum(["daily", "weekly"]).optional()
         }),
         readOnly: false,
         openWorld: false,
@@ -1687,7 +2282,7 @@ function createWorkspaceModule(dataDir, defaultExchange = "NASDAQ") {
       {
         name: "workspace_list_watchlists",
         description: "List all watchlists and their instruments.",
-        inputSchema: z13.object({}),
+        inputSchema: z14.object({}),
         readOnly: true,
         openWorld: false,
         handler: withMetadata(async () => {
@@ -1698,8 +2293,8 @@ function createWorkspaceModule(dataDir, defaultExchange = "NASDAQ") {
       {
         name: "workspace_create_watchlist",
         description: "Create a new empty watchlist (max 50 per workspace).",
-        inputSchema: z13.object({
-          name: z13.string().max(100).describe("The ID/name of the watchlist (e.g., 'core', 'swing')")
+        inputSchema: z14.object({
+          name: z14.string().max(100).describe("The ID/name of the watchlist (e.g., 'core', 'swing')")
         }),
         readOnly: false,
         openWorld: false,
@@ -1738,9 +2333,9 @@ function createWorkspaceModule(dataDir, defaultExchange = "NASDAQ") {
       {
         name: "workspace_update_watchlist",
         description: "Replace the instruments in a specific watchlist.",
-        inputSchema: z13.object({
-          name: z13.string().max(100).describe("The ID of the watchlist to update"),
-          symbols: z13.array(z13.string().max(50)).max(200).describe("Raw symbols to track (e.g., ['AAPL', 'BTC'])")
+        inputSchema: z14.object({
+          name: z14.string().max(100).describe("The ID of the watchlist to update"),
+          symbols: z14.array(z14.string().max(50)).max(200).describe("Raw symbols to track (e.g., ['AAPL', 'BTC'])")
         }),
         readOnly: false,
         openWorld: false,
@@ -1787,8 +2382,8 @@ function createWorkspaceModule(dataDir, defaultExchange = "NASDAQ") {
       {
         name: "workspace_get_thesis",
         description: "Get the saved global investment thesis for a specific symbol. Returns a stable JSON shape with a 'found' flag.",
-        inputSchema: z13.object({
-          symbol: z13.string().max(50).describe("The raw symbol (e.g., 'AAPL')")
+        inputSchema: z14.object({
+          symbol: z14.string().max(50).describe("The raw symbol (e.g., 'AAPL')")
         }),
         readOnly: true,
         openWorld: false,
@@ -1806,13 +2401,13 @@ function createWorkspaceModule(dataDir, defaultExchange = "NASDAQ") {
       {
         name: "workspace_save_thesis",
         description: "Save or update the global investment thesis for a specific symbol (max 200 per workspace).",
-        inputSchema: z13.object({
-          symbol: z13.string().max(50),
-          summary: z13.string().max(5e3),
-          bullCase: z13.string().max(2e3).optional(),
-          bearCase: z13.string().max(2e3).optional(),
-          catalyst: z13.string().max(2e3).optional(),
-          timeframe: z13.string().max(100).optional()
+        inputSchema: z14.object({
+          symbol: z14.string().max(50),
+          summary: z14.string().max(5e3),
+          bullCase: z14.string().max(2e3).optional(),
+          bearCase: z14.string().max(2e3).optional(),
+          catalyst: z14.string().max(2e3).optional(),
+          timeframe: z14.string().max(100).optional()
         }),
         readOnly: false,
         openWorld: false,
@@ -1877,6 +2472,7 @@ var MODULE_CATALOG = [
   { name: "fred", envVar: "FRED_API_KEY", toolCount: 4, factory: (config) => config.env.FRED_API_KEY ? createFredModule(config.env.FRED_API_KEY) : null },
   { name: "sentiment", envVar: null, toolCount: 2, factory: () => createSentimentModule() },
   { name: "frankfurter", envVar: null, toolCount: 5, factory: () => createFrankfurterModule() },
+  { name: "reddit", envVar: null, toolCount: 3, factory: () => createRedditModule() },
   { name: "workspace", envVar: null, toolCount: 7, factory: (config) => config.enableWorkspace ? createWorkspaceModule(config.dataDir || path3.join(os2.homedir(), ".stock-scanner-mcp"), config.defaultExchange) : null }
 ];
 var TOTAL_TOOLS = MODULE_CATALOG.reduce((n, m) => n + m.toolCount, 0);
@@ -1896,7 +2492,7 @@ OPTIONS
   --enable-workspace      Enable stateful workspace (watchlists, theses, profile)
   --data-dir <path>       Directory for workspace storage (default: ~/.stock-scanner-mcp)
 
-MODULES (61 tools total)
+MODULES (64 tools total)
   tradingview        10 tools Stock scanning, quotes, technicals       (no key)
   tradingview-crypto 4 tools  Crypto pair scanning and technicals      (no key)
   sec-edgar          6 tools  SEC filings, insider trades, holdings    (no key)
@@ -1905,6 +2501,7 @@ MODULES (61 tools total)
   options-cboe       1 tool   CBOE put/call ratio sentiment            (no key)
   sentiment          2 tools  Market & crypto Fear & Greed sentiment   (no key)
   frankfurter        5 tools  Forex exchange rates and conversion       (no key)
+  reddit             3 tools  Reddit trending tickers and sentiment     (no key)
   workspace          7 tools  Stateful watchlists, theses, and profile  (no key)
   finnhub            9 tools  Quotes, profiles, peers, news, earnings  (FINNHUB_API_KEY)
   alpha-vantage      5 tools  Stock quotes, fundamentals, dividends    (ALPHA_VANTAGE_API_KEY)
@@ -2004,7 +2601,7 @@ Tools registered: ${registeredTools}/${TOTAL_TOOLS}`);
   server.registerPrompt("analyze_stock", {
     description: "Analyze a stock ticker \u2014 includes crypto correlation check for crypto-related companies",
     argsSchema: {
-      ticker: z14.string().describe("Stock ticker symbol (e.g. AAPL, CIFR, MARA)")
+      ticker: z15.string().describe("Stock ticker symbol (e.g. AAPL, CIFR, MARA)")
     }
   }, async ({ ticker }) => {
     return {
@@ -2038,8 +2635,8 @@ Tools registered: ${registeredTools}/${TOTAL_TOOLS}`);
   server.registerPrompt("intraday_candidates", {
     description: "Find intraday trading candidates with custom price range and filters",
     argsSchema: {
-      min_price: z14.string().optional().describe("Minimum stock price (default: 10)"),
-      max_price: z14.string().optional().describe("Maximum stock price (default: 50)")
+      min_price: z15.string().optional().describe("Minimum stock price (default: 10)"),
+      max_price: z15.string().optional().describe("Maximum stock price (default: 50)")
     }
   }, async ({ min_price, max_price }) => {
     const min = min_price || "10";

package/dist/sidecar/index.js

@@ -39,10 +39,15 @@ import {
   scanStocks,
   searchFilings,
   searchSeries
-} from "../chunk-HAYAISNP.js";
+} from "../chunk-T5IF6777.js";
 
 // 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.0",
+  "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"
@@ -88,7 +89,7 @@
     "@types/proper-lockfile": "^4.1.4",
     "tsup": "^8.0.0",
     "tsx": "^4.21.0",
-    "typescript": "^5.7.0",
+    "typescript": "^6.0.2",
     "vitest": "^4.1.1"
   }
 }