🚀 US Short Squeeze & Short Interest Scanner MCP

Ultra-fast (<3s) Zero-Proxy MCP Tool for AI Agents (Claude, Cursor, LangChain).
Analyzes short percent of float, days to cover (short ratio), Month-over-Month short accumulation, and computes a quantitative Short Squeeze Score (0-100) with Squeeze Risk Classification in compact JSON and a 1-line Markdown summary.

---

⚡ Why AI Agents Need This MCP

1. Detects Asymmetric Short Squeeze Primers: High short interest combined with high Days to Cover creates explosive powder-keg conditions where sudden buying pressure forces aggressive short covering.
2. Downside Risk Protection: Warns long-only trading agents when massive institutional short positions are aggressively accumulating (+20% MoM), helping avoid catastrophic traps.
3. 95% LLM Context Token Saving: Raw FINRA/exchange short interest data is scattered and verbose. This tool consolidates everything into a clean <250-token payload.
4. Pay-Per-Event Micro-Pricing: Only $0.008 per stock analyzed ($8.00 / 1,000 queries).

---

🎯 The Complete 6-Step Hedge Fund Agent Pipeline

Run an end-to-end institutional grade investment check across our MCP suite:

1. Macro Check: Call macro-regime-liquidity-mcp ➔ Determine global risk regime (Goldilocks vs Stagflation).
2. Smart Money Check: Call smart-money-insider-flow-mcp ➔ Confirm institutional backing & CEO insider buying.
3. Wall Street Consensus: Call wallstreet-consensus-target-mcp ➔ Check IB price targets & 4Q earnings beat streak.
4. Short Squeeze Check: Call us-short-squeeze-sentiment-mcp (this tool) ➔ Check short float %, days to cover, and squeeze score.
5. Dividend Safety Check: Call us-dividend-safety-growth-mcp ➔ Verify payout safety and cash flow coverage.
6. Timing & Execution: Call us-stock-etf-quant-signal-mcp ➔ Identify Wilder RSI turnaround, 20MA reclaim, and 2ATR stop-loss levels.

---

🔌 Claude Desktop & Cursor MCP Configuration

{
  "mcpServers": {
    "short-squeeze": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/mcp-server",
        "--actor",
        "YOUR_APIFY_USERNAME/us-short-squeeze-sentiment-mcp"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_API_TOKEN"
      }
    }
  }
}

---

📦 Output Sample

{
  "ticker": "GME",
  "company_name": "GameStop Corporation",
  "analyzed_at_kst": "2026-10-31 20:10:00 KST",
  "timestamp_utc": "2026-10-31 11:10:00 UTC",
  "current_price": 24.50,
  "squeeze_risk_level": "HIGH_SQUEEZE_POTENTIAL (높은 스퀴즈 잠재력: 호재 발생 시 가파른 커버링 반등 구간)",
  "short_squeeze_score": 68.5,
  "short_interest_data": {
    "short_percent_of_float": 10.32,
    "short_percent_of_shares_out": 9.52,
    "days_to_cover_short_ratio": 4.33,
    "shares_short": 48031618,
    "shares_short_prior_month": 39069126,
    "short_change_mom_percent": 22.94,
    "short_trend_status": "MASSIVE_ACCUMULATION (전월 대비 공매도 +20% 이상 급증, 숏 포지션 과열)",
    "short_dollar_volume_usd": 1176774641.0,
    "settlement_date": "2026-10-15"
  },
  "share_structure": {
    "float_shares": 460412648,
    "shares_outstanding": 504500990
  },
  "score_breakdown": {
    "short_percent_of_float_score_weight_40": 20.8,
    "days_to_cover_score_weight_35": 22.7,
    "mom_trend_score_weight_25": 25.0,
    "total_short_squeeze_score": 68.5
  },
  "summary_md": "**GME Short Squeeze** | Squeeze Score: 68.5/100 (HIGH_SQUEEZE_POTENTIAL) | Short Float: 10.32% | Days to Cover: 4.33d | MoM Δ: +22.94% | Short Shares: 48,031,618 ($1.18B) | Settlement Date: 2026-10-15"
}

---

🛠️ Input Parameters

Parameter	Type	Default	Description
tickers	array	["GME", "AMC", "CVNA", "TSLA", "NVDA"]	List of US stock tickers to analyze.
maxItems	integer	50	Maximum number of tickers to analyze per run.

---

⚖️ License

Apache 2.0