MCP.Market

Stock Scanner MCP server

by yyordanov-tradu·io.github.yyordanov-tradu/stock-scanner-mcp·v1.13.1·7 stars
No reviews yet

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

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

7 stars

Reviews

Write one

Nobody has reviewed Stock Scanner yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Stock Scanner tools (58, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • alpha-vantage

    Alpha Vantage stock data -- quotes, daily prices, and company fundamentals

  • alphavantage_daily

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

  • alphavantage_dividend_history

    Get historical dividend data for a specific ticker. Rate limit: 25 calls/day, 5 calls/min (free tier).

  • alphavantage_earnings_history

    Get historical earnings data (EPS actual vs estimate) for a specific ticker. Rate limit: 25 calls/day, 5 calls/min (free tier).

  • alphavantage_overview

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

  • alphavantage_quote

    Get real-time stock quote from Alpha Vantage. Returns price, change, volume, and day range. Rate limit: 5 calls/min on free tier.

  • coingecko

    CoinGecko crypto data -- coin details, trending coins, and global market stats

  • coingecko_coin

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

  • coingecko_global

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

  • coingecko_trending

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

  • crypto_quote

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

  • crypto_scan

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

  • crypto_technicals

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

  • crypto_top_gainers

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

  • edgar_company_facts

    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.

  • edgar_company_filings

    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.

  • edgar_insider_trades

    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.

  • edgar_institutional_holdings

    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.

  • edgar_ownership_filings

    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.

  • edgar_search

    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.

  • finnhub

    Finnhub market data: quotes, company profiles, peers, news, earnings, analyst ratings, short interest, and market status

  • finnhub_analyst_ratings

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

  • finnhub_company_news

    Get recent news for a specific company by ticker symbol. Rate limit: 60 calls/min (free tier).

  • finnhub_company_profile

    Get company profile: name, industry, market cap, IPO date, logo, website, share count, and exchange. Rate limit: 60 calls/min (free tier).

  • finnhub_earnings_calendar

    Get upcoming or historical earnings reports within a date range. Rate limit: 60 calls/min (free tier).

  • finnhub_market_news

    Get latest market news by category (general, forex, crypto, merger). Rate limit: 60 calls/min (free tier).

  • finnhub_market_status

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

  • finnhub_peers

    Get a list of peer/comparable companies in the same industry for a given stock. Rate limit: 60 calls/min (free tier).

  • finnhub_quote

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

  • finnhub_short_interest

    Get short interest and other key financial metrics for a stock. Rate limit: 60 calls/min (free tier).

  • fred

    FRED economic data: calendar, indicators, interest rates, inflation

  • fred_economic_calendar

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

  • fred_indicator

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

  • fred_indicator_history

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

  • fred_search

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

  • options

    Stock options chains, Greeks, unusual activity, implied move, and max pain from Yahoo Finance (no API key required)

  • options-cboe

    CBOE market-wide put/call ratio data \u2014 daily sentiment indicator from options volume

  • options_chain

    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.

  • options_expirations

    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.

  • options_implied_move

    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.

  • options_max_pain

    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.

  • options_put_call_ratiowrite action

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

  • options_unusual_activity

    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.

  • sec-edgar

    SEC EDGAR filing search -- full-text search and company filing lookup via EFTS

  • sentiment_crypto_fear_greed

    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.

  • sentiment_fear_greed

    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

  • tradingview

    TradingView stock scanner \u2014 prices, technicals, and screener filters for US equities

  • tradingview-crypto

    TradingView crypto scanner -- real-time quotes, technical analysis, and screening for cryptocurrency pairs

  • tradingview_compare_stocks

    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.

  • tradingview_market_indices

    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_quote

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

  • tradingview_scan

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

  • tradingview_sector_performance

    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_technicals

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

  • tradingview_top_gainers

    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.

  • tradingview_top_losers

    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.

  • tradingview_top_volume

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

  • tradingview_volume_breakout

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

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan9 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 6 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Stock Scanner compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 75% of 1,761 Finance servers
Tools
58
the typical Finance server has 8
Tools that change things
2%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
7
more than 87% of 946 Finance servers

What its tools let an agent do: 57 read · 1 change

Install Stock Scanner in Claude Code, Cursor or VS Code

Runs npx -y stock-scanner-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add stock-scanner-mcp -- npx -y stock-scanner-mcp
Add to Cursor

What the publisher says

From the Stock Scanner repository's README, as published. We do not edit it. Read it on GitHub

stock-scanner-mcp

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.

69 tools across 15 modules — 11 modules work with zero API keys, including an optional stateful Market Workspace.

Quick Start

Three steps to get the full experience: server config, trading skills, and workspace setup.

Step 1 — Add the server to your MCP config

Copy this complete config block into your config file:

  • Claude Code: ~/.claude.json (global) or .mcp.json (project-local)
  • Claude Desktop: ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows)
{
  "mcpServers": {
    "stock-scanner": {
      "command": "npx",
      "args": ["-y", "stock-scanner-mcp", "--enable-workspace"],
      "env": {
        "FINNHUB_API_KEY": "your-key-here",
        "ALPHA_VANTAGE_API_KEY": "your-key-here",
        "FRED_API_KEY": "your-key-here"
      }
    }
  }
}

