🌐 Global Macro Regime & Liquidity Scanner MCP

Ultra-fast (<3s) Zero-Proxy MCP Tool for AI Agents (Claude, Cursor, LangChain).
Computes macroeconomic regime (Goldilocks, Stagflation, Reflation, Deflation), market Risk Appetite Score (0-100), and tactical asset allocation recommendations using 7 core macro asset classes in compact JSON and a 1-line Markdown summary.

---

⚡ Key Value for AI Agents

1. 95% LLM Context Token Saving: Instead of feeding hundreds of daily candles across 8 global assets into the LLM context, this tool returns pre-computed deterministic indicators in ~400 tokens.
2. Deterministic Calculations: No LLM floating point hallucinations. Yield spreads, 20-day changes, credit ratios, and moving averages are computed directly in Python.
3. Micro-SaaS Pay-Per-Event (PPE): Only $0.008 per call. No expensive $200/month financial API subscriptions required.

---

📊 Core Tracked Macro Assets

• 10Y Treasury Yield (^TNX): Long-term discount rate & rate momentum ($\Delta 20d$).
• 2Y Treasury Yield (2YY=F / ^IRX): Policy rate expectations & Yield Curve Spread ($10Y - 2Y$).
• US Dollar Index (DX-Y.NYB): Global dollar liquidity tightening vs easing.
• WTI Crude Oil (CL=F): Supply-side inflation pressures.
• Gold (GC=F): Geopolitical and fiat debasement hedge demand.
• Credit Spread Proxy (HYG / IEF): High Yield vs Treasury relative ratio (credit risk / default stress).
• VIX (^VIX): Market fear and expected volatility.

---

🧭 4-Quadrant Macro Regime Matrix

Regime	Growth	Inflation / Rates	Tactical Strategy
🟢 GOLDILOCKS	High	Contained / Low	🚀 Bullish Risk-On: Overweight Tech, AI/Semiconductors, High-Beta Growth.
🔴 STAGFLATION	Slowing	Surging	🛡️ Defensive Hedge: Energy, Commodities, Cash, Short Duration. Avoid high PE stocks.
🟡 REFLATION	Expanding	Rising	🏗️ Cyclical Value: Financials, Industrials, Materials, Energy.
🔵 DEFLATION_CONTRACTION	Contracting	Falling	⚓ Capital Preservation: Long Treasuries (TLT/IEF), Gold, Defensive Healthcare/Utilities.

---

🔌 Claude Desktop & Cursor MCP Configuration

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "macro-regime-scanner": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/mcp-server",
        "--actor",
        "YOUR_APIFY_USERNAME/macro-regime-liquidity-mcp"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_API_TOKEN"
      }
    }
  }
}

---

📦 Output Sample

{
  "timestamp_utc": "2026-10-31 08:43:00 UTC",
  "macro_regime": "REFLATION (리플레이션: 경기확장 + 원자재/금리 동반상승)",
  "risk_appetite_score": 68.5,
  "risk_sentiment": "NEUTRAL_SELECTIVE (중립·선별적 투자 국면)",
  "tactical_strategy": "🏗️ CYCLICAL_VALUE (경기민감 가치주): 에너지, 원자재, 금융주, 인프라 섹터 유리.",
  "indicators": {
    "yield_curve": {
      "treasury_10y_yield": 4.93,
      "treasury_2y_yield": 4.57,
      "spread_10y_2y": 0.36,
      "yield_spread_status": "FLAT_EXPANSION (평탄화·금리 전환기)"
    },
    "dollar_liquidity": {
      "dollar_index_dxy": 101.88,
      "dxy_20d_change_pct": -0.05,
      "dollar_status": "NEUTRAL_FLOW (달러 유동성 중립 안정)"
    },
    "volatility": {
      "vix": 19.42,
      "vix_status": "NORMAL_MARKET (정상 변동성 구간)"
    }
  },
  "summary_md": "**Macro Regime: REFLATION** (Risk Score: 68.5/100) | 10Y Yield: 4.93% | 10Y-2Y Spread: +0.36% | DXY: 101.88 | Oil: $104.12 | VIX: 19.42"
}