{"name":"io.github.yyordanov-tradu/stock-scanner-mcp","slug":"yyordanov-tradu-stock-scanner-mcp","title":null,"description":"Stock and crypto market data — 49 tools for quotes, technicals, options, SEC filings, and more.","url":"https://mcp.market/server/yyordanov-tradu-stock-scanner-mcp","rating":null,"grade":"B","score":83,"certified":false,"status":"active","category":"finance","tags":["finance"],"presence":{"score":24,"stars":7,"forks":2,"downloads_week":null,"last_push_at":"2026-09-21T13:52:13.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/yyordanov-tradu/stock-scanner-mcp","website":null,"version":"1.13.1","remotes":[],"packages":[{"registryType":"npm","identifier":"stock-scanner-mcp","version":"1.13.1","transport":{"type":"stdio"},"environmentVariables":[{"description":"Finnhub API key for real-time quotes, news, earnings","format":"string","isSecret":true,"name":"FINNHUB_API_KEY"},{"description":"Alpha Vantage API key for fundamentals, daily prices","format":"string","isSecret":true,"name":"ALPHA_VANTAGE_API_KEY"},{"description":"FRED API key for economic indicators and calendar","format":"string","isSecret":true,"name":"FRED_API_KEY"}]}],"tools":[{"name":"alpha-vantage","description":"Alpha Vantage stock data -- quotes, daily prices, and company fundamentals","write_action":false,"price_micros":0,"input_schema":null},{"name":"alphavantage_daily","description":"Get daily OHLCV price history from Alpha Vantage. Returns up to 100 most recent trading days. Rate limit: 25 calls/day, 5 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"alphavantage_dividend_history","description":"Get historical dividend data for a specific ticker. Rate limit: 25 calls/day, 5 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"alphavantage_earnings_history","description":"Get historical earnings data (EPS actual vs estimate) for a specific ticker. Rate limit: 25 calls/day, 5 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"alphavantage_overview","description":"Get company fundamentals from Alpha Vantage. Includes PE ratio, market cap, sector, industry, earnings, and analyst target price. Supports batch requests (limit 5). Rate limit: 25 calls/day, 5 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"alphavantage_quote","description":"Get real-time stock quote from Alpha Vantage. Returns price, change, volume, and day range. Rate limit: 5 calls/min on free tier.","write_action":false,"price_micros":0,"input_schema":null},{"name":"coingecko","description":"CoinGecko crypto data -- coin details, trending coins, and global market stats","write_action":false,"price_micros":0,"input_schema":null},{"name":"coingecko_coin","description":"Get detailed cryptocurrency info from CoinGecko. Use slug IDs (e.g. 'bitcoin', 'ethereum', 'solana'), NOT ticker symbols.","write_action":false,"price_micros":0,"input_schema":null},{"name":"coingecko_global","description":"Get global cryptocurrency market statistics: total market cap, 24h volume, BTC/ETH dominance.","write_action":false,"price_micros":0,"input_schema":null},{"name":"coingecko_trending","description":"Get trending cryptocurrencies on CoinGecko (top 7 by search popularity in last 24h).","write_action":false,"price_micros":0,"input_schema":null},{"name":"crypto_quote","description":"Get real-time quotes for specific crypto pairs. Supports 'BTCUSDT' (defaults to BINANCE) or 'BINANCE:BTCUSDT'.","write_action":false,"price_micros":0,"input_schema":null},{"name":"crypto_scan","description":"Scan cryptocurrency pairs using TradingView filters. Returns price, volume, and technical indicators.","write_action":false,"price_micros":0,"input_schema":null},{"name":"crypto_technicals","description":"Get technical analysis for crypto pairs. Supports 'BTCUSDT' or 'BINANCE:BTCUSDT'.","write_action":false,"price_micros":0,"input_schema":null},{"name":"crypto_top_gainers","description":"Get top gaining cryptocurrency pairs by percentage change. Defaults to major exchanges and volume > $10k.","write_action":false,"price_micros":0,"input_schema":null},{"name":"edgar_company_facts","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"edgar_company_filings","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"edgar_insider_trades","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"edgar_institutional_holdings","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"edgar_ownership_filings","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"edgar_search","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"finnhub","description":"Finnhub market data: quotes, company profiles, peers, news, earnings, analyst ratings, short interest, and market status","write_action":false,"price_micros":0,"input_schema":null},{"name":"finnhub_analyst_ratings","description":"Get analyst consensus recommendations for a stock. Returns counts of Strong Buy, Buy, Hold, Sell, Strong Sell ratings and the last 4 months of rating history. Rate limit: 60 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"finnhub_company_news","description":"Get recent news for a specific company by ticker symbol. Rate limit: 60 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"finnhub_company_profile","description":"Get company profile: name, industry, market cap, IPO date, logo, website, share count, and exchange. Rate limit: 60 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"finnhub_earnings_calendar","description":"Get upcoming or historical earnings reports within a date range. Rate limit: 60 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"finnhub_market_news","description":"Get latest market news by category (general, forex, crypto, merger). Rate limit: 60 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"finnhub_market_status","description":"Check if a stock exchange is currently open, and what session it is in (pre-market, regular, post-market). Rate limit: 60 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"finnhub_peers","description":"Get a list of peer/comparable companies in the same industry for a given stock. Rate limit: 60 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"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. Rate limit: 60 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"finnhub_short_interest","description":"Get short interest and other key financial metrics for a stock. Rate limit: 60 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"fred","description":"FRED economic data: calendar, indicators, interest rates, inflation","write_action":false,"price_micros":0,"input_schema":null},{"name":"fred_economic_calendar","description":"Get upcoming US economic release dates (FOMC, CPI, PPI, NFP, GDP, PCE, jobless claims, retail sales, ISM, treasury rates). Filters to high-impact releases only. Use this to identify macro catalysts that could move markets. Rate limit: 120 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"fred_indicator","description":"Get the latest value of a US economic indicator from FRED. Accepts FRED series IDs (e.g. 'CPIAUCSL', 'DFF', 'UNRATE') or common aliases: cpi, core_cpi, ppi, gdp, unemployment, nonfarm_payrolls, fed_funds, treasury_10y, treasury_2y, initial_claims, core_pce. Returns the indicator metadata (title, frequency, units) and latest observation. Rate limit: 120 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"fred_indicator_history","description":"Get historical values for a US economic indicator from FRED. Accepts same series IDs/aliases as fred_indicator. Supports units transformation: 'lin' (raw level), 'chg' (change), 'pc1' (% change from year ago \\u2014 useful for YoY inflation), 'pch' (% change from prior period). Use 'pc1' with CPI/PPI to get YoY inflation rates directly. Rate limit: 120 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"fred_search","description":"Search FRED for economic data series by keyword. Returns series IDs that can be used with fred_indicator and fred_indicator_history. Results sorted by relevance. Use to discover series IDs for niche indicators. Rate limit: 120 calls/min (free tier).","write_action":false,"price_micros":0,"input_schema":null},{"name":"options","description":"Stock options chains, Greeks, unusual activity, implied move, and max pain from Yahoo Finance (no API key required)","write_action":false,"price_micros":0,"input_schema":null},{"name":"options-cboe","description":"CBOE market-wide put/call ratio data \\u2014 daily sentiment indicator from options volume","write_action":false,"price_micros":0,"input_schema":null},{"name":"options_chain","description":"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 \\xB120% of current price to save tokens. Use strike_min/strike_max for custom range, or all_strikes=true for everything.","write_action":false,"price_micros":0,"input_schema":null},{"name":"options_expirations","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"options_implied_move","description":"Calculate the expected move implied by options pricing (ATM straddle). Essential for earnings plays \\u2014 shows how much the market expects the stock to move. Compare implied vs historical moves to assess if premium is cheap or expensive.","write_action":false,"price_micros":0,"input_schema":null},{"name":"options_max_pain","description":"Calculate the max pain strike price \\u2014 where cumulative option open interest expires worthless. This level often acts as a support/resistance zone near expiration.","write_action":false,"price_micros":0,"input_schema":null},{"name":"options_put_call_ratio","description":"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).","write_action":true,"price_micros":0,"input_schema":null},{"name":"options_unusual_activity","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"sec-edgar","description":"SEC EDGAR filing search -- full-text search and company filing lookup via EFTS","write_action":false,"price_micros":0,"input_schema":null},{"name":"sentiment_crypto_fear_greed","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"sentiment_fear_greed","description":"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 co","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview","description":"TradingView stock scanner \\u2014 prices, technicals, and screener filters for US equities","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview-crypto","description":"TradingView crypto scanner -- real-time quotes, technical analysis, and screening for cryptocurrency pairs","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview_compare_stocks","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview_quote","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').","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview_scan","description":"Scan US stocks with custom filters (price > X, RSI < 30, etc.). Returns up to `limit` rows with the requested columns.","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview_sector_performance","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview_technicals","description":"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').","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview_top_gainers","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview_top_losers","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview_top_volume","description":"Get stocks with the highest trading volume today. Defaults to major US exchanges.","write_action":false,"price_micros":0,"input_schema":null},{"name":"tradingview_volume_breakout","description":"Find stocks with unusual volume (current volume significantly above average). Defaults to major exchanges.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":83,"grade":"B","scanned_at":"2026-09-27T23:19:42.031Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-27T23:19:41.920Z","components":{"code":{"score":25,"max":25,"notes":["9 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 6 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"stock-scanner-mcp","version":"1.13.1","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":2,"publishedAt":"2026-03-28T16:16:08.551Z","repositoryUrl":"git+https://github.com/yyordanov-tradu/stock-scanner-mcp.git"}],"repo":{"found":true,"owner":"yyordanov-tradu","repo":"stock-scanner-mcp","archived":false,"pushedAt":"2026-09-21T13:52:13Z","stars":7,"forks":2,"openIssues":11,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/220154353?v=4","ownerCreatedAt":"2025-07-10T07:44:09Z","license":"MIT"},"icon":{"url":null,"source":"none"},"presence":{"stars":7,"forks":2,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-09-21T13:52:13.000Z","score":24}}}},"grade_history":[],"reviews":[]}