@lazymac/stock-alpha-mcp
v0.1.0
Published
US stock alpha signals MCP — DCF + SEC EDGAR + sector momentum + small-cap filter, encoding the Lumen-Dexter v4 buy/avoid logic for AI agents researching US equities.
Maintainers
Readme
Stock Alpha MCP
US equities alpha signals for AI agents — DCF, SEC EDGAR, sector rotation, small-cap filter. Free data, encoded with the Lumen-Dexter v4 logic.
Tools
quote(symbol)— current price + 52w range + day changeprice_history(symbol, range)— daily OHLC (1mo / 3mo / 6mo / 1y / 2y / 5y)sec_filings(ticker, limit)— latest 10-K / 10-Q / 8-K filings with URLssmall_cap_screen(symbols, max_price, min_change_30d)— Lumen-Dexter v4 small-cap filter (max $250, no free-falls)dany_test(symbol)— "Would I buy this with my own $200?" heuristic. green / yellow / red.sector_rotation()— 30d sector ETF leaders / laggards (XLK, XLF, ..., XLC)
Install
npm install -g @lazymac/stock-alpha-mcpOr in Claude Code:
claude mcp add stock-alpha --scope user -- npx -y @lazymac/stock-alpha-mcp@latestPricing
- Free — personal use, public data only
- $29/mo Pro (coming): SEC EDGAR full-text search, custom screeners, Lumen-Dexter
composite_v3(rule + LLM + DCF + SEC) score
Why it exists
After running a US stock momentum bot (Lumen-Dexter v4) for a month, I extracted the most reusable analytical pieces — the small-cap filter, the dany_test heuristic, the sector rotation snapshot — and wrapped them as MCP tools. Anyone running an AI agent that touches US equities can bolt this on in 30 seconds.
Free data sources only: yfinance public API + SEC EDGAR. No tokens needed.
License
MIT.
