io.github.yyordanov-tradu/stock-scanner-mcp

NPM · STOCK-SCANNER-MCP · SCANNED AUG 3

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

Available components

+17 this week 70 70 Trust /100

Trust breakdown (6 categories)

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. How we score →

Supply Chain Security86

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 29 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability85

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 2886 tokens (~93/item across 31 items; 31 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management23

Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · stock-scanner-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# add to Codex CLI

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
    }
  }
}

# add to OpenClaw

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

# ~/.hermes/config.yaml

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

// mcp.json

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +3
- Stability: unverified → 0.23 ▲ functional
2 Aug 26 +41
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Schema quality: unverified → excellent ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- Licence: MIT functional
31 Jul 26 −9
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 53

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 31 exposed · ~2,886 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

coingecko_coin ~68

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

Input Output Examples

Name	Type	Req	Description
coinId	string	yes	CoinGecko coin ID / slug (e.g. 'bitcoin', 'ethereum', 'cardano')

No output schema declared.

No examples provided.

coingecko_global ~30

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

coingecko_trending ~31

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

crypto_quote ~61

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

Input Output Examples

Name	Type	Req	Description
symbols	array	yes	Crypto pair symbols (e.g. ['BTCUSDT', 'ETHUSDT'])

No output schema declared.

No examples provided.

crypto_scan ~128

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

Input Output Examples

Name	Type	Req	Description
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'

No output schema declared.

No examples provided.

crypto_technicals ~64

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

Input Output Examples

Name	Type	Req	Description
symbols	array	yes	Crypto symbols (e.g. ['BTCUSDT'])
timeframe	string	—	Timeframe. Default: '1d'

No output schema declared.

No examples provided.

crypto_top_gainers ~65

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

Input Output Examples

Name	Type	Req	Description
exchange	string	—	Specific exchange (e.g. BINANCE)
limit	number	—	Number of results (default: 20, max: 50)

No output schema declared.

No examples provided.

edgar_company_facts ~66

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 Output Examples

Name	Type	Req	Description
ticker	string	yes	Stock ticker symbol (e.g. 'AAPL')

No output schema declared.

No examples provided.

edgar_company_filings ~112

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 Output Examples

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

No output schema declared.

No examples provided.

edgar_insider_trades ~85

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 Output Examples

Name	Type	Req	Description
limit	number	—	Max results (default: 10)
ticker	string	yes	Stock ticker symbol (e.g. 'AAPL')

No output schema declared.

No examples provided.

edgar_institutional_holdings ~100

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 Output Examples

Name	Type	Req	Description
limit	number	—	Max results (default: 10)
query	string	yes	Stock ticker (e.g. 'AAPL') or institutional manager name (e.g. 'Berkshire Hathaway')

No output schema declared.

No examples provided.

edgar_ownership_filings ~85

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 Output Examples

Name	Type	Req	Description
limit	number	—	Max results (default: 10)
ticker	string	yes	Stock ticker symbol (e.g. 'AAPL')

No output schema declared.

No examples provided.

edgar_search ~164

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 Output Examples

Name	Type	Req	Description
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	yes	Keyword or phrase to search for (e.g. 'lithium mining', 'share repurchase program')
tickers	array	—	Company tickers to filter (e.g. ['AAPL', 'MSFT'])

No output schema declared.

No examples provided.

options_chain ~235

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 Output Examples

Name	Type	Req	Description
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	yes	Stock ticker symbol (e.g. 'AAPL', 'NYSE:GM')

No output schema declared.

No examples provided.

options_expirations ~63

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 Output Examples

Name	Type	Req	Description
symbol	string	yes	Stock ticker symbol (e.g. 'AAPL', 'NYSE:GM')

No output schema declared.

No examples provided.

options_implied_move ~95

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 Output Examples

Name	Type	Req	Description
expiration	string	—	Expiration date as YYYY-MM-DD. If omitted, uses nearest.
symbol	string	yes	Stock ticker symbol (e.g. 'AAPL', 'NYSE:GM')

No output schema declared.

No examples provided.

options_max_pain ~80

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 Output Examples

Name	Type	Req	Description
expiration	string	—	Expiration date as YYYY-MM-DD. If omitted, uses nearest.
symbol	string	yes	Stock ticker symbol (e.g. 'AAPL', 'NYSE:GM')

No output schema declared.

No examples provided.

options_put_call_ratio ~118

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 Output Examples

Name	Type	Req	Description
days	number	—	Number of recent trading days to return (default: 30, max: 252)
type	string	—	Ratio type (default: total)

No output schema declared.

No examples provided.

options_unusual_activity ~125

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 Output Examples

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

No output schema declared.

No examples provided.

sentiment_crypto_fear_greed ~79

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

sentiment_fear_greed ~133

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

tradingview_compare_stocks ~87

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 Output Examples

Name	Type	Req	Description
tickers	array	yes	2-5 stock tickers to compare (e.g. AAPL, MSFT)

No output schema declared.

No examples provided.

tradingview_market_indices ~54

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

tradingview_quote ~129

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 Output Examples

Name	Type	Req	Description
tickers	array	yes	Stock tickers, e.g. ['AAPL', 'MSFT']

No output schema declared.

No examples provided.

tradingview_scan ~141

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

Input Output Examples

Name	Type	Req	Description
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

No output schema declared.

No examples provided.

tradingview_sector_performance ~70

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

tradingview_technicals ~101

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 Output Examples

Name	Type	Req	Description
tickers	array	yes	Stock tickers, e.g. ['AAPL', 'IBM']
timeframe	string	—	Timeframe (default: 1d)

No output schema declared.

No examples provided.

tradingview_top_gainers ~98

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 Output Examples

Name	Type	Req	Description
exchange	string	—	Exchange (default: all US)
include_otc	boolean	—	Whether to include OTC penny stocks (default: false)
limit	number	—	Max results (default 20)

No output schema declared.

No examples provided.

tradingview_top_losers ~99

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 Output Examples

Name	Type	Req	Description
exchange	string	—	Exchange (default: all US)
include_otc	boolean	—	Whether to include OTC penny stocks (default: false)
limit	number	—	Max results (default 20)

No output schema declared.

No examples provided.

tradingview_top_volume ~70

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

Input Output Examples

Name	Type	Req	Description
exchange	string	—	Exchange (default: all US)
include_otc	boolean	—	Whether to include OTC penny stocks (default: false)
limit	number	—	Max results (default 20)

No output schema declared.

No examples provided.

tradingview_volume_breakout ~50

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

Input Output Examples

Name	Type	Req	Description
exchange	string	—	Exchange filter
limit	number	—	Max results (default 20)

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug