yyordanov-tradu avatar

Stock Scanner Mcp

yyordanov-tradu/stock-scanner-mcp

Comprehensive market data server that wraps multiple financial APIs into 64 tools across stock scanning, technical analysis, options chains, insider trades, earnings calendars, crypto data, and macro indicators. Ships with 19 slash command skills that chain tools into complete workflows like /morning-briefing or /analyze-stock AAPL. Nine modules work with no API keys, pulling from Yahoo Finance and public sources. Optional keys for Finnhub, Alpha Vantage, and FRED unlock real-time quotes and news. Includes a stateful workspace layer that saves trading profiles, named watchlists, and thesis notes so your morning briefs are personalized to your actual positions. Good fit if you want Claude to handle market research without jumping between terminals and browser tabs.

GitHub stars
6
tools
69
auth
Secret needed
transport
STDIO
env vars
3
last updated
Mar 28, 2026

Tools

69 tools

Public tool metadata for what this MCP can expose to an agent.

tradingview_scanScan US stocks with custom filters (price, RSI, volume, etc.)

Scan US stocks with custom filters (price, RSI, volume, etc.)

No parameter schema in public metadata yet.

tradingview_compare_stocksSide-by-side comparison of 2-5 stocks

Side-by-side comparison of 2-5 stocks

No parameter schema in public metadata yet.

tradingview_quote15-min delayed quotes for stock tickers (includes pre/post-market)

15-min delayed quotes for stock tickers (includes pre/post-market)

No parameter schema in public metadata yet.

tradingview_technicalsTechnical indicators (RSI, MACD, moving averages, pivots)

Technical indicators (RSI, MACD, moving averages, pivots)

No parameter schema in public metadata yet.

tradingview_top_gainersToday's top gaining stocks by % change

Today's top gaining stocks by % change

No parameter schema in public metadata yet.

tradingview_top_losersToday's top losing stocks by % change

Today's top losing stocks by % change

No parameter schema in public metadata yet.

tradingview_top_volumeHighest volume stocks today

Highest volume stocks today

No parameter schema in public metadata yet.

tradingview_market_indicesReal-time VIX, S&P 500, NASDAQ, Dow Jones

Real-time VIX, S&P 500, NASDAQ, Dow Jones

No parameter schema in public metadata yet.

tradingview_sector_performanceS&P 500 sector ETF performance (weekly, monthly, YTD)

S&P 500 sector ETF performance (weekly, monthly, YTD)

No parameter schema in public metadata yet.

tradingview_volume_breakoutStocks with unusual volume (2x+ their 10-day average)

Stocks with unusual volume (2x+ their 10-day average)

No parameter schema in public metadata yet.

crypto_scanScan crypto pairs with custom filters across major exchanges

Scan crypto pairs with custom filters across major exchanges

No parameter schema in public metadata yet.

crypto_quoteReal-time crypto pair quotes (e.g. BTCUSDT, ETHUSDT)

Real-time crypto pair quotes (e.g. BTCUSDT, ETHUSDT)

No parameter schema in public metadata yet.

crypto_technicalsTechnical analysis for crypto pairs (RSI, MACD, MAs, Bollinger)

Technical analysis for crypto pairs (RSI, MACD, MAs, Bollinger)

No parameter schema in public metadata yet.

crypto_top_gainersTop gaining crypto pairs by % change

Top gaining crypto pairs by % change

No parameter schema in public metadata yet.

edgar_searchFull-text search across all SEC filings

Full-text search across all SEC filings

No parameter schema in public metadata yet.

edgar_company_filingsRecent official filings (10-K, 10-Q, 8-K) for a company

Recent official filings (10-K, 10-Q, 8-K) for a company

No parameter schema in public metadata yet.

edgar_company_factsFinancial metrics from XBRL data (Revenue, EPS, Net Income)

Financial metrics from XBRL data (Revenue, EPS, Net Income)

No parameter schema in public metadata yet.

edgar_insider_tradesInsider buy/sell activity with parsed Form 4 transaction details

Insider buy/sell activity with parsed Form 4 transaction details

No parameter schema in public metadata yet.

edgar_institutional_holdingsInstitutional holdings (13F) by ticker or manager name

Institutional holdings (13F) by ticker or manager name

No parameter schema in public metadata yet.

edgar_ownership_filingsMajor ownership changes — 13D/13G activist investor filings

Major ownership changes — 13D/13G activist investor filings

No parameter schema in public metadata yet.

coingecko_coinDetailed crypto info by CoinGecko slug (e.g. 'bitcoin', 'solana')

Detailed crypto info by CoinGecko slug (e.g. 'bitcoin', 'solana')

No parameter schema in public metadata yet.

coingecko_trendingTop 7 trending cryptos by search volume (last 24h)

Top 7 trending cryptos by search volume (last 24h)

No parameter schema in public metadata yet.