This gives you 49 tools immediately with no API keys. API keys are optional and free — they unlock 20 additional tools for real-time quotes, news, earnings, and economic data. See API Keys below for where to get them.

Minimal config — if you don't want workspace or API keys, use this instead:

json

{

"mcpServers": {

"stock-scanner": {

"command": "npx",

"args": ["-y", "stock-scanner-mcp"]

}

}

}

This gives you 42 stateless tools with no local data storage.

Restart Claude Desktop after saving. Claude Code picks up the config automatically.

Claude Code shortcut — install as a plugin instead of Steps 1 and 2. If you use Claude Code, skip the manual config above and install everything with two commands:

/plugin marketplace add yyordanov-tradu/stock-scanner-mcp

/plugin install stock-scanner@tradu-marketplace

Run /reload-plugins, then /mcp — you should see the stock-scanner server listed as connected. The first launch runs npx -y stock-scanner-mcp, which downloads the package once (then it is cached). The plugin enables the workspace by default (data is stored in ~/.stock-scanner-mcp) and passes the optional API keys (FINNHUBAPIKEY, ALPHAVANTAGEAPIKEY, FREDAPI_KEY) through from your environment; modules without a key are skipped automatically.

The plugin already bundles the skills — do NOT run Step 2. All 19 skills ship with the plugin and load under the stock-scanner: namespace, e.g. /stock-scanner:analyze-stock AAPL, /stock-scanner:morning-briefing, /stock-scanner:setup-market-workspace. Running the Step 2 installer as well copies a second, unprefixed set into ~/.claude/skills/, and the two collide — Step 2 is only for the manual (non-plugin) install. After installing, go straight to Step 3, using the namespaced command: /stock-scanner:setup-market-workspace.

Step 2 — Install the trading skills

Skip this step if you installed via the plugin above — the plugin already bundles these skills (as stock-scanner:). This step is only for the manual config in Step 1.

Run this command in your terminal:

npx -p stock-scanner-mcp stock-scanner-install-skills

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Stock Scanner: common questions

Is Stock Scanner MCP server safe?
Mostly: it is graded B (83/100). Read the Stock Scanner safety report
How do I install Stock Scanner?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Stock Scanner need an API key?
Yes. The registry entry asks for FINNHUB_API_KEY, ALPHA_VANTAGE_API_KEY, FRED_API_KEY.
Is Stock Scanner maintained?
The last commit was 44 days ago (2026-09-21). The latest release is v1.13.1.
What can I use instead of Stock Scanner?
Servers from other publishers that do the same job: Tapetide - Indian Stock Market MCP server, Alpha Vantage MCP server and TickDB Market Data MCP server.
How does Stock Scanner compare with other Finance MCP servers?
safety score 83/100 (higher than 75% of 1,761 Finance servers); tools 58 (the typical Finance server has 8); tools that change things 2% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Stock Scanner

Same job from other publishers: the closest match first, then the best rated.

  • Tapetide - Indian Stock Market MCP
    48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
    A
  • Alpha Vantage
    Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
    A
  • TickDB Market Data
    Real-time & historical market data: forex, stocks, crypto, indices, metals, K-line, quotes
    B
  • Twelvedata
    Twelve Data MCP: real-time & historical market data (stocks, crypto, forex, etc).
    A
  • Torus
    Stock research memory for Claude: theses, sourced claims and SEC filing alerts in a local graph
    A