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:

Authenticates using a headless Chromium browser (via Playwright) to replicate the normal login flow and obtain valid session cookies.
Persists those cookies to disk so re-authentication only happens when the session expires (~25 days).
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	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	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

Name		Name	Last commit message	Last commit date
.docker		.docker
.github/workflows		.github/workflows
src		src
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
Dockerfile.login		Dockerfile.login
README.md		README.md
docker-compose.yml		docker-compose.yml
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation

tradingview-mcp

How It Works

Features

Installation

Option A — Docker (recommended)

Option B — Local (Node.js)

Available Tools

Market Data

get_quote

get_symbol_info

get_ohlcv

Screener

screen_stocks

screen_crypto

screen_forex

get_screener_fields

Alerts

list_alerts

get_alert

Watchlists

list_watchlists

get_watchlist

create_watchlist

rename_watchlist

add_symbols

remove_symbols

delete_watchlist

News & Ideas

get_news

search_ideas

get_trending_ideas

Chart Layouts

list_layouts

get_layout