Tradingview-Premium-Claude-MCP-Setup

Analysis-only intraday trading dashboard for TradingView Premium Desktop, driven through Claude Code + MCP over the Chrome DevTools Protocol (CDP).

• Intraday-only. 🇮🇳 India + 🇺🇸 USA TPO scanners (Market-Profile-informed, full-universe) and a 🇮🇳 India-intraday dashboard panel.
• One dashboard: Signal Summary with intraday decision metrics (bias, strength, trend, volume, risk, entry readiness…), the India-intraday fast-scan + checklist, and MCP/CDP health.
• Stable entries: every TPO signal anchors its entry to a fixed session level (today's Open / prior-day close) and freezes the whole plan per symbol per day — the entry does not drift with each LTP tick. A signal State (ARMED / VALID / EXTENDED / INVALID / EXPIRED) says when to act.
• Circuit-aware (India): targets never exceed the NSE upper circuit and stops never sit below the lower circuit — Stage-1 uses an assumed band, and Confirm fetches the real per-stock circuit from the NSE data provider.
• No live trade execution. No order endpoints exist in this codebase.

Zero npm dependencies (Node built-ins only). Reuses the verified CDP bridge from the previous setup (lib/tv.mjs).

New here? Start with the Start Here tab

The dashboard opens on a Start Here tab that, in plain English, explains what every tab does (grouped into live signals, analysis, idea scans and journal/stats), shows your live setup status (what is actually configured on your machine), lists a 5-minute path, and defines the jargon. If you read nothing else here, read that tab.

What works without any API keys?

Most of the dashboard runs with no keys at all — the two optional tokens only unlock the tabs that need historical price data or the real NSE circuit.

| Feature | Needs | |---|---| | India / USA TPO Scanners — intraday setups with fixed entry/SL/target | No keys (TradingView's public scanner) | | Testing journal + pass/fail gates | No keys (the India 1-minute backtest needs an NSE data token) | | Analytics — Monte Carlo & robustness | No keys (the HMM market-regime model needs an NSE data token) | | Cached Data — what's stored, will-this-fetch cost | No keys | | Dashboard — live Signal Summary read | TradingView running (CDP on :9222) | | Pattern / VCP / Elliott / Breakout — NSE symbols | NSE data token | | Pattern / VCP / Elliott / Breakout — US symbols | US market-data keys | | Confirm on India TPO (real NSE circuit) | NSE data token (falls back to an assumed band without one) |

First 5 minutes

1. npm run tv:debug — relaunch TradingView so the dashboard can read it.
2. npm start, open http://localhost:4178, and keep a TradingView chart tab active.
3. On Start Here, check Your setup status — green means ready (the NSE and US data feeds are optional).
4. Open Dashboard, type a symbol (e.g. RELIANCE or AAPL) and press Load for a live read.
5. Try the India TPO Scanner — auto-found intraday setups, no API keys needed.

Requirements

• macOS, Node ≥ 20 (uses the built-in WebSocket; verified on Node 22)
• TradingView Desktop installed (/Applications/TradingView.app), logged in
• Optional: Claude Code, for the MCP bridge (chrome-devtools-mcp, wired in .mcp.json)

Setup

git clone git@github.com:saket3395/Tradingview-Premium-Claude-MCP-Setup.git
cd Tradingview-Premium-Claude-MCP-Setup
cp .env.example .env            # optional; defaults work

No npm install needed (no dependencies).

Run

Easiest: double-click scripts/start.command in Finder — it ensures CDP, starts the dashboard, and opens it in your browser. Close that Terminal window to stop the server.

Or from a terminal:

npm run tv:debug                # quits + relaunches TradingView with CDP on :9222
npm start                       # dashboard at http://localhost:4178

Open http://localhost:4178. Keep a TradingView chart tab active (ideally on a second monitor) — the dashboard reads whichever chart tab is currently active.

Why tv:debug? TradingView only exposes CDP when launched with --remote-debugging-port. The script quits any running instance and relaunches with the flag (layouts are cloud-synced, so nothing is lost) and waits out the auto-updater.

Dashboard sections

| Tab / Panel | What it does | Source | |---|---|---| | MCP / CDP health | CDP up/down, app version, chart-tab count | GET /api/status | | Signal Summary | Active symbol/timeframe/close, RSI/EMA/SMA/BoP/VWAP plus intraday decision metrics (market bias, long/short, strength, confidence, trend, volume confirm, risk, best setup, trade quality, entry readiness, avoid-trade reason) + a How to Use guide | parsed chart legend | | India — Intraday | Timeframes, fast scan of NSE/BSE watchlist, intraday trade checklist | watchlist + config/markets.json | | India TPO Scanner | Full-NSE-universe profile-informed scan with fixed entries, State, SL, circuit-capped targets, R:R, on-chart Confirm (+ real NSE circuit) and a How to Trade This Signal guide | GET /api/tpo/scan, POST /api/tpo/confirm | | USA TPO Scanner | Same engine for NASDAQ/NYSE/AMEX (no circuit clamp) | GET /api/tpo/scan/usa | | Pattern Analysis | Symbol autocomplete (TradingView symbol search, filtered to NSE/NASDAQ/NYSE/AMEX — the exchanges history is actually available for) driving a top-down multi-timeframe (Monthly → Weekly → Daily → 4H) structural report for one symbol: Weinstein stage per timeframe, rule-based detection of rectangle / triangles / wedges / channels / flags / pennant / cup & handle / VCP / double top-bottom / H&S + inverse / breakout / breakdown / retest / trend continuation-reversal, each with Status · Confidence % · Technical Score /10 (score adjusted for higher-timeframe alignment), plus multi-timeframe support/resistance confluence and a rule-based conclusion. Real OHLC only — the NSE data provider for NSE (4H aggregated from 30m), the US data provider for US; a timeframe with no data is reported missing, never guessed | GET /api/symbols?q=…, GET /api/patterns?symbol=… | | VCP Analysis | Mark Minervini SEPA screen for one symbol: the Trend Template (8 criteria, ≥7/8 to proceed), a true percentile RS Rating (universe ranked via the existing TradingView scanner — NSE vs NSE, US vs US, behind a market-cap + turnover floor), volatility-contraction base detection (2–6 contractions, ≥5 weeks, ≤35% deep, volume dry-up), and the resulting trade plan (pivot, low-cheat entry, stop at the tighter of the final contraction low or −7%, 2R/3R targets, position sizing). Verdict is BUY-READY / SETUP FORMING / EXTENDED / WATCH / FAIL. Technical half of SEPA only — no earnings or sponsorship data | GET /api/vcp?symbol=… | | Elliott Wave | Impulse + simple correction counting across all four degrees (Monthly=Primary → 4H=Minute). The three hard rules are absolute — a count breaking any is discarded, not downgraded; Fibonacci proportion, alternation, channelling and volume/momentum personality are guidelines that score it. Always returns alternate counts (generated by re-running swing detection at four ATR thresholds) and an explicit invalidation price. Confidence is capped at 75% because a wave count is an interpretation, not a measurement. Scope: zigzag/flat/contracting triangle — diagonals, truncations and WXY combinations are deliberately not counted | GET /api/elliott?symbol=… | | Breakout-Patterns | Ranks the stocks closest to clearing a chart-pattern pivot. Filters: timeframe (4H/1D/1W/1M), region (India/USA), chart pattern type. Stage 1 screens the whole universe server-side (uptrend: above the 50- and 200-day MA, 6-month performance positive, within 15% of the 52-week high); Stage 2 runs the same detectors as Pattern Analysis on real OHLC for a bounded shortlist (breakouts.candidates, default 10) and lists only pivots within 5% above price. Long-only by definition — a breakout is the level above price | GET /api/breakouts?region=…&tf=…&pattern=… | | VCP/Elliott-Breakout | Same two-stage pipeline, with the pivot measured by a methodology engine. Type = VCP runs the full Minervini screen and lists the final contraction's high with its stop and 2R/3R targets (daily by construction — the timeframe filter does not apply); Type = Elliott Wave counts at the chosen timeframe's degree and lists only a live up-impulse in wave 3 or 5, where the level to clear is the prior same-direction wave's extreme, with its invalidation price | GET /api/breakouts?type=vcp\|elliott&region=…&tf=… | | Cached Data | Shows what OHLC history is held locally and — the question the rate limit makes worth asking — whether analysing a given symbol costs upstream requests. Type a symbol, press Will this fetch?: answered entirely from local state, never contacting a provider. Also surfaces each provider's live pacing and circuit-breaker state, so you can confirm what the server is actually using | GET /api/cache, GET /api/cache/cost?symbol=… | | Testing | Forward-test journal of every frozen plan (a plan only counts toward PF/win-rate once it actually reached VALID — never-filled plans are "missed"), pass/fail gates (PF ≥1.5 · WR ≥40% · R:R ≥1:2, n≥20), breakdowns by market/setup/confidence, and an on-demand India 1-minute backtest replaying journaled plans against the NSE data provider's real 1-minute candles | GET /api/test/summary, POST /api/test/backtest, data/journal.json | | Analytics | Monte Carlo bootstrap of realized R-multiples (equity bands, max-DD, risk-of-ruin), Gaussian HMM market regime on real NIFTY daily returns (+ per-regime strategy PF/WR), and robustness (expectancy ±SE, SQN, threshold sensitivity, rolling PF) — all from real journal outcomes, never simulated prices | GET /api/analytics |

Pre-expansion scanner logic (v2)

Each signal now carries a Setup archetype — OPEN-DRIVE (early one-sided auction, gap-aligned), IB-COIL (range still compressed vs ATR but price holding the directional third on volume — the pre-breakout state), VALUE-EDGE (opened beyond prior close, pullback being accepted — 80%-rule style), or EXPANSION (move already happened; kept but score-penalized) — plus an EQ (Entry Quality, 0–100) column combining an anti-chase penalty (day range vs ATR), time-of-day decay (post-IB structure fades), and volume. Extension no longer earns entry points: an extended day proves direction, not entry. The Signal Summary adds Conviction, Location vs value (VWAP), Session phase and a one-line verdict.

• Fast scan: your TradingView watchlist split by market (exchange prefix). Click a symbol to load it on the active chart (best-effort switch).
• Checklists: defined in config/markets.json; tick-state saved in the browser.
• Signal State: VALID = in the entry zone now · ARMED = waiting for the level · EXTENDED = ran past entry, don't chase · INVALID = stop reached · EXPIRED = closed / late-session cutoff (tpo.noNewEntryBeforeCloseMin).

CLI (same bridge, no server)

npm run tv -- status            # CDP health
npm run tv -- chart             # active symbol + interval
npm run tv -- indicators        # raw indicator legend rows
npm run tv -- pine:read
npm run tv -- pine:write pine/example-ema.pine
npm run tv -- pine:compile

Configuration

• config/markets.json — India-intraday labels/exchanges/timeframes/checklist; tpo block: refreshSeconds, noNewEntryBeforeCloseMin, testing.backtestLimit (how many recent plans the 1-minute backtest replays — each costs one NSE-provider request), and per-market thresholds (minScore/minRR/minRVol/…). tpo.india.circuitBandPct is the assumed Stage-1