explaingit

pueschel88/tradingview-mcp

Analysis updated 2026-05-18

133TypeScriptAudience · developerComplexity · 3/5

TLDR

A local MCP server that lets Claude Code or another AI assistant read and control your running TradingView Desktop chart.

Mindmap

mindmap
  root((Tradingview MCP))
    What it does
      Reads chart state
      Changes symbol timeframe
      Fetches OHLCV bars
      Local only
    How it connects
      Chrome DevTools Protocol
      TradingView Desktop app
      MCP stdio to Claude Code
    Tech stack
      TypeScript
      Zod schemas
      Optional Redis cache
    Use cases
      AI reads live chart
      Switch symbol via chat
      Pull recent price bars
    Requirements
      TradingView subscription
      Desktop app running

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI assistant read the current symbol, timeframe, and price from your open TradingView chart.

USE CASE 2

Ask an AI assistant to switch the chart's symbol or timeframe during a conversation.

USE CASE 3

Pull recent OHLCV price bars from the active chart for an AI to analyze.

What is it built with?

TypeScriptZodChrome DevTools ProtocolRedisNode.js

How does it compare?

pueschel88/tradingview-mcpstormeye85/robinhood-token-sniperboob025/peace-equalizer-apo
Stars133133134
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasy
Complexity3/53/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

The README does not state a license, so usage rights are unclear.

In plain English

Tradingview MCP is a small server that lets Claude Code, or any other MCP-compatible AI assistant, control a TradingView Desktop application that is already running on your computer. MCP stands for Model Context Protocol, a standard way for AI tools to call external tools. Instead of scraping TradingView's website or getting around any paywall, this project connects to the desktop app you already log into and pay for, using the Chrome DevTools Protocol, the same debugging interface built into Electron apps like Slack, VS Code, and Discord. Once connected, an AI assistant can read the current chart, including the symbol, timeframe, visible indicators, and last price, and it can change the symbol or timeframe on your behalf. It can also fetch up to 5,000 recent OHLCV bars, meaning open, high, low, close, and volume price data, directly from the active chart. All of this happens locally: no chart data is sent anywhere else or stored by the tool itself. The project deliberately keeps its feature set small, with a handful of well defined, typed tools rather than a large kitchen sink set of features. It includes a doctor command that checks whether the connection to TradingView Desktop is working and reports what is wrong if it is not. Setup involves quitting TradingView Desktop, relaunching it with a debug port flag enabled, and then adding the tool to your Claude Code configuration. An optional local Redis cache can be used to reduce repeated calls to the chart, and the tool still works without Redis running, just without that caching benefit. The code is written in TypeScript with strict type checking, split into separate layers for the connection, the chart tools, and the server itself, and it ships with tests. This is aimed at developers who already use TradingView Desktop and want an AI assistant to read chart state or pull price data as part of a workflow, such as asking an assistant to switch symbols or summarize recent price movement. It is not affiliated with TradingView Inc. and requires an existing TradingView subscription and a locally running desktop app to work.

Copy-paste prompts

Prompt 1
Set up tradingview-mcp to connect Claude Code to my running TradingView Desktop app.
Prompt 2
Use tradingview-mcp to check what symbol and timeframe my TradingView chart is currently showing.
Prompt 3
Switch my TradingView chart to BTCUSDT on the 4 hour timeframe and pull the last 200 bars.
Prompt 4
Run tradingview-mcp doctor and help me fix whatever it reports as broken.
Prompt 5
Explain what the optional Redis cache in tradingview-mcp does and whether I need it.

Frequently asked questions

What is tradingview-mcp?

A local MCP server that lets Claude Code or another AI assistant read and control your running TradingView Desktop chart.

What language is tradingview-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Zod, Chrome DevTools Protocol.

What license does tradingview-mcp use?

The README does not state a license, so usage rights are unclear.

Who is tradingview-mcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.