stock-scanner

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

Run/setup-market-workspacein Claude Code. It asks three quick questions:

> /setup-market-workspace Setting up your market workspace — I'll ask a few quick questions to get started... 1. What kind of trader or investor are you? (e.g., options trader, swing trader, long-term investor, crypto-focused) → "I'm mostly a swing trader, also watch crypto" 2. Which names or assets should I save to your core watchlist? (e.g., AAPL, MARA, BTC, Gold) → "MARA, HOOD, SOFI, BTC, ETH" 3. Do you want a daily or weekly market review? → "Daily"

Once answered, it saves your profile and creates acorewatchlist:

✓ Workspace saved Profile swing trader | daily review Watchlist core — MARA, HOOD, SOFI, BTC, ETH

You can also skip the skill and ask Claude directly:"Set up my workspace — I'm a swing trader, create a core watchlist with MARA, HOOD, BTC, daily reviews."

That's it.You now have 69 tools, 19 skills, and a personalized workspace. Try/workspace-morning-brieffor your first tailored market scan.

"What are the top gaining stocks today?" "Show me technicals for AAPL on the hourly timeframe" "Any insider trades for TSLA in the last 30 days?" "What's the options chain for AAPL expiring next Friday?" "What's the current fed funds rate and CPI trend?" "Convert $10,000 USD to EUR" "Set up a core watchlist with MARA, HOOD, and BTC" "Give me a personalized morning brief for my saved watchlist"

- Stock scanning— screen by price, RSI, volume, market cap with custom filters
- Technical analysis— RSI, MACD, Bollinger Bands, moving averages, pivots across multiple timeframes
- Options flow— chains with Greeks, unusual activity detection, max pain, implied move
- Insider trades— parsed Form 4 transactions with buy/sell/grant details
- Earnings & news— calendar, analyst ratings, company news, short interest
- Crypto— real-time quotes, technicals, trending coins, market stats
- Macro— CPI, GDP, fed funds rate, economic calendar, yield curve data
- Forex— 31 currency pairs from ECB, conversion, historical rates
- Sentiment— CNN Fear & Greed Index, Crypto Fear & Greed
- Market Workspace— save a trading profile, named watchlists, and thesis notes for personalized workflows across sessions

19 ready-made workflows that chain multiple tools into structured analysis. Each skill orchestrates 5-14 tools in parallel and outputs a verdict with direction, confidence, and key levels.

Skills degrade gracefully when optional API keys are missing. Workspace skills require--enable-workspacein the server config.

npx -p stock-scanner-mcp stock-scanner-install-skills # all 19 skills npx -p stock-scanner-mcp stock-scanner-install-skills --scope project # project only (.claude/skills/) npx -p stock-scanner-mcp stock-scanner-install-skills --category macro # one category npx -p stock-scanner-mcp stock-scanner-install-skills --category workspace # workspace skills only npx -p stock-scanner-mcp stock-scanner-install-skills --list # list without installing npx -p stock-scanner-mcp stock-scanner-install-skills --force # overwrite existing

Manual:git clonethis repo andcp -r skills// ~/.claude/skills/

- /workspace-morning-brief— personalized pre-market scan that reads your profile and watchlist, checks earnings, news, and price action for your names, and highlights what matters today
- Add more watchlists— ask Claude:"Create a watchlist called 'earnings' with AAPL, MSFT, GOOG"
- Track investment theses— save your reasoning per ticker so the system monitors it for you (see below)
- Update anytime—"Add NVDA to my core watchlist"or"Change my review cadence to weekly"

"My thesis on NIO: bullish above $6.35, that confirms the uptrend. Below it the setup is invalid."

- NIO drops to $6.10 →"NIO broke below your $6.35 thesis floor — re-evaluate."
- NIO rallies to $7.20 →"NIO holding above your $6.35 level — uptrend thesis intact."*

Without a thesis, the brief just reports a price change. With a thesis, it tells youwhether the move matters to your plan.

Each thesis supports five fields:summary,bullCase,bearCase,catalyst, andtimeframe. You can save up to 200 theses per workspace.

Data is stored locally inworkspace.json— no cloud sync, no external calls. If you omit--enable-workspace, the server stays fully stateless and writes no local data.

Modules auto-enable when their API key is set. No-key modules are always enabled, exceptworkspace, which requires--enable-workspace.

TradingView — Stock Scanning (no API key)

SEC EDGAR — Filings & Ownership (no API key)

CoinGecko — Crypto Intelligence (no API key)

Options — Chains, Greeks & Unusual Activity (no API key)

Options CBOE — Put/Call Sentiment (no API key)

Sentiment — Fear & Greed (no API key)

