tradingview-mcp

A Model Context Protocol (MCP) server that lets AI assistants interact with TradingView — real-time quotes, historical OHLCV data, screener, alerts, watchlists, news, chart layouts, Pine scripts, and more. Connect it to Claude Desktop, Cursor, or any MCP-compatible client and interact with TradingView using natural language.

Disclaimer: This project uses TradingView's internal, undocumented web API. It is not affiliated with or endorsed by TradingView. API endpoints may change without notice. Use in accordance with TradingView's Terms of Service.

---

How It Works

TradingView's web app communicates with its backend over a private REST API and a proprietary WebSocket protocol. This server:

1. Authenticates using a headless Chromium browser (via Playwright) to replicate the normal login flow and obtain valid session cookies.
2. Persists those cookies to disk so re-authentication only happens when the session expires (~25 days).
3. Exposes MCP tools that make authenticated HTTP requests to TradingView's internal endpoints, plus a WebSocket connection for historical OHLCV data.

MCP Client (Claude, Cursor…)
        │  MCP protocol (stdio)
        ▼
  tradingview-mcp
        │  HTTPS + session cookies        WebSocket (OHLCV)
        ▼                                        ▼
  tradingview.com REST API       prodata.tradingview.com

---

Features

• Market Data — real-time quotes and detailed symbol info (P/E, EPS, beta, sector, 52-week range, etc.)
• Historical Data — OHLCV candles via TradingView's WebSocket protocol
• Screener — filter stocks, crypto, and forex by price, fundamentals, and technicals
• Alerts — list and inspect price alerts
• Watchlists — list, create, rename, add/remove symbols, and delete watchlists
• News & Ideas — latest headlines per symbol, community ideas search, trending ideas
• Chart Layouts — list and inspect saved chart layouts
• Pine Scripts — list and retrieve source code for saved indicators and strategies
• Account — account details
• Session persistence — logs in once via headless browser, reuses cookies for subsequent runs

---

Installation

Option A — Docker (recommended)

No Node.js required. Uses the published multi-platform image (linux/amd64 + linux/arm64).

1. Authenticate once

docker run --rm \
  -v tradingview-mcp-session:/data \
  -e TV_USERNAME=your@email.com \
  -e TV_PASSWORD=yourpassword \
  -e TV_SESSION_FILE=/data/.tv_session.json \
  mikeh1975/tradingview-mcp:login

This runs a headless Chromium browser, logs into TradingView, and saves the session cookies to a named Docker volume. You only need to redo this when the session expires (~25 days).

2. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tradingview": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "tradingview-mcp-session:/data",
        "-e", "TV_SESSION_FILE=/data/.tv_session.json",
        "mikeh1975/tradingview-mcp:latest"
      ]
    }
  }
}

Restart Claude Desktop. You should see "tradingview" in the MCP tools list.

---

Option B — Local (Node.js)

Requirements: Node.js 18+, a TradingView account.

git clone https://github.com/mikeh-22/tradingview-mcp.git
cd tradingview-mcp
npm install
npx playwright install chromium
npm run build

Configure Claude Desktop:

{
  "mcpServers": {
    "tradingview": {
      "command": "node",
      "args": ["/absolute/path/to/tradingview-mcp/dist/index.js"],
      "env": {
        "TV_USERNAME": "your_username_or_email",
        "TV_PASSWORD": "your_password"
      }
    }
  }
}

On the first run, a headless Chromium browser opens and logs in using your credentials. Session cookies are saved to .tv_session.json. All subsequent runs skip the browser entirely.

To force a fresh login, delete .tv_session.json or call the reset_session tool.

---

Available Tools

Market Data

get_quote

Returns real-time price data for one or more symbols.

Parameter	Type	Required	Description
symbols	string[]	✓	Symbols in EXCHANGE:TICKER format, e.g. ["NASDAQ:AAPL", "BINANCE:BTCUSDT"]

get_symbol_info

Returns detailed fundamental and technical data for a single symbol (P/E, EPS, 52-week high/low, beta, sector, dividends, etc.).

Parameter	Type	Required	Description
symbol	string	✓	Symbol in EXCHANGE:TICKER format

get_ohlcv

Returns historical OHLCV candlestick data via TradingView's WebSocket protocol.

Parameter	Type	Required	Description
symbol	string	✓	Symbol in EXCHANGE:TICKER format
resolution	string	✓	Timeframe: 1m 3m 5m 15m 30m 45m 1h 2h 3h 4h 1D 1W 1M
countback	number		Number of bars to fetch (default 300)
from	number		Start time as Unix timestamp (seconds)
to	number		End time as Unix timestamp (seconds)

---

Screener

screen_stocks

Screens US equities using price, volume, fundamental, and technical filters.

Parameter	Type	Required	Description
filters	Filter[]		Array of filter conditions (see below)
columns	string[]		Fields to return (uses sensible defaults if omitted)
sort	object		{ sortBy: string, sortOrder: "asc" | "desc" }
range	[number, number]		Pagination: [offset, limit], e.g. [0, 25]

screen_crypto

Screens crypto assets. Same parameters as screen_stocks.

screen_forex

Screens forex pairs. Same parameters as screen_stocks.

get_screener_fields

Returns a reference list of all available screener field names, grouped by category (price, volume, fundamentals, technicals, volatility, metadata).

(no parameters)

Filter object format:

{ "left": "market_cap_basic", "operation": "greater", "right": 1000000000 }

Supported operations: greater, less, greater_or_equal, less_or_equal, equal, not_equal, in_range, not_in_range, in, not_in, crosses_up, crosses_down

