# stock-scanner-mcp

This MCP server gives an agent stock and crypto data for quotes, technical analysis, options, and SEC filings. Use it for market scans and briefings.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: yyordanov-tradu
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/yyordanov-tradu/stock-scanner-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/stock-scanner-mcp

## What it does

\`stock-scanner-mcp` connects an agent to tools for stock and crypto research. It can screen equities by filters, return RSI, MACD, Bollinger Bands, and moving averages, inspect options chains, parse insider activity, follow earnings and news, and retrieve macroeconomic and forex data. The server exposes 49 tools without API keys; keys for Finnhub, Alpha Vantage, and FRED add 20 more.

It runs through `npx`. In Claude Code, add it with the command below and pass the three environment variables. A stateful workspace can be enabled with `--enable-workspace`; it stores a trader profile, watchlists, and thesis notes in `~/.stock-scanner-mcp`. Without the API keys, modules that depend on those market-data services will not provide their data, so quotes, news, earnings, and economic indicators require the relevant keys.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FINNHUB_API_KEY`, `ALPHA_VANTAGE_API_KEY`, `FRED_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add stock-scanner-mcp -e FINNHUB_API_KEY=<FINNHUB_API_KEY> -e ALPHA_VANTAGE_API_KEY=<ALPHA_VANTAGE_API_KEY> -e FRED_API_KEY=<FRED_API_KEY> -- npx -y stock-scanner-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add stock-scanner-mcp --env FINNHUB_API_KEY=<FINNHUB_API_KEY> --env ALPHA_VANTAGE_API_KEY=<ALPHA_VANTAGE_API_KEY> --env FRED_API_KEY=<FRED_API_KEY> -- npx -y stock-scanner-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "stock-scanner-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "stock-scanner-mcp"
            ],
            "env": {
                "FINNHUB_API_KEY": "<FINNHUB_API_KEY>",
                "ALPHA_VANTAGE_API_KEY": "<ALPHA_VANTAGE_API_KEY>",
                "FRED_API_KEY": "<FRED_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "stock-scanner-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "stock-scanner-mcp"
            ],
            "env": {
                "FINNHUB_API_KEY": "<FINNHUB_API_KEY>",
                "ALPHA_VANTAGE_API_KEY": "<ALPHA_VANTAGE_API_KEY>",
                "FRED_API_KEY": "<FRED_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FINNHUB_API_KEY=<FINNHUB_API_KEY> -e ALPHA_VANTAGE_API_KEY=<ALPHA_VANTAGE_API_KEY> -e FRED_API_KEY=<FRED_API_KEY> stock-scanner-mcp npx -y stock-scanner-mcp
```
Replace <…> with your own values

## When to use it
- screen stocks by price, RSI, volume, and market cap
- compare technical signals across tickers
- inspect options chains and unusual activity
- track insider transactions and earnings dates
- build a personalized morning brief from a watchlist

## Example prompts
- Show technicals for `AAPL` on the hourly timeframe and point out the key levels.
- Compare `TSLA` and `NVDA` using price action, volume, and technical indicators.
- Create a morning market brief from my saved watchlist, including crypto data.

## Similar
- [Wudao A-Share Stock Data MCP](https://affpapa.org/en/nevibecode/mcp/wudao-a-share-stock-data-mcp.md) — MCP server · ★ 11
- [stock-correlation](https://affpapa.org/en/nevibecode/skills/stock-correlation.md) — skill · 3400 installs
- [xinkuang-china-stock-mcp](https://affpapa.org/en/nevibecode/mcp/xinkuang-china-stock-mcp.md) — MCP server · ★ 46
- [stock-quote](https://affpapa.org/en/nevibecode/skills/stock-quote.md) — skill · 691 installs
- [TickDB Market Data](https://affpapa.org/en/nevibecode/mcp/tickdb-market-data.md) — MCP server · ★ 893
- [stock-market-pro](https://affpapa.org/en/nevibecode/skills/stock-market-pro.md) — skill · 4100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md