# tradesdontlie/tradingview-mcp architecture

> Architecture diagram of the GitHub repository tradesdontlie/tradingview-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tradesdontlie/tradingview-mcp
- Repository: https://github.com/tradesdontlie/tradingview-mcp

## Overview

TradingView MCP Bridge exposes a local TradingView Desktop chart to AI assistants through MCP tools and a matching JSON-output CLI. The main workflow is a request routed through either interface to domain operations, which inspect or control the chart over CDP and return results. Distinct capabilities include chart navigation, data analysis, Pine development, drawings and alerts, replay, panes and tabs, and streaming. Sampled source supports the interface wiring and CDP boundary; some domain links are based on README descriptions because their implementations were not excerpted.

Main entry points: [`src/connection.js`](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/connection.js) (CDP connection), [`src/server.js`](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/server.js) (MCP server), [`src/cli/router.js`](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/cli/router.js) (Command router), [`src/core/data.js`](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/data.js) (Chart data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_mcp["MCP server<br/>[server.js]"]
  node_cli["CLI commands<br/>[index.js]"]
  node_router["Command router<br/>[router.js]"]
  node_tooldata["Data tools<br/>[data.js]"]
  node_toolpine["Pine tools<br/>[pine.js]"]
  node_toolchart["Chart tools<br/>[chart.js]"]
end

subgraph group_chart["Chart and data"]
  node_chartcore["Chart control<br/>[chart.js]"]
  node_datacore["Chart data<br/>[data.js]"]
  node_indicators["Indicators<br/>[indicators.js]"]
end

subgraph group_workflows["Chart workflows"]
  node_pine["Pine development<br/>[pine.js]"]
  node_drawings["Drawings and alerts<br/>[drawing.js]"]
  node_replay["Replay practice<br/>[replay.js]"]
  node_panes["Pane layouts<br/>[pane.js]"]
  node_tabs["Tab management<br/>[tab.js]"]
  node_watchlist["Watchlists<br/>[watchlist.js]"]
  node_stream["Chart streaming<br/>[stream.js]"]
  node_ui["UI automation<br/>[ui.js]"]
  node_capture["Screenshots<br/>[capture.js]"]
end

subgraph group_runtime["Local runtime"]
  node_health["Connection health<br/>[health.js]"]
  node_cdp["CDP connection<br/>[connection.js]"]
  node_wait["Chart readiness<br/>[wait.js]"]
end

node_assistant(("AI assistant"))
node_terminal(("CLI user"))
node_desktop["TradingView Desktop"]

node_assistant -->|"requests tools"| node_mcp
node_terminal -->|"runs commands"| node_cli
node_cli -->|"dispatches commands"| node_router
node_mcp -->|"registers tools"| node_tooldata
node_mcp -->|"registers tools"| node_toolpine
node_mcp -->|"registers tools"| node_toolchart
node_tooldata -->|"calls"| node_datacore
node_toolpine -->|"calls"| node_pine
node_toolchart -->|"calls"| node_chartcore
node_router -->|"dispatches chart commands"| node_chartcore
node_router -->|"dispatches data commands"| node_datacore
node_router -->|"dispatches Pine commands"| node_pine
node_chartcore -->|"evaluates chart state"| node_cdp
node_datacore -->|"reads chart data"| node_cdp
node_datacore -->|"waits for readiness"| node_wait
node_pine -->|"controls editor"| node_cdp
node_indicators -->|"accesses chart"| node_cdp
node_drawings -->|"controls drawings"| node_cdp
node_replay -->|"controls replay"| node_cdp
node_panes -->|"controls panes"| node_cdp
node_tabs -->|"controls tabs"| node_cdp
node_watchlist -->|"manages watchlist"| node_cdp
node_stream -->|"polls chart"| node_cdp
node_ui -->|"drives interface"| node_cdp
node_capture -->|"captures screen"| node_cdp
node_health -->|"checks connection"| node_cdp
node_cdp -->|"communicates via CDP"| node_desktop

click node_mcp "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/server.js"
click node_cli "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/cli/index.js"
click node_router "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/cli/router.js"
click node_tooldata "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/tools/data.js"
click node_toolpine "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/tools/pine.js"
click node_toolchart "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/tools/chart.js"
click node_chartcore "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/chart.js"
click node_datacore "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/data.js"
click node_indicators "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/indicators.js"
click node_pine "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/pine.js"
click node_drawings "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/drawing.js"
click node_replay "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/replay.js"
click node_panes "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/pane.js"
click node_tabs "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/tab.js"
click node_watchlist "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/watchlist.js"
click node_stream "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/stream.js"
click node_ui "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/ui.js"
click node_capture "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/capture.js"
click node_health "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/health.js"
click node_cdp "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/connection.js"
click node_wait "https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/wait.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp,node_cli,node_router,node_tooldata,node_toolpine,node_toolchart,node_terminal,node_desktop toneBlue
class node_chartcore,node_datacore,node_indicators toneAmber
class node_pine,node_drawings,node_replay,node_panes,node_tabs,node_watchlist,node_stream,node_ui,node_capture toneMint
class node_health,node_cdp,node_wait toneRose
class node_assistant toneIndigo
```

## Components

### User interfaces

- [MCP server](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/server.js): `src/server.js`
- [CLI commands](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/cli/index.js): `src/cli/index.js`
- [Command router](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/cli/router.js): `src/cli/router.js`
- [Data tools](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/tools/data.js): `src/tools/data.js`
- [Pine tools](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/tools/pine.js): `src/tools/pine.js`
- [Chart tools](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/tools/chart.js): `src/tools/chart.js`

### Chart and data

- [Chart control](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/chart.js): `src/core/chart.js`
- [Chart data](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/data.js): `src/core/data.js`
- [Indicators](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/indicators.js): `src/core/indicators.js`

### Chart workflows

- [Pine development](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/pine.js): `src/core/pine.js`
- [Drawings and alerts](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/drawing.js): `src/core/drawing.js`
- [Replay practice](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/replay.js): `src/core/replay.js`
- [Pane layouts](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/pane.js): `src/core/pane.js`
- [Tab management](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/tab.js): `src/core/tab.js`
- [Watchlists](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/watchlist.js): `src/core/watchlist.js`
- [Chart streaming](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/stream.js): `src/core/stream.js`
- [UI automation](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/ui.js): `src/core/ui.js`
- [Screenshots](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/capture.js): `src/core/capture.js`

### Local runtime

- [Connection health](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/core/health.js): `src/core/health.js`
- [CDP connection](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/connection.js): `src/connection.js`
- [Chart readiness](https://github.com/tradesdontlie/tradingview-mcp/blob/main/src/wait.js): `src/wait.js`

### Other components

- **AI assistant**
- **CLI user**
- **TradingView Desktop**

## Connections

- AI assistant → MCP server: requests tools (evidence: `README.md`)
- CLI user → CLI commands: runs commands (evidence: `README.md`)
- CLI commands → Command router: dispatches commands (evidence: `src/cli/index.js`)
- MCP server → Data tools: registers tools (evidence: `src/server.js`)
- MCP server → Pine tools: registers tools (evidence: `src/server.js`)
- MCP server → Chart tools: registers tools (evidence: `src/server.js`)
- Data tools → Chart data: calls (evidence: `src/tools/data.js`)
- Pine tools → Pine development: calls (evidence: `src/tools/pine.js`)
- Chart tools → Chart control: calls (evidence: `src/tools/chart.js`)
- Command router → Chart control: dispatches chart commands (evidence: `src/cli/commands/chart.js`)
- Command router → Chart data: dispatches data commands (evidence: `src/cli/commands/data.js`)
- Command router → Pine development: dispatches Pine commands (evidence: `src/cli/commands/pine.js`)
- Chart control → CDP connection: evaluates chart state (evidence: `src/core/chart.js`)
- Chart data → CDP connection: reads chart data (evidence: `src/core/data.js`)
- Chart data → Chart readiness: waits for readiness (evidence: `src/core/data.js`)
- Pine development → CDP connection: controls editor (evidence: `src/core/pine.js`)
- Indicators → CDP connection: accesses chart (evidence: `src/core/indicators.js`)
- Drawings and alerts → CDP connection: controls drawings (evidence: `README.md`)
- Replay practice → CDP connection: controls replay (evidence: `README.md`)
- Pane layouts → CDP connection: controls panes (evidence: `README.md`)
- Tab management → CDP connection: controls tabs (evidence: `README.md`)
- Watchlists → CDP connection: manages watchlist (evidence: `README.md`)
- Chart streaming → CDP connection: polls chart (evidence: `README.md`)
- UI automation → CDP connection: drives interface (evidence: `src/core/ui.js`)
- Screenshots → CDP connection: captures screen (evidence: `README.md`)
- Connection health → CDP connection: checks connection (evidence: `src/core/health.js`)
- CDP connection → TradingView Desktop: communicates via CDP (evidence: `README.md`)