Reddit — Trending Tickers & Sentiment (no API key)

Market Breadth — Breadth Indicators (no API key)

Unified Market — Smart Routing (no API key)

Workspace — Personalized Context (optional, no API key)

Enabled only when you start the server with--enable-workspace.

Finnhub — News, Earnings & Macro (requiresFINNHUB_API_KEY)

Alpha Vantage — Fundamentals & History (requiresALPHA_VANTAGE_API_KEY)

FRED — US Economic Data (requiresFRED_API_KEY)

npx -y stock-scanner-mcp --modules tradingview,sec-edgar # Enable specific modules only npx -y stock-scanner-mcp --default-exchange NYSE # Set default exchange npx -y stock-scanner-mcp --enable-workspace # Turn on local workspace tools npx -y stock-scanner-mcp --enable-workspace --data-dir /tmp/market-workspace # Custom data directory npx -y stock-scanner-mcp --help # Show all options

All three keys arefree— no credit card required:

An optional HTTP server exposing all tools as REST endpoints for non-MCP integrations (GPT Actions, chat UIs, LLM pipelines). It includes anOpenAPI 3.1specification for automated tool discovery.

npx stock-scanner-sidecar # Start on port 3200 npx stock-scanner-sidecar --port 8080 # Custom port # Optional: Enable the stateful Market Workspace via HTTP npx stock-scanner-sidecar --enable-workspace --data-dir ./my-data # Access the OpenAPI spec curl http://localhost:3200/openapi.json

69 toolsexposed as REST routes, including/market/quote,/options/chain,/workspace/profile, and more.

All modules use in-memory TTL caching to minimize API calls.

npm install && npm run build && npm test npm run lint # TypeScript type checking npm run validate-tools # Tool description quality check npm run validate-doc-tools # Skill/command tool reference check

src/ ├── index.ts # MCP server entry + prompt definitions ├── config.ts # CLI arg parsing ├── registry.ts # Module auto-discovery and filtering ├── modules/ │ ├── tradingview/ # 10 tools — stock scanning, quotes, technicals, sectors, indices │ ├── tradingview-crypto/ # 4 tools — crypto scanning and technicals │ ├── sec-edgar/ # 6 tools — filings, insider trades, holdings │ ├── coingecko/ # 3 tools — crypto market data │ ├── options/ # 5 tools — options chains, Greeks, unusual activity, implied move │ ├── options-cboe/ # 1 tool — CBOE put/call ratio sentiment │ ├── workspace/ # 7 tools — stateful profile, watchlists, thesis notes │ ├── finnhub/ # 9 tools — quotes, news, earnings, analyst ratings, short interest │ ├── alpha-vantage/ # 5 tools — quotes, fundamentals, dividends │ ├── fred/ # 4 tools — economic calendar, indicators, historical data │ ├── sentiment/ # 2 tools — Fear & Greed indexes (market + crypto) │ ├── frankfurter/ # 5 tools — forex exchange rates (ECB, 31 currencies) │ ├── reddit/ # 4 tools — trending tickers, mentions, sentiment, watchlist scan from Reddit │ └── unified-market/ # 3 tools — smart provider routing for quotes/profiles/technicals ├── sidecar/ │ ├── index.ts # HTTP sidecar entry point (port 3200) │ ├── routes.ts # Declarative URL routing table │ └── server.ts # Dynamic HTTP request handler └── shared/ ├── http.ts # HTTP client with timeouts and key sanitization ├── cache.ts # In-memory TTL cache ├── types.ts # ToolDefinition, ToolResult, helpers ├── resolver.ts # Ticker/exchange resolution └── utils.ts # withMetadata error wrapper

Market briefings for AI agents with trend signals, regime classification, and confidence scores across Bitcoin, macro, FX, and cross-asset data.

185 agent-payable C-suite intelligence tools — competitive intel, SEC filings, sanctions, KYC, clinical evidence, ESG. x402 USDC/EURC. 100 free calls/mo.

Shariah-compliant investing for AI agents — screen stocks & ETFs across 5 methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P), audit portfolios, calculate zakat, get market data, news & SEC filings.

Provides real-time crypto and Web3 intelligence using the Hive Intelligence API.

Institutional research and manager diligence reports on hedge funds, venture capital and private equity managers. Summary of filings, personnel changes, media screening and social signals delivered to you in minutes.

MCP to interface with multiple blockchains, staking, DeFi, swap, bridging, wallet management, DCA, Limit Orders, Coin Lookup, Tracking and more.

Financial intelligence for AI agents — 31 tools across 8 data sources including regime, derivatives, stablecoin flows, momentum, macro, weather patterns, and political cycles.