Living Screener MCP

Review-only hosted MCP for market scanning, trade planning, risk checks, journaling, and postmortems.

This app does not store Robinhood credentials, does not call Robinhood APIs, and cannot place brokerage orders. Robinhood Trading MCP stays separate for broker data, order review, and any future exact user-approved execution.

Current Build

2026.06.08-backtest-rvol

Render Environment

Keep your Finnhub key only in Render:

FINNHUB_API_KEY=<your key>

The checked-in render.yaml defaults to:

MARKET_DATA_PROVIDER=finnhub
MARKET_DATA_INTERVAL=5m
MARKET_DATA_PERIOD=5d
MAX_DATA_STALENESS_MINUTES=1440
REGULAR_MARKET_MAX_STALENESS_MINUTES=15
REVIEW_ONLY=true
PLACE_ORDERS=false
HOSTED_MODE=false
PENDING_BUY_RECHECK_SECONDS=60
SCALP_CANDIDATE_SCORE_THRESHOLD=58

This blueprint uses Render's free web-service plan and does not attach a persistent disk. That keeps the first hosted version inexpensive, but local SQLite journal entries can disappear after Render sleeps, restarts, or redeploys the service. The scanner and safety checks still work normally.

Finnhub is used as the primary quote source. Finnhub's stock candle endpoint may require paid access, so this build safely falls back to yfinance for candles when Finnhub returns no candle data. Market-closed freshness handling accepts the latest regular-session close during overnight and weekend periods instead of rejecting it just because the market is closed.

Options trade plans are gated by separate options-chain validation. The MCP checks bid/ask spread, volume, open interest, expiration risk, and max loss before any review-only options plan can be produced. If those fields are missing or weak, the result is NO_TRADE_PLAN.

Use review_candidate_for_options when a stock candidate appears. It runs the stock setup review and the options-chain gate together so the result is either NO_TRADE_PLAN or REVIEW_ONLY_OPTIONS_READY.

Pending buy orders should be reconsidered after 60 seconds. Use review_pending_buy_order with the ticker, submitted timestamp, and limit price. It cannot cancel or replace anything; it returns whether the pending buy is still valid for review or needs reconsideration.

Use run_scalp_scan for a broader review-only moving-equities scan. It uses a larger liquid/options-friendly universe and scores absolute movement, recent momentum, relative volume, and VWAP alignment. This mode is wider, but it still only produces review candidates; options and pending-order gates remain separate.

Scalp options reviews have a hard relative-volume gate. If a scalp candidate's relative volume is below SCALP_MIN_RELATIVE_VOLUME, review_candidate_for_options returns WATCH_ONLY instead of REVIEW_ONLY_OPTIONS_READY, even when the option chain is liquid.

Backtests now apply the scalp relative-volume gate when the engine name includes scalp, and return aggregate horizon summaries for 15m, 30m, 1h, and the configured close/forward window.

Verify Live Deploy

Open:

https://living-screener-mcp.onrender.com/version
https://living-screener-mcp.onrender.com/tools
https://living-screener-mcp.onrender.com/config
https://living-screener-mcp.onrender.com/health

/version should show:

{
  "build_version": "2026.06.08-backtest-rvol",
  "market_data_provider": "finnhub",
  "has_finnhub_api_key": true,
  "can_place_order_from_this_mcp": false
}

Local Run

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe -m unittest discover -s tests
.\.venv\Scripts\python.exe -m uvicorn app.main:app --host 127.0.0.1 --port 8000

MCP Endpoint

https://living-screener-mcp.onrender.com/mcp

Use no auth while HOSTED_MODE=false. Do not send private account data while no auth is enabled.