# io.github.yyordanov-tradu/stock-scanner-mcp (npm · stock-scanner-mcp)

Stock and crypto market data — 49 tools for quotes, technicals, options, SEC filings, and more.

- Trust score: 70/100 (medium)
- Change this week: +17
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `stock-scanner-mcp`: 70/100 (this document), [markdown](https://verifymcp.io/servers/yyordanov-tradu-stock-scanner-mcp/stock-scanner-mcp.md), [page](https://verifymcp.io/servers/yyordanov-tradu-stock-scanner-mcp/stock-scanner-mcp)

## Channel facts

- Registry: `npm`
- Package: `stock-scanner-mcp`
- Version: `1.13.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 29 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 2886 tokens (~93/item across 31 items; 31 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add yyordanov-tradu-stock-scanner-mcp -- npx -y stock-scanner-mcp
```

### Codex

```bash
codex mcp add yyordanov-tradu-stock-scanner-mcp -- npx -y stock-scanner-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "yyordanov-tradu-stock-scanner-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "stock-scanner-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add yyordanov-tradu-stock-scanner-mcp --command npx --arg -y --arg stock-scanner-mcp
```

### Hermes

```yaml
mcp_servers:
  yyordanov-tradu-stock-scanner-mcp:
    command: "npx"
    args: ["-y", "stock-scanner-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "yyordanov-tradu-stock-scanner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "stock-scanner-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 70, +3)

- [functional improvement] Stability: unverified → 0.23

### 2026-08-02 (score 67, +41)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security improvement] Install scripts: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] License: unverified → pass
- [functional] Licence: MIT

### 2026-07-31 (score 26, −9)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 35, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 53)

First indexed and scored.

## MCP tools (31)

### `tradingview_scan` (~141 tokens)

Scan US stocks with custom filters (price > X, RSI < 30, etc.). Returns up to `limit` rows with the requested columns.

Input parameters:

- `columns` (array): Columns to return (default: all 66)
- `exchange` (string): Exchange filter, e.g. NASDAQ, NYSE, AMEX
- `filters` (array): Scanner filters
- `limit` (number): Max rows (default 50)
- `timeframe` (string): Timeframe: 1m, 5m, 15m, 1h, 4h, 1d (default), 1W, 1M

### `tradingview_compare_stocks` (~87 tokens)

Returns price, change, market cap, P/E, EPS, revenue, dividend yield, RSI, and analyst recommendation rating (-1 sell to +1 buy) for 2-5 stocks. Revenue growth rate and analyst price targets are not available.

Input parameters:

- `tickers` (array, required): 2-5 stock tickers to compare (e.g. AAPL, MSFT)

### `tradingview_quote` (~129 tokens)

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 — 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').

Input parameters:

- `tickers` (array, required): Stock tickers, e.g. ['AAPL', 'MSFT']

### `tradingview_technicals` (~101 tokens)

Get technical indicators (RSI, MACD, moving averages, pivot points, etc.) for one or more stock tickers. If a ticker returns empty results, retry with the correct exchange prefix (e.g. 'NYSE:CDE', 'AMEX:XYZ').

Input parameters:

- `tickers` (array, required): Stock tickers, e.g. ['AAPL', 'IBM']
- `timeframe` (string): Timeframe (default: 1d)

### `tradingview_top_gainers` (~98 tokens)

Get today's top gaining stocks by percentage change on a given exchange. Defaults to major US exchanges (NYSE, NASDAQ, AMEX) with market cap > $100M. OTC penny stocks excluded by default.

Input parameters:

- `exchange` (string): Exchange (default: all US)
- `include_otc` (boolean): Whether to include OTC penny stocks (default: false)
- `limit` (number): Max results (default 20)

### `tradingview_top_losers` (~99 tokens)

Get today's top losing stocks by percentage change on a given exchange. Defaults to major US exchanges (NYSE, NASDAQ, AMEX) with market cap > $100M. OTC penny stocks excluded by default.

Input parameters:

- `exchange` (string): Exchange (default: all US)
- `include_otc` (boolean): Whether to include OTC penny stocks (default: false)
- `limit` (number): Max results (default 20)

### `tradingview_top_volume` (~70 tokens)

Get stocks with the highest trading volume today. Defaults to major US exchanges.

Input parameters:

- `exchange` (string): Exchange (default: all US)
- `include_otc` (boolean): Whether to include OTC penny stocks (default: false)
- `limit` (number): Max results (default 20)

### `tradingview_market_indices` (~54 tokens)

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.

### `tradingview_sector_performance` (~70 tokens)

Get performance of S&P 500 sector ETFs (XLK, XLF, XLE, XLV, XLI, XLP, XLU, XLY, XLC, XLRE, XLB). Shows which sectors are leading or lagging today. Essential for sector rotation analysis.

### `tradingview_volume_breakout` (~50 tokens)

Find stocks with unusual volume (current volume significantly above average). Defaults to major exchanges.

Input parameters:

- `exchange` (string): Exchange filter
- `limit` (number): Max results (default 20)

### `crypto_scan` (~128 tokens)

Scan cryptocurrency pairs using TradingView filters. Returns price, volume, and technical indicators.

Input parameters:

- `columns` (array): Columns to return (default: all 23)
- `filters` (array): Filter conditions combined with AND
- `limit` (number): Max results (default: 50, max: 200)
- `major_only` (boolean): Only include major exchanges (default: true)
- `timeframe` (string): Timeframe: '1m','5m','15m','1h','4h','1d','1W','1M'. Default: '1d'

### `crypto_quote` (~61 tokens)

Get real-time quotes for specific crypto pairs. Supports 'BTCUSDT' (defaults to BINANCE) or 'BINANCE:BTCUSDT'.

Input parameters:

- `symbols` (array, required): Crypto pair symbols (e.g. ['BTCUSDT', 'ETHUSDT'])

### `crypto_technicals` (~64 tokens)

Get technical analysis for crypto pairs. Supports 'BTCUSDT' or 'BINANCE:BTCUSDT'.

Input parameters:

- `symbols` (array, required): Crypto symbols (e.g. ['BTCUSDT'])
- `timeframe` (string): Timeframe. Default: '1d'

### `crypto_top_gainers` (~65 tokens)

Get top gaining cryptocurrency pairs by percentage change. Defaults to major exchanges and volume > $10k.

Input parameters:

- `exchange` (string): Specific exchange (e.g. BINANCE)
- `limit` (number): Number of results (default: 20, max: 50)

### `edgar_search` (~164 tokens)

Search SEC EDGAR filings by keyword. Best for finding mentions of specific trends, technologies, or events across all companies. Returns metadata including accession numbers, form types, and direct sec.gov links.

Input parameters:

- `dateRange` (string): Date range as 'YYYY-MM-DD,YYYY-MM-DD'
- `forms` (array): Form types to filter (e.g. ['10-K', '10-Q', '8-K'])
- `limit` (number): Max results (default: 20, max: 50)
- `query` (string, required): Keyword or phrase to search for (e.g. 'lithium mining', 'share repurchase program')
- `tickers` (array): Company tickers to filter (e.g. ['AAPL', 'MSFT'])

### `edgar_company_filings` (~112 tokens)

Retrieve the most recent official filings for a specific company. Use this to find a company's latest 10-K (annual), 10-Q (quarterly), or 8-K (current events) reports.

Input parameters:

- `forms` (array): Form types (e.g. ['10-K', '10-Q']). Default: all.
- `limit` (number): Max results (default: 10, max: 50)
- `ticker` (string, required): Stock ticker symbol (e.g. 'AAPL')

### `edgar_company_facts` (~66 tokens)

Retrieve high-fidelity financial metrics (Revenue, Net Income, EPS, Assets, Liabilities) directly from SEC XBRL data. This is more reliable than extracting numbers from text filings.

Input parameters:

- `ticker` (string, required): Stock ticker symbol (e.g. 'AAPL')

### `edgar_insider_trades` (~85 tokens)

Monitor legal stock trades made by company executives and directors (Forms 3, 4, 5). Returns detailed transaction data including insider names, titles, buy/sell type, share amounts, and prices.

Input parameters:

- `limit` (number): Max results (default: 10)
- `ticker` (string, required): Stock ticker symbol (e.g. 'AAPL')

### `edgar_institutional_holdings` (~100 tokens)

Track 'big money' moves by searching Form 13F filings. Use to find what hedge funds and institutional managers (e.g. 'Berkshire Hathaway') are holding or what firms own a specific ticker.

Input parameters:

- `limit` (number): Max results (default: 10)
- `query` (string, required): Stock ticker (e.g. 'AAPL') or institutional manager name (e.g. 'Berkshire Hathaway')

### `edgar_ownership_filings` (~85 tokens)

Monitor significant changes in company ownership (5%+ stakes). Use 13D and 13G filings to identify activist investors (e.g. Carl Icahn, Ryan Cohen) entering or exiting a stock.

Input parameters:

- `limit` (number): Max results (default: 10)
- `ticker` (string, required): Stock ticker symbol (e.g. 'AAPL')

### `coingecko_coin` (~68 tokens)

Get detailed cryptocurrency info from CoinGecko. Use slug IDs (e.g. 'bitcoin', 'ethereum', 'solana'), NOT ticker symbols.

Input parameters:

- `coinId` (string, required): CoinGecko coin ID / slug (e.g. 'bitcoin', 'ethereum', 'cardano')

### `coingecko_trending` (~31 tokens)

Get trending cryptocurrencies on CoinGecko (top 7 by search popularity in last 24h).

### `coingecko_global` (~30 tokens)

Get global cryptocurrency market statistics: total market cap, 24h volume, BTC/ETH dominance.

### `options_expirations` (~63 tokens)

Get all available option expiration dates for a stock ticker. Call this first to discover valid dates, then pass one to options_chain or options_max_pain.

Input parameters:

- `symbol` (string, required): Stock ticker symbol (e.g. 'AAPL', 'NYSE:GM')

### `options_chain` (~235 tokens)

Get the full option chain (calls and puts) with calculated Greeks (Delta, Gamma, Theta, Vega). Use options_expirations first to find valid dates. If expiration is omitted, uses nearest date. By default, returns strikes within ±20% of current price to save tokens. Use strike_min/strike_max for custom range, or all_strikes=true for everything.

Input parameters:

- `all_strikes` (boolean): Return all strikes instead of centering around ATM (default: false)
- `expiration` (string): Expiration date as YYYY-MM-DD (e.g. '2026-04-17'). If omitted, uses nearest.
- `limit` (number): Max contracts per side (default: 50, max: 200)
- `side` (string): Filter by option type (default: both)
- `strike_max` (number): Maximum strike price filter (e.g. 35.0)
- `strike_min` (number): Minimum strike price filter (e.g. 25.0)
- `symbol` (string, required): Stock ticker symbol (e.g. 'AAPL', 'NYSE:GM')

### `options_unusual_activity` (~125 tokens)

Find options contracts with unusually high volume relative to open interest (a common 'smart money' signal). Scans the nearest expiration and flags contracts where volume/OI exceeds a threshold.

Input parameters:

- `min_volume` (number): Min absolute volume (default: 100)
- `side` (string): Filter by option type (default: both)
- `symbol` (string, required): Stock ticker symbol (e.g. 'AAPL', 'NYSE:GM')
- `volume_oi_ratio` (number): Min volume/OI ratio to flag as unusual (default: 3.0)

### `options_max_pain` (~80 tokens)

Calculate the max pain strike price — where cumulative option open interest expires worthless. This level often acts as a support/resistance zone near expiration.

Input parameters:

- `expiration` (string): Expiration date as YYYY-MM-DD. If omitted, uses nearest.
- `symbol` (string, required): Stock ticker symbol (e.g. 'AAPL', 'NYSE:GM')

### `options_implied_move` (~95 tokens)

Calculate the expected move implied by options pricing (ATM straddle). Essential for earnings plays — shows how much the market expects the stock to move. Compare implied vs historical moves to assess if premium is cheap or expensive.

Input parameters:

- `expiration` (string): Expiration date as YYYY-MM-DD. If omitted, uses nearest.
- `symbol` (string, required): Stock ticker symbol (e.g. 'AAPL', 'NYSE:GM')

### `options_put_call_ratio` (~118 tokens)

Get historical put/call ratio from CBOE (market-wide sentiment indicator). Ratio > 1.0 = more puts (bearish sentiment), < 0.7 = more calls (bullish/complacent). Types: 'total' (all options), 'equity' (stock options only), 'index' (index options only).

Input parameters:

- `days` (number): Number of recent trading days to return (default: 30, max: 252)
- `type` (string): Ratio type (default: total)

### `sentiment_fear_greed` (~133 tokens)

Get the CNN Fear & Greed Index for the US stock market. Returns a composite score (0-100) with rating (extreme fear/fear/neutral/greed/extreme greed) and 7 sub-indicators: S&P 500 momentum, stock price strength (52w highs vs lows), stock price breadth (McClellan), put/call ratio, VIX, junk bond demand, safe haven demand. Also includes previous close, 1-week, 1-month, and 1-year scores for trend context. Use this to gauge overall market sentiment before analyzing individual stocks.

### `sentiment_crypto_fear_greed` (~79 tokens)

Get the Crypto Fear & Greed Index from Alternative.me. Returns a score (0-100) with rating (extreme fear/fear/neutral/greed/extreme greed). Based on Bitcoin volatility, market volume, social media, surveys, dominance, and trends. Use this alongside coingecko tools for crypto market context.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/yyordanov-tradu-stock-scanner-mcp/stock-scanner-mcp#diagnostics

## Score history

- 2026-08-03: 70
- 2026-08-02: 67
- 2026-08-01: 26
- 2026-07-31: 26
- 2026-07-30: 35
- 2026-07-28: 53
- 2026-07-27: 53

## Links

- npm package: https://www.npmjs.com/package/stock-scanner-mcp
- Socket report: https://socket.dev/npm/package/stock-scanner-mcp
- Repository: https://github.com/yyordanov-tradu/stock-scanner-mcp
- Changelog RSS feed: https://verifymcp.io/servers/yyordanov-tradu-stock-scanner-mcp/stock-scanner-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/yyordanov-tradu-stock-scanner-mcp/stock-scanner-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/yyordanov-tradu-stock-scanner-mcp/stock-scanner-mcp