Repolode
Submit
tradesdontlie

tradesdontlie/tradingview-mcp

An MCP server that lets Claude Code read and control your locally running TradingView Desktop charts via Chrome DevTools Protocol.

Open-source alternative to:TradingView

View on GitHub
Stars
6,871
Forks
2,835
Open issues
267
Last commit
3 months ago

What is it?

TradingView MCP Bridge connects Claude Code to a TradingView Desktop app that is already running on your machine. It communicates over Chrome DevTools Protocol on localhost, so it does not contact TradingView's servers. The tool exposes chart reading, Pine Script editing and compilation, chart navigation, drawing, alerts, replay practice, and screenshots as MCP tools, and mirrors each one as a `tv` CLI command that outputs JSON.

The debug port is off by default and must be enabled with the Chromium flag `--remote-debugging-port=9222`. Launch scripts for macOS, Windows, and Linux are included. The project requires a valid TradingView subscription and depends on TradingView's undocumented internal Electron interfaces, which may change with updates.

The project is positioned as a research interface for studying how LLM agents handle live financial UI state, not as a trading bot. Trade execution is not supported, and the README asks users to review TradingView's terms before use.

Key features

  • 01Reads indicator values, price levels, labels, tables, and OHLCV bars from the open chart.
  • 02Writes, compiles, and reads errors for Pine Script directly in the TradingView editor.
  • 03Changes symbols, timeframes, chart types, indicators, layouts, and multi-pane grids.
  • 04Draws trend lines, horizontal lines, rectangles, and text; manages price alerts.
  • 05Steps through historical bars in replay mode and captures chart screenshots.
  • 06Exposes every MCP tool as a JSON-output `tv` CLI command.

Use cases

  • Asking Claude to summarize indicator values and key levels on an open chart.
  • Developing and debugging Pine Script indicators with an AI assistant.
  • Practicing entries and exits in TradingView's replay mode with scripted steps.
  • Studying how LLM agents interpret live, stateful financial interfaces.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/tradesdontlie/tradingview-mcp.git
  2. 2

    Enter the folder and install dependencies

    cd tradingview-mcp && npm install
  3. 3

    Launch TradingView with debug port (Mac)

    ./scripts/launch_tv_debug_mac.sh
  4. 4

    Add the server to your Claude Code MCP config, then ask Claude to run tv_health_check

Things to know

  • Requires a valid paid TradingView subscription and the TradingView Desktop app installed.
  • Relies on undocumented internal TradingView APIs that may break after any TradingView update.
  • The license is listed as NOASSERTION, so its terms are unclear from the metadata.
  • The debug port must be enabled manually each time TradingView is launched.

Topics

#trading#mcp#claude#pine-script#chrome-devtools-protocol#electron#cli#automation

FAQ

What is tradingview-mcp?
An MCP server that lets Claude Code read and control your locally running TradingView Desktop charts via Chrome DevTools Protocol. TradingView MCP Bridge connects Claude Code to a TradingView Desktop app that is already running on your machine. It communicates over Chrome DevTools Protocol on localhost, so it does not contact TradingView's servers. The tool exposes chart reading, Pine Script editing and compilation, chart navigation, drawing, alerts, replay practice, and screenshots as MCP tools, and mirrors each one as a `tv` CLI command that outputs JSON.
Is tradingview-mcp free to use? What license does it have?
tradingview-mcp is open source under the Other license. Check the license terms before using it in commercial products.
Is tradingview-mcp still maintained?
Updated within 6 months. The last commit to tradingview-mcp was on Jul 28, 2026.
What can I use tradingview-mcp for?
Asking Claude to summarize indicator values and key levels on an open chart. Developing and debugging Pine Script indicators with an AI assistant. Practicing entries and exits in TradingView's replay mode with scripted steps. Studying how LLM agents interpret live, stateful financial interfaces.
How do I install tradingview-mcp?
Clone the repository: git clone https://github.com/tradesdontlie/tradingview-mcp.git Enter the folder and install dependencies: cd tradingview-mcp && npm install Launch TradingView with debug port (Mac): ./scripts/launch_tv_debug_mac.sh Add the server to your Claude Code MCP config, then ask Claude to run tv_health_check
Where can I get tradingview-mcp?
The source code and installation instructions are on GitHub: https://github.com/tradesdontlie/tradingview-mcp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects