stock-scanner-mcp 1.2.0 → 1.4.0

package/dist/index.js

@@ -401,7 +401,7 @@ function createTradingviewModule() {
       },
       {
         name: "tradingview_quote",
-        description: "Get a real-time quote for one or more stock tickers (e.g. 'AAPL' or 'NASDAQ:AAPL'). Returns price, change, volume, market cap, and pre-market/after-hours data when available. If a ticker returns empty results, retry with the correct exchange prefix (e.g. 'NYSE:CDE', 'AMEX:XYZ').",
+        description: "Get a 15-minute delayed quote for one or more stock tickers (e.g. 'AAPL' or 'NASDAQ:AAPL'). Returns price, change, volume, market cap, and pre-market/after-hours data when available. Data is delayed ~15 minutes during market hours \u2014 use finnhub_quote for real-time prices if available. If a ticker returns empty results, retry with the correct exchange prefix (e.g. 'NYSE:CDE', 'AMEX:XYZ').",
         inputSchema: z.object({
           tickers: z.array(z.string()).describe("Stock tickers, e.g. ['AAPL', 'MSFT']")
         }),
@@ -537,6 +537,26 @@ function createTradingviewModule() {
           return successResult(JSON.stringify(rows, null, 2));
         }, metadata2)
       },
+      {
+        name: "tradingview_market_indices",
+        description: "Get real-time values for major market indices: VIX (volatility), S&P 500, NASDAQ Composite, and Dow Jones. Essential for gauging broad market conditions, risk sentiment, and options pricing context.",
+        inputSchema: z.object({}),
+        handler: withMetadata(async () => {
+          const tickers = ["TVC:VIX", "TVC:SPX", "TVC:NDQ", "TVC:DJI"];
+          const columns = [
+            "close",
+            "change",
+            "change_abs",
+            "high",
+            "low",
+            "open",
+            "name",
+            "description"
+          ];
+          const rows = await scanStocks({ tickers, columns });
+          return successResult(JSON.stringify(rows, null, 2));
+        }, metadata2)
+      },
       {
         name: "tradingview_volume_breakout",
         description: "Find stocks with unusual volume (current volume significantly above average). Defaults to major exchanges.",
@@ -1374,12 +1394,45 @@ async function getAnalystRecommendations(apiKey, symbol) {
   cache3.set(cacheKey, data);
   return data;
 }
-async function getPriceTarget(apiKey, symbol) {
-  const cacheKey = `price-target:${symbol}`;
+async function getCompanyProfile(apiKey, symbol) {
+  const cacheKey = `profile:${symbol}`;
+  const cached = cache3.get(cacheKey);
+  if (cached) return cached;
+  const data = await httpGet(
+    `${BASE_URL2}/stock/profile2?symbol=${encodeURIComponent(symbol)}`,
+    { headers: { "X-Finnhub-Token": apiKey } }
+  );
+  cache3.set(cacheKey, data);
+  return data;
+}
+async function getPeers(apiKey, symbol) {
+  const cacheKey = `peers:${symbol}`;
+  const cached = cache3.get(cacheKey);
+  if (cached) return cached;
+  const data = await httpGet(
+    `${BASE_URL2}/stock/peers?symbol=${encodeURIComponent(symbol)}`,
+    { headers: { "X-Finnhub-Token": apiKey } }
+  );
+  cache3.set(cacheKey, data);
+  return data;
+}
+async function getMarketStatus(apiKey, exchange) {
+  const cacheKey = `market-status:${exchange}`;
+  const cached = cache3.get(cacheKey);
+  if (cached) return cached;
+  const data = await httpGet(
+    `${BASE_URL2}/stock/market-status?exchange=${encodeURIComponent(exchange)}`,
+    { headers: { "X-Finnhub-Token": apiKey } }
+  );
+  cache3.set(cacheKey, data);
+  return data;
+}
+async function getQuote(apiKey, symbol) {
+  const cacheKey = `quote:${symbol}`;
   const cached = cache3.get(cacheKey);
   if (cached) return cached;
   const data = await httpGet(
-    `${BASE_URL2}/stock/price-target?symbol=${encodeURIComponent(symbol)}`,
+    `${BASE_URL2}/quote?symbol=${encodeURIComponent(symbol)}`,
     { headers: { "X-Finnhub-Token": apiKey } }
   );
   cache3.set(cacheKey, data);
@@ -1471,24 +1524,77 @@ function createFinnhubModule(apiKey) {
   };
   const analystRatingsTool = {
     name: "finnhub_analyst_ratings",
-    description: "Get analyst consensus recommendations and price targets for a stock. Note: Some tickers may return 403 errors on Finnhub free tier plans.",
+    description: "Get analyst consensus recommendations for a stock.",
     inputSchema: z5.object({
       symbol: z5.string().describe("Stock symbol (e.g. 'AAPL')")
     }),
     handler: withMetadata(async (params) => {
       const symbol = resolveTicker(params.symbol).ticker;
-      const [recs, target] = await Promise.all([
-        getAnalystRecommendations(apiKey, symbol),
-        getPriceTarget(apiKey, symbol)
-      ]);
+      const recs = await getAnalystRecommendations(apiKey, symbol);
       return successResult(JSON.stringify({
         symbol,
         currentConsensus: recs[0] || null,
-        priceTarget: target,
         recommendationHistory: recs.slice(0, 4)
       }, null, 2));
     }, metadata2)
   };
+  const companyProfileTool = {
+    name: "finnhub_company_profile",
+    description: "Get company profile: name, industry, market cap, IPO date, logo, website, share count, and exchange.",
+    inputSchema: z5.object({
+      symbol: z5.string().describe("Stock symbol (e.g. 'AAPL')")
+    }),
+    handler: withMetadata(async (params) => {
+      const symbol = resolveTicker(params.symbol).ticker;
+      const profile = await getCompanyProfile(apiKey, symbol);
+      return successResult(JSON.stringify(profile, null, 2));
+    }, metadata2)
+  };
+  const peersTool = {
+    name: "finnhub_peers",
+    description: "Get a list of peer/comparable companies in the same industry for a given stock.",
+    inputSchema: z5.object({
+      symbol: z5.string().describe("Stock symbol (e.g. 'AAPL')")
+    }),
+    handler: withMetadata(async (params) => {
+      const symbol = resolveTicker(params.symbol).ticker;
+      const peers = await getPeers(apiKey, symbol);
+      return successResult(JSON.stringify({ symbol, peers }, null, 2));
+    }, metadata2)
+  };
+  const marketStatusTool = {
+    name: "finnhub_market_status",
+    description: "Check if a stock exchange is currently open, and what session it is in (pre-market, regular, post-market).",
+    inputSchema: z5.object({
+      exchange: z5.string().default("US").describe("Exchange code. Examples: US, L (London), T (Tokyo), HK")
+    }),
+    handler: withMetadata(async (params) => {
+      const exchange = params.exchange;
+      const status = await getMarketStatus(apiKey, exchange);
+      return successResult(JSON.stringify(status, null, 2));
+    }, metadata2)
+  };
+  const quoteTool = {
+    name: "finnhub_quote",
+    description: "Get a real-time stock quote from Finnhub (requires API key): current price, change, percent change, day high/low, open, and previous close. Preferred over tradingview_quote during market hours for live prices. Use tradingview_quote as a keyless fallback when Finnhub is unavailable.",
+    inputSchema: z5.object({
+      symbol: z5.string().describe("Stock symbol (e.g. 'AAPL')")
+    }),
+    handler: withMetadata(async (params) => {
+      const symbol = resolveTicker(params.symbol).ticker;
+      const q = await getQuote(apiKey, symbol);
+      return successResult(JSON.stringify({
+        symbol,
+        price: q.c,
+        change: q.d,
+        changePercent: q.dp,
+        dayHigh: q.h,
+        dayLow: q.l,
+        open: q.o,
+        previousClose: q.pc
+      }, null, 2));
+    }, metadata2)
+  };
   const shortInterestTool = {
     name: "finnhub_short_interest",
     description: "Get short interest and other key financial metrics for a stock.",
@@ -1503,9 +1609,13 @@ function createFinnhubModule(apiKey) {
   };
   return {
     name: "finnhub",
-    description: "Finnhub market and company news, plus earnings calendar, analyst ratings and short interest",
+    description: "Finnhub market data: quotes, company profiles, peers, news, earnings, analyst ratings, short interest, and market status",
     requiredEnvVars: ["FINNHUB_API_KEY"],
     tools: [
+      quoteTool,
+      companyProfileTool,
+      peersTool,
+      marketStatusTool,
       marketNewsTool,
       companyNewsTool,
       earningsCalendarTool,
@@ -1536,7 +1646,7 @@ function checkAvResponse(data) {
     throw new Error(`Alpha Vantage Error: ${data["Error Message"]}`);
   }
 }
-async function getQuote(apiKey, symbol) {
+async function getQuote2(apiKey, symbol) {
   const cacheKey = `quote:${symbol}`;
   const cached = cache4.get(cacheKey);
   if (cached) return cached;
@@ -1665,7 +1775,7 @@ function createAlphaVantageModule(apiKey) {
     }),
     handler: withMetadata(async (params) => {
       const symbol = resolveTicker(params.symbol).ticker;
-      const quote = await getQuote(apiKey, symbol);
+      const quote = await getQuote2(apiKey, symbol);
       return successResult(JSON.stringify(quote, null, 2));
     }, metadata2)
   };
@@ -2233,14 +2343,14 @@ OPTIONS
   --modules <list>        Comma-separated modules to enable (default: all available)
   --default-exchange <ex> Default exchange for symbol resolution (default: NASDAQ)
 
-MODULES (35 tools total)
+MODULES (39 tools total)
   tradingview        7 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)
   coingecko          3 tools  Crypto market data and trending          (no key)
   options            4 tools  Options chains, Greeks, unusual activity  (no key)
   options-cboe       1 tool   CBOE put/call ratio sentiment            (no key)
-  finnhub            5 tools  Market news, earnings, short interest    (FINNHUB_API_KEY)
+  finnhub            9 tools  Quotes, profiles, peers, news, earnings  (FINNHUB_API_KEY)
   alpha-vantage      5 tools  Stock quotes, fundamentals, dividends    (ALPHA_VANTAGE_API_KEY)
 
 SETUP (Claude Code)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stock-scanner-mcp",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "MCP server providing Claude Code with real-time stock and crypto market data, SEC filings, insider trades, and technical analysis",
   "type": "module",
   "bin": {