top_opportunities

io.github.quantustik/mcp · Verify this server

Get a small, risk-vetted shortlist of asymmetric setups passing every gate right now. This is NOT a screener. Where scan_universe returns up to 100 sortable rows, top_opportunities answers the real question — "what are the 1-3 highest-conviction setups right now, and what's the catch on each?" — and deliberately returns FEW or ZERO names. A setup is included ONLY if it passes ALL of: • current market conditions permit new longs (not Caution / Strong Avoid), • conviction >= 7.5 (high-conviction floor — multi-signal convergence), and • risk-reward >= 2:1 with concrete entry + stop levels. AN EMPTY LIST IS A VALID, HONEST ANSWER. In a hostile or unclear market the right call is to wait — a missed trade is cheap, a bad trade is expensive. When nothing qualifies, `count` is 0, `results` is empty, and `message` explains why (e.g. the market is hostile, or no name cleared the bar). Every returned item carries its bear case in `key_risk` so you never present a one-sided pitch. Each also includes the full entry_plan / exit_plan / sizing from get_trade_plan. Args: max_results: How many setups to return (1–5, default 3). Capped at 5 — this surface is intentionally sparse. Returns a dict with count, regime (the market verdict — key name kept for existing integrations), message, results (each with ticker, verdict, conviction, entry_plan, exit_plan, sizing, rr_ratio, key_risk), and disclaimer embedded in the payload.