For in_range, right should be [min, max]. Example — RSI between 30 and 50:

{ "left": "RSI", "operation": "in_range", "right": [30, 50] }

---

Alerts

list_alerts

Returns all alerts on your account.

(no parameters)

get_alert

Returns full details for a single alert.

Parameter	Type	Required	Description
id	string	✓	Alert ID

---

Watchlists

list_watchlists

Returns all watchlists with their symbols.

(no parameters)

get_watchlist

Returns a single watchlist and its full symbol list.

Parameter	Type	Required	Description
id	string	✓	Watchlist ID

create_watchlist

Creates a new watchlist, optionally pre-populated with symbols.

Parameter	Type	Required	Description
name	string	✓	Watchlist name
symbols	string[]		Initial symbols, e.g. ["NASDAQ:AAPL", "NYSE:TSLA"]

rename_watchlist

Renames an existing watchlist.

Parameter	Type	Required	Description
id	string	✓	Watchlist ID
name	string	✓	New name

add_symbols

Adds one or more symbols to a watchlist.

Parameter	Type	Required	Description
id	string	✓	Watchlist ID
symbols	string[]	✓	Symbols to add

remove_symbols

Removes one or more symbols from a watchlist.

Parameter	Type	Required	Description
id	string	✓	Watchlist ID
symbols	string[]	✓	Symbols to remove

delete_watchlist

Permanently deletes a watchlist.

Parameter	Type	Required	Description
id	string	✓	Watchlist ID

---

News & Ideas

get_news

Returns the latest news headlines for a symbol.

Parameter	Type	Required	Description
symbol	string	✓	Symbol in EXCHANGE:TICKER format
count	number		Number of headlines to return (default 20)

search_ideas

Searches published TradingView chart ideas.

Parameter	Type	Required	Description
symbol	string		Filter ideas by symbol
query	string		Keyword filter
sort	string		recent (default) or trending
page	number		Page number (default 1)

get_trending_ideas

Returns trending TradingView chart ideas.

Parameter	Type	Required	Description
page	number		Page number (default 1)

---

Chart Layouts

list_layouts

Returns all saved chart layouts.

(no parameters)

get_layout

Returns details of a saved layout including its name, symbol, and resolution.

Parameter	Type	Required	Description
id	string	✓	Layout ID

---

Pine Scripts

list_scripts

Returns Pine Script indicators and strategies.

Parameter	Type	Required	Description
filter	string		saved (default) — your saved/favorited scripts; published — your published scripts; all — entire public library
limit	number		Max results (default 100)

get_script

Returns the Pine Script source code for a script by ID.

Parameter	Type	Required	Description
id	string	✓	Script ID (e.g. STD;RSI)
version	string		Script version (uses latest if omitted)

---

Account

get_account

Returns your TradingView account details.

(no parameters)

---

Session

reset_session

Clears the saved session. The next tool call will trigger a fresh Playwright login.

(no parameters)

---

Symbol Format

TradingView uses an EXCHANGE:TICKER format for all symbols:

Asset	Example
US stocks	NASDAQ:AAPL, NYSE:TSLA
Crypto	BINANCE:BTCUSDT, COINBASE:ETHUSD
Forex	FX:EURUSD, OANDA:GBPUSD
Futures	CME:ES1!, NYMEX:CL1!
Indices	SP:SPX, NASDAQ:NDX

---

Project Structure

src/
├── index.ts       # MCP server entrypoint — tool definitions and request handlers
├── auth.ts        # Playwright login flow — opens headless browser, extracts cookies
├── client.ts      # HTTP client — fetch wrapper with cookie jar, CSRF, and subdomain support
├── types.ts       # Shared TypeScript interfaces
├── alerts.ts      # Alert read operations
├── watchlists.ts  # Watchlist CRUD
├── market.ts      # Quotes and symbol info
├── ohlcv.ts       # Historical OHLCV via TradingView WebSocket protocol
├── screener.ts    # Stock/crypto/forex screener
├── news.ts        # News headlines and community ideas
├── layouts.ts     # Chart layout read operations
├── scripts.ts     # Pine Script source retrieval
└── account.ts     # Account info

---

Troubleshooting

Login fails / Playwright times out

TradingView's login page may show a CAPTCHA or 2FA prompt. Try setting headless: false in src/auth.ts to watch the browser and identify what's blocking the flow.

API requests return 403 or 401

Your session has likely expired. Delete .tv_session.json (or call reset_session) to trigger a fresh login. With Docker, re-run the login container.

API requests return 404 or unexpected shapes

TradingView's internal API is undocumented and may change without notice. Open your browser's DevTools → Network tab, perform the action manually on tradingview.com, and compare the request URL and payload against the relevant file in src/.

get_ohlcv times out

The WebSocket connection to prodata.tradingview.com may be blocked by a firewall, or the symbol format may be incorrect. The timeout is 30 seconds.

TV_USERNAME / TV_PASSWORD not found

When running via Claude Desktop, set credentials in the env block of your MCP config rather than relying on a .env file — the server process won't automatically source it.

---

CI/CD

Workflow	Trigger	Action
docker.yml	Push to main, version tags (v*.*.*), PRs to main	Builds and pushes multi-platform Docker images (linux/amd64 + linux/arm64) to Docker Hub

Images published to Docker Hub:

• mikeh1975/tradingview-mcp:latest — MCP server (runtime image, no browser)
• mikeh1975/tradingview-mcp:login — Login helper (includes Playwright + Chromium)

---

License

MIT