Skip to content

Complete File Map

Every source file across all three repositories in the TradingDesk platform.


tradingview-mcp (67 files)

The MCP interface layer providing 78 tools for TradingView Desktop automation via CDP.

Root

File Purpose
package.json Dependencies and scripts
README.md Project overview and setup
CLAUDE.md Claude Code instructions
RESEARCH.md Research notes on TradingView internals
SECURITY.md Security considerations for CDP access
SETUP_GUIDE.md Step-by-step installation guide
CONTRIBUTING.md Contribution guidelines

src/ -- Core Source

File Purpose
server.js MCP server entry point, tool registration
connection.js CDP connection manager (connect, evaluate, disconnect)
wait.js Utility for waiting on chart readiness

src/core/ -- 17 Core Modules

File Purpose
index.js Core module aggregator
chart.js Chart navigation, symbol changes, timeframe
data.js OHLCV data export
pine.js Pine Script graphics reading (lines, labels, boxes, tables)
health.js Connection health checks
capture.js Screenshot capture
replay.js Bar replay mode for backtesting
alerts.js Alert management
drawing.js Drawing tools (trendlines, rectangles, etc.)
batch.js Batch operations across multiple tools
watchlist.js Watchlist management
indicators.js Indicator add/remove/configure
ui.js UI state management
pane.js Chart pane management
tab.js Tab management
stream.js Real-time data streaming

src/tools/ -- 15 Tool Definition Files

File Purpose
_format.js Shared formatting utilities for tool responses
health.js Health check tools
chart.js Chart navigation tools
data.js Data export tools
pine.js Pine graphics tools
capture.js Screenshot tools
replay.js Replay tools
alerts.js Alert tools
drawing.js Drawing tools
batch.js Batch operation tools
watchlist.js Watchlist tools
indicators.js Indicator tools
ui.js UI tools
pane.js Pane tools
tab.js Tab tools

src/cli/ -- CLI Interface

File Purpose
index.js CLI entry point
router.js Command routing and dispatch
+ 13 command files One per CLI command group

tests/ -- 5 Test Files

File Purpose
e2e.test.js End-to-end tests (70+ tests, requires CDP)
cli.test.js CLI parsing tests (no connection needed)
pine_analyze.test.js Pine Script analysis tests
replay.test.js Replay functionality tests
sanitization.test.js Input sanitization tests

scripts/ -- 5 Utility Scripts

File Purpose
pine_pull.js Pull Pine Script source from TradingView
pine_push.js Push Pine Script source to TradingView
launch_tv_debug.bat Launch TradingView with CDP (Windows batch)
launch_tv_debug.vbs Launch TradingView with CDP (Windows silent)
launch_tv_debug.sh Launch TradingView with CDP (Linux/macOS)

skills/ -- 5 Skill Definitions

Skill files for Claude Code integration, defining specialized capabilities.

agents/ -- 1 Agent Definition

Agent configuration for Claude Code autonomous workflows.


tradingview-strategy (38 source files)

The ICT strategy interpretation layer that reads indicators via MCP and produces StrategyFlags.

Root

File Purpose
package.json Dependencies and scripts
CLAUDE.md Claude Code instructions and architecture notes
docker-compose.yml Docker services (docs, nginx, certbot)
.gitignore Git ignore rules

src/ -- Pipeline Entry Points

File Purpose
index.js Package entry point, exports
scan.js Full pipeline orchestrator (read -> interpret -> build flags)
poll.js Interval-based scanning with delta detection

src/readers/ -- 7 MCP Data Readers

File Purpose
index.js Reader aggregator and exports
chart-state.js Read chart metadata (symbol, timeframe)
price.js Read current price data
bias.js Read HTF Bias AI Pine graphics
session.js Read Session Bias Pine graphics
orderblocks.js Read OB AI Pine graphics
smt.js Read SMT AI Pine graphics

src/interpreters/ -- 6 Signal Interpreters

File Purpose
index.js Interpreter aggregator
bias.js Parse bias labels/lines into direction + DOL
session.js Parse session labels/lines into hunt side + sweep status
orderblock.js Parse OB lines/boxes into bullish/bearish arrays + ATR
smt.js Parse SMT labels/lines into divergence signals
price.js Parse price data into current price info

src/engine/ -- 5 Decision Engine Modules

File Purpose
index.js Engine aggregator
flag-builder.js Assemble final StrategyFlags JSON
confluence.js Score confluence factors (max 9, 6 factors with weights)
no-trade-filter.js Evaluate no-trade conditions (8 possible reasons)
setup-detector.js Detect and name specific trade setups

src/contracts/ -- 6 Shared Contract Modules

File Purpose
index.js Contract re-exports
colors.js Color normalization and constant maps
indicator-names.js Canonical study filter strings
session-times.js Session windows, entry windows, EOD cutoff
macro-windows.js ICT macro time windows
signal-schema.js StrategyFlags schema and validation

dashboard/ -- 5 Dashboard Files

File Purpose
server.js Express server for live test dashboard
index.html Main dashboard page
settings.html Settings/configuration page
focus.ps1 PowerShell script for window focus
windows.ps1 PowerShell script for window management

scripts/ -- 4 Utility Scripts

File Purpose
audit.py Python script for auditing all 4 indicators
issue-cert.sh Issue Let's Encrypt SSL certificate
renew-cert.sh Renew SSL certificate (cron-friendly)
read-bias-cells.js Debug script to dump raw Bias AI table cells

nginx/ -- Reverse Proxy Configuration

File Purpose
nginx.conf Nginx configuration for HTTPS proxy
certs/ SSL certificate directory (fullchain.pem, privkey.pem)

tests/ -- 9 Test Files

Directory Files Count
tests/interpreters/ bias, session, orderblock, smt 4
tests/engine/ confluence, no-trade, setup-detector 3
tests/contracts/ colors, session-times 2

ictedge-mcp (7 files)

Window focus utility and TradingView Desktop launcher with independent CDP connection.

File Purpose
package.json Dependencies and MCP server config
src/server.js MCP server entry point
src/connection.js Independent CDP connection manager
src/tools/focus-window.js tv_list_windows and tv_focus_window tools
win-focus.vbs VBScript for window activation (AppActivate)
win-focus.ps1 PowerShell alternative using user32.dll P/Invoke