coingecko_globalGlobal crypto market cap, volume, BTC/ETH dominance

Global crypto market cap, volume, BTC/ETH dominance

No parameter schema in public metadata yet.

options_expirationsAvailable expiration dates for a stock's options

Available expiration dates for a stock's options

No parameter schema in public metadata yet.

options_chainFull options chain with Greeks for a given expiration

Full options chain with Greeks for a given expiration

No parameter schema in public metadata yet.

options_unusual_activityUnusual options activity — high volume/OI contracts

Unusual options activity — high volume/OI contracts

No parameter schema in public metadata yet.

options_max_painMax pain (strike where most options expire worthless)

Max pain (strike where most options expire worthless)

No parameter schema in public metadata yet.

options_implied_moveExpected move from ATM straddle pricing

Expected move from ATM straddle pricing

No parameter schema in public metadata yet.

options_put_call_ratioCBOE equity/index/total put/call ratio for market sentiment

CBOE equity/index/total put/call ratio for market sentiment

No parameter schema in public metadata yet.

sentiment_fear_greedCNN Fear & Greed Index — composite score (0-100) with 7 sub-indicators

CNN Fear & Greed Index — composite score (0-100) with 7 sub-indicators

No parameter schema in public metadata yet.

sentiment_crypto_fear_greedCrypto Fear & Greed Index — daily score (0-100) with historical values

Crypto Fear & Greed Index — daily score (0-100) with historical values

No parameter schema in public metadata yet.

frankfurter_latestLatest ECB exchange rates for 31 currencies

Latest ECB exchange rates for 31 currencies

No parameter schema in public metadata yet.

frankfurter_historicalExchange rates for a specific past date

Exchange rates for a specific past date

No parameter schema in public metadata yet.

frankfurter_timeseriesDaily rate history for a date range (max 90 days)

Daily rate history for a date range (max 90 days)

No parameter schema in public metadata yet.

frankfurter_convertConvert an amount between two currencies

Convert an amount between two currencies

No parameter schema in public metadata yet.

frankfurter_currenciesList all supported currency codes

List all supported currency codes

No parameter schema in public metadata yet.

reddit_trendingTrending stock tickers from Reddit by mention frequency across r/wallstreetbets, r/stocks, r/investing, r/options

Trending stock tickers from Reddit by mention frequency across r/wallstreetbets, r/stocks, r/investing, r/options

No parameter schema in public metadata yet.

reddit_mentionsMention count and top posts for a specific ticker across Reddit investing subreddits

Mention count and top posts for a specific ticker across Reddit investing subreddits

No parameter schema in public metadata yet.

reddit_sentimentKeyword-based sentiment analysis (bullish/bearish/neutral) for a ticker from Reddit discussions

Keyword-based sentiment analysis (bullish/bearish/neutral) for a ticker from Reddit discussions

No parameter schema in public metadata yet.

reddit_watchlist_scanBatch Reddit scan for a list of tickers in one pass (combined OR query, ceil(N/20)×4 requests) — per-ticker mentions, sentiment, top post, and a hot flag (≥5 mentions)

Batch Reddit scan for a list of tickers in one pass (combined OR query, ceil(N/20)×4 requests) — per-ticker mentions, sentiment, top post, and a hot flag (≥5 mentions)

No parameter schema in public metadata yet.

market_breadthGet market breadth statistics for US equities: advance/decline ratio, SMA 50/200 percent above, and 52-week new highs/lows

Get market breadth statistics for US equities: advance/decline ratio, SMA 50/200 percent above, and 52-week new highs/lows

No parameter schema in public metadata yet.

market_get_quoteGet current price, change, volume, and day high/low for a given symbol. Automatically routes to the best available data provider.

Get current price, change, volume, and day high/low for a given symbol. Automatically routes to the best available data provider.

No parameter schema in public metadata yet.

market_get_profileGet general company metrics, exchange, description, and capitalization. Automatically routes to the best available data provider.

Get general company metrics, exchange, description, and capitalization. Automatically routes to the best available data provider.

No parameter schema in public metadata yet.

market_get_technicalsGet common technical indicators (RSI, moving averages, etc.) for a given symbol.

Get common technical indicators (RSI, moving averages, etc.) for a given symbol.

No parameter schema in public metadata yet.

workspace_get_profileRead the saved trading profile and workspace defaults

Read the saved trading profile and workspace defaults

No parameter schema in public metadata yet.

workspace_update_profileSave or update trading style, asset focus, and review cadence

Save or update trading style, asset focus, and review cadence

No parameter schema in public metadata yet.

workspace_list_watchlistsList all saved watchlists and their resolved instruments

List all saved watchlists and their resolved instruments

No parameter schema in public metadata yet.

workspace_create_watchlistCreate a named empty watchlist such as `core` or `swing`

Create a named empty watchlist such as `core` or `swing`

No parameter schema in public metadata yet.

workspace_update_watchlistReplace a watchlist's saved symbols with resolved, deduplicated instruments

Replace a watchlist's saved symbols with resolved, deduplicated instruments

No parameter schema in public metadata yet.

workspace_get_thesisRead a thesis for a symbol using a stable hit/miss JSON shape

Read a thesis for a symbol using a stable hit/miss JSON shape

No parameter schema in public metadata yet.

workspace_save_thesisSave or update a thesis note for a symbol

Save or update a thesis note for a symbol

No parameter schema in public metadata yet.

finnhub_quoteReal-time stock quote

Real-time stock quote

No parameter schema in public metadata yet.

finnhub_company_profileCompany info (industry, market cap, IPO date, website)

Company info (industry, market cap, IPO date, website)

No parameter schema in public metadata yet.

finnhub_peersComparable companies in the same industry

Comparable companies in the same industry

No parameter schema in public metadata yet.

finnhub_market_statusExchange open/closed status and current session

Exchange open/closed status and current session

No parameter schema in public metadata yet.

finnhub_market_newsLatest market news (general, forex, crypto, merger)

Latest market news (general, forex, crypto, merger)

No parameter schema in public metadata yet.

finnhub_company_newsCompany-specific news by ticker and date range

Company-specific news by ticker and date range

No parameter schema in public metadata yet.

finnhub_earnings_calendarUpcoming and historical earnings reports

Upcoming and historical earnings reports

No parameter schema in public metadata yet.

finnhub_analyst_ratingsAnalyst consensus and rating history

Analyst consensus and rating history

No parameter schema in public metadata yet.

finnhub_short_interestShort interest, short ratio, and key financial metrics

Short interest, short ratio, and key financial metrics

No parameter schema in public metadata yet.

alphavantage_quoteReal-time stock quote (price, change, volume)

Real-time stock quote (price, change, volume)

No parameter schema in public metadata yet.

alphavantage_dailyDaily OHLCV price history (up to 100 days)

Daily OHLCV price history (up to 100 days)

No parameter schema in public metadata yet.

alphavantage_overviewCompany fundamentals (PE, market cap, sector, analyst target)

Company fundamentals (PE, market cap, sector, analyst target)

No parameter schema in public metadata yet.

alphavantage_earnings_historyHistorical EPS actual vs estimate by quarter

Historical EPS actual vs estimate by quarter

No parameter schema in public metadata yet.

alphavantage_dividend_historyHistorical dividend payments and dates

Historical dividend payments and dates

No parameter schema in public metadata yet.

fred_economic_calendarUpcoming high-impact economic releases (FOMC, CPI, NFP, GDP)

Upcoming high-impact economic releases (FOMC, CPI, NFP, GDP)

No parameter schema in public metadata yet.

fred_indicatorLatest value for any indicator (CPI, fed funds, unemployment, etc.)

Latest value for any indicator (CPI, fed funds, unemployment, etc.)

No parameter schema in public metadata yet.

fred_indicator_historyHistorical values with unit transforms (YoY %, change, level)

Historical values with unit transforms (YoY %, change, level)

No parameter schema in public metadata yet.

fred_searchDiscover FRED series IDs by keyword

Discover FRED series IDs by keyword

No parameter schema in public metadata yet.

Sponsors

Configuration

FINNHUB_API_KEYsecret

Finnhub API key for real-time quotes, news, earnings

ALPHA_VANTAGE_API_KEYsecret

Alpha Vantage API key for fundamentals, daily prices

FRED_API_KEYsecret

FRED API key for economic indicators and calendar

Readme

stock-scanner-mcp

CI npm version npm downloads

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:


View the full README on GitHub

Details

Repository
github.com/yyordanov-tradu/stock-scanner-mcp
Categories
Data & Analytics, Finance & Commerce
Package
stock-scanner-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Data & Analytics MCP servers

View all
1leandrogavidia avatarLeandrogavidia Vechain Mcp Serverleandrogavidia/vechain-mcp-serverSearch VeChain documentation, query on-chain data, and fetch fee suggestions with direct links to…5stars
2anthonypuggs avatarAustralian Economic Data (ABS, RBA & APRA)anthonypuggs/ausecon-mcp-serverAustralian economic data from the ABS, RBA, and APRA: CPI, GDP, cash rate, labour, and more.5stars
3hasdata avatarHasData Binghasdata/bing-mcpBing search results with the ad block and Copilot answer, geo and market targeting, as JSON.5stars
4hasdata avatarHasData Google Flightshasdata/google-flights-mcpGoogle Flights itineraries with fares, legs, carbon emissions and price history, as JSON.5stars
5hasdata avatarHasData Google Trendshasdata/google-trends-mcpGoogle Trends interest over time, by region, and related queries and topics, as JSON.5stars
6hasdata avatarHasData Shopifyhasdata/shopify-mcpThe public product catalogue and collections of any Shopify storefront, as structured JSON.5stars