🎯 Wall Street Analyst Consensus & Price Target MCP

Ultra-fast (<3s) Zero-Proxy MCP Tool for AI Agents (Claude, Cursor, LangChain).
Analyzes Wall Street Investment Bank consensus price targets (Mean, Median, High, Low), upside potential (%), recommendation distribution (Strong Buy, Buy, Hold, Sell), and 4-quarter EPS surprise beat streaks in compact JSON and a 1-line Markdown summary.

---

⚡ Why AI Agents Need This MCP

1. Massive Token Reduction (<250 tokens vs 15,000+ tokens): Feeding multi-year equity research reports into LLMs rapidly exhausts context windows. This tool condenses Wall Street's institutional consensus into a high-density, actionable JSON structure.
2. Quantifies Asymmetric Upside: Immediately exposes the gap between current stock price and institutional consensus target (upside_potential_percent).
3. Earnings Surprise Momentum: Checks whether the company has beaten consensus EPS expectations over the last 4 consecutive quarters (four_quarter_beat_streak), signaling institutional earnings upgrades.
4. Pay-Per-Event Micro-Pricing: Only $0.008 per stock analyzed ($8.00 / 1,000 queries).

---

🎯 The Complete 4-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 ➔ Identify global liquidity and inflation regime (e.g. Goldilocks vs Stagflation).
2. Institutional Flow Check: Call smart-money-insider-flow-mcp ➔ Check 13F whale ownership and C-Suite insider buying.
3. Consensus & Valuation Check: Call wallstreet-consensus-target-mcp (this tool) ➔ Validate Wall Street target upside & 4Q earnings beat streak.
4. Timing & Execution: Call us-stock-etf-quant-signal-mcp ➔ Determine technical RSI turnaround, 20MA reclaim, and 2ATR stop-loss levels.

---

🔌 Claude Desktop & Cursor MCP Configuration

{
  "mcpServers": {
    "wallstreet-consensus": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/mcp-server",
        "--actor",
        "YOUR_APIFY_USERNAME/wallstreet-consensus-target-mcp"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_API_TOKEN"
      }
    }
  }
}

---

📦 Output Sample

{
  "ticker": "NVDA",
  "analyzed_at_kst": "2026-10-31 19:15:00 KST",
  "timestamp_utc": "2026-10-31 10:15:00 UTC",
  "current_price": 141.54,
  "consensus_verdict": "STRONG_CONVINCING_BUY (월가 강력 매수 컨센서스 + 높은 목표가 상승여력)",
  "consensus_score": 88.5,
  "target_prices": {
    "mean_target_usd": 175.20,
    "median_target_usd": 175.00,
    "high_target_usd": 220.00,
    "low_target_usd": 120.00,
    "upside_potential_percent": 23.78,
    "upside_high_percent": 55.43,
    "downside_risk_percent": -15.22
  },
  "analyst_consensus": {
    "number_of_analysts": 62,
    "recommendation_key": "STRONG_BUY",
    "recommendation_mean_score": 1.25,
    "consensus_stance": "OVERWHELMING_BUY_CONSENSUS (월가 80%+ 압도적 매수 추천)",
    "buy_ratio_percent": 91.9,
    "ratings_breakdown": {
      "strong_buy": 18,
      "buy": 39,
      "hold": 5,
      "underperform": 0,
      "sell": 0
    }
  },
  "earnings_surprise_momentum": {
    "last_quarter_eps_surprise": "+9.80%",
    "four_quarter_beat_streak": "4/4",
    "four_quarter_avg_surprise_percent": 11.45,
    "earnings_momentum_status": "PERFECT_4Q_BEAT_STREAK (최근 4분기 연속 어닝 서프라이즈 달성!)",
    "quarterly_history": [...]
  },
  "summary_md": "**NVDA Wall Street Consensus** | Verdict: STRONG_CONVINCING_BUY (Score: 88.5/100) | Current: $141.54 ➔ Target Mean: $175.2 (+23.78% Upside, High: $220.0) | Analysts: 62 (StrongBuy: 18, Buy: 39, Hold: 5, Sell: 0) | Rec: STRONG_BUY(1.25) | Last EPS Surprise: +9.80% (Beat Streak: 4/4)"
}

---

🛠️ Input Parameters

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

---

⚖️ License

Apache 2.0