# Tradingview Premium Claude MCP Setup

> TradingView Premium × Claude MCP setup — drive your own TradingView Desktop session via Chrome DevTools Protocol for chart analysis, signals, and backtesting from Claude Code. Analysis only, no order execution.

- **Type:** MCP server
- **Install:** `agentstack add mcp-saket3395-tradingview-premium-claude-mcp-setup`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [saket3395](https://agentstack.voostack.com/s/saket3395)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [saket3395](https://github.com/saket3395)
- **Source:** https://github.com/saket3395/Tradingview-Premium-Claude-MCP-Setup

## Install

```sh
agentstack add mcp-saket3395-tradingview-premium-claude-mcp-setup
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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
```bash
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:**
```bash
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)
```bash
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 circuit
  band (default 10%); Confirm replaces it with the real NSE circuit.
- `.env` — `PORT`, `TV_CDP`, `TV_NO_ACTIVATE`, and the NSE data token file (path to a JSON
  `{"access_token":"…"}`; used only for the real NSE circuit at Confirm). **Recommended:** a
  read-only, long-lived **analytics token** — **~1-year validity**, supports the market-quote
  endpoint, and needs **no daily refresh**. A normal daily OAuth access token also works but expires
  each day. Absent/expired ⇒ Confirm falls back to the assumed band and says so. The US market-data
  keys (key id / secret / feed, default `iex`) are **market-data only** credentials used solely by
  the Pattern Analysis tab to fetch real 4H/1D/1W/1M bars for US symbols — no trading endpoint is
  ever called. Absent ⇒ US symbols report "no history source" instead of showing invented data.
  See `.env.example` for the exact variable names and provider-specific setup.

## Use with Claude Code (MCP)
`.mcp.json` wires Google's `chrome-devtools-mcp` to the same CDP endpoint, so Claude can read
the chart / run JS / read console live. For Pine writes, use the CLI
`npm run tv -- pine:*` (robust Monaco handling; the dashboard is intraday-only now). Open the chart page with
`select_page { pageId, bringToFront: true }` before `evaluate_script` (TradingView suspends
hidden tabs' DOM).

## Limits / honest notes
- **Reads need the chart tab active** in TradingView (hidden tabs are suspended). Best with TV
  on a second monitor while you watch the dashboard.
- **Chart symbol switch** is best-effort (drives the symbol-search dialog); if it misfires,
  switch in TradingView directly. **Timeframe chips are reference labels** (no auto-switch yet).
- **Indicator parsing is heuristic** from the on-chart legend; it reads what you already have on
  the chart (add EMA9/21, RSI, VWAP, a volume study for full Signal-Summary metrics — missing ones
  show `n/a`), it does not compute new studies.
- **TPO Stage-1 is profile-*informed*** from day-level scanner data (full letter-by-letter TPO
  needs intraday time-at-price). The scanner's "VWAP" field is the pivot `(H+L+C)/3`, used for
  scoring only — never for entry. Use **Confirm** for true on-chart levels.
- **Real NSE circuit** needs a valid NSE data token (a long-lived analytics token lasts ~1 year — no
  daily refresh); without one, Stage-1's assumed band applies and Confirm labels it honestly. NSE's
  own API is Akamai/bot-blocked server-side, hence a third-party data provider.

## Project layout
```
lib/tv.mjs          reused CDP bridge (importable module + CLI; Pine fns kept for the CLI)
lib/signals.mjs     pure legend -> signals + intraday decision metrics
lib/tpo.mjs         TPO scanner engine (India+USA): scoring, fixed entries, freeze, state, circuit
lib/upstox.mjs      real NSE circuit at Confirm (instrument map + market-quote)
lib/history.mjs     multi-timeframe OHLC for Pattern Analysis (NSE / US data feeds)
lib/patterns.mjs    rule-based stage + pattern detection and the top-down report builder
lib/indicators.mjs  shared primitives (SMA/ATR/pivots/line fit/ZigZag/RSI) used by every engine
lib/minervini.mjs   Minervini SEPA: Trend Template, VCP contractions, pivot/stop trade plan
lib/rs.mjs          percentile RS Rating from the reused TradingView universe scanner
lib/ratelimit.mjs   ONE process-wide throttle + circuit breaker per upstream provider
data/history_cache.json  persisted OHLC windows (gitignored) — survives restarts so a
                    symbol analysed yesterday needs no requests the next morning
lib/elliott.mjs     Elliott Wave counting: impulse + simple corrections, alternates, invalidation
lib/breakouts.mjs   "closest to breakout" scanners: full-universe screen, then the real
                    pattern / VCP / Elliott engines on a rate-limit-bounded shortlist
server/server.mjs   zero-dep HTTP server + JSON API
public/             index.html, app.js, style.css  (the dashboard)
config/markets.json India-intraday config + tpo

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [saket3395](https://github.com/saket3395)
- **Source:** [saket3395/Tradingview-Premium-Claude-MCP-Setup](https://github.com/saket3395/Tradingview-Premium-Claude-MCP-Setup)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-saket3395-tradingview-premium-claude-mcp-setup
- Seller: https://agentstack.voostack.com/s/saket3395
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.