TradingView MCP

Servidor Model Context Protocol (MCP) para TradingView Desktop en tu máquina: lee gráficos, ejecuta un resumen matutino diario, desarrolla Pine Script y automatiza flujos de trabajo mediante el Chrome DevTools Protocol (localhost:9222).

Mantenido por John Anthony. Este proyecto amplía el upstream tradingview-mcp de @tradesdontlie con un flujo de trabajo de resumen matutino, una configuración de reglas (rules.json) y correcciones para tv_launch en TradingView Desktop v2.14+.

[!WARNING] No afiliado a TradingView Inc. ni a Anthropic. Esta herramienta se conecta a tu aplicación TradingView Desktop local mediante Chrome DevTools Protocol. Revisa el Aviso legal antes de usarla.

[!IMPORTANT] Requiere una suscripción válida de TradingView. Esta herramienta no elude ningún muro de pago de TradingView. Lee y controla la aplicación TradingView Desktop que ya se está ejecutando en tu máquina.

[!NOTE] Todo el procesamiento de datos se realiza localmente. No se envía nada a ningún sitio. Ningún dato de TradingView sale de tu máquina.

Novedades de este fork

Configuración en un solo paso

Pega esto en Claude Code y se encargará de todo:

Set up TradingView MCP for me. 
Clone https://github.com/anthonyjohn17/tradingview-mcp.git to ~/tradingview-mcp, run npm install, then add it to my MCP config at ~/.claude/.mcp.json (merge with any existing servers, don't overwrite them). 
The config block is: { "mcpServers": { "tradingview": { "command": "node", "args": ["/Users/YOUR_USERNAME/tradingview-mcp/src/server.js"] } } } — replace YOUR_USERNAME with my actual username.
Then copy rules.example.json to rules.json and open it so I can fill in my trading rules.
Finally restart and verify with tv_health_check.

O sigue los pasos manuales a continuación.

Requisitos previos

• Aplicación TradingView Desktop (se requiere suscripción de pago para datos en tiempo real)

• Node.js 18+

• Claude Code (para herramientas MCP) o cualquier terminal (para la CLI)

• macOS, Windows o Linux

Inicio rápido

1. Clona e instala

git clone https://github.com/anthonyjohn17/tradingview-mcp.git ~/tradingview-mcp
cd ~/tradingview-mcp
npm install

2. Configura tus reglas

cp rules.example.json rules.json

Abre rules.json y rellena:

• Tu lista de seguimiento (símbolos que escanear cada mañana)

• Tus criterios de sesgo (qué hace que algo sea alcista/bajista/neutral para ti)

• Tus reglas de riesgo (las reglas que quieres que Claude revise antes de cada sesión)

3. Inicia TradingView con CDP

TradingView debe ejecutarse con el puerto de depuración habilitado.

Mac:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

O usa la herramienta MCP después de la configuración: "Usa tv_launch para iniciar TradingView en modo depuración"

4. Añádelo a Claude Code

Añádelo a ~/.claude/.mcp.json (combínalo con cualquier servidor existente):

{
  "mcpServers": {
    "tradingview": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/tradingview-mcp/src/server.js"]
    }
  }
}

Reemplaza YOUR_USERNAME con tu nombre de usuario real. En Mac: echo $USER para comprobarlo.

Transporte SSE (alternativa)

Ejecuta el servidor MCP a través de HTTP/SSE en lugar de stdio:

Inicia el servidor SSE:

# Mac/Linux
TRANSPORT=sse PORT=3000 node src/server.js

# Windows
set TRANSPORT=sse
node src/server.js

Scripts de lanzamiento:

# Mac/Linux - custom port
./scripts/launch_mcp_sse.sh 8080

# Windows - custom port
scripts\launch_mcp_sse.bat 8080

Configura Claude Code para conectarse mediante SSE:

{
  "mcpServers": {
    "tradingview": {
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

El servidor SSE escucha en http://127.0.0.1:3000/sse por defecto. Anula el puerto con la variable de entorno PORT.

5. Verificación

Reinicia Claude Code y pregunta: "Usa tv_health_check para verificar que TradingView está conectado"

6. Ejecuta tu primer resumen matutino

Pídele a Claude: "Ejecuta morning_brief y dame mi sesgo de sesión"

O desde la terminal:

npm link  # install tv CLI globally (one time)
tv brief

Flujo de trabajo del resumen matutino

Esta es la función que convierte esto de un conjunto de herramientas en un hábito diario.

Antes de cada sesión:

1. TradingView está abierto (iniciado con puerto de depuración)

2. Ejecuta: tv brief en tu terminal (o pídele a Claude: "ejecuta morning_brief")

3. Claude escanea cada símbolo de tu lista de seguimiento, lee tus valores de indicadores, aplica los criterios de tu rules.json e imprime:

BTCUSD  | BIAS: Bearish  | KEY LEVEL: 94,200  | WATCH: RSI crossing 50 on 4H
ETHUSD  | BIAS: Neutral  | KEY LEVEL: 3,180   | WATCH: Ribbon direction on daily
SOLUSD  | BIAS: Bullish  | KEY LEVEL: 178.50  | WATCH: Hold above 20 EMA

Overall: Cautious session. BTC leading bearish, SOL the exception — watch for divergence.

4. Guárdalo: "guarda este resumen" (usa session_save)

5. A la mañana siguiente, compara: "obtén la sesión de ayer" (usa session_get)

Qué hace esta herramienta

• Resumen matutino — escanea la lista de seguimiento, lee indicadores, aplica tus reglas e imprime el sesgo de sesión

• Desarrollo de Pine Script — escribe, inyecta, compila y depura scripts con IA

• Navegación de gráficos — cambia símbolos, marcos temporales, amplía a fechas, añade/elimina indicadores

• Análisis visual — lee valores de indicadores, niveles de precio y niveles dibujados de indicadores personalizados

• Dibujar en gráficos — líneas de tendencia, niveles horizontales, rectángulos, texto

• Gestionar alertas — crea, lista, elimina alertas de precio

• Práctica de replay — avanza por barras históricas, practica entradas y salidas con seguimiento de P&L

• Capturas de pantalla — captura el estado del gráfico

• Distribuciones multipanel — cuadrículas 2x2, 3x1 con distintos símbolos por panel

• Transmitir datos — salida JSONL desde tu gráfico en vivo para scripts de monitoreo

• Acceso CLI — cada herramienta es también un comando tv, con salida JSON compatible con tuberías

Cómo sabe Claude qué herramienta usar

Claude lee CLAUDE.md automáticamente cuando trabaja en este proyecto. Contiene el árbol de decisión completo.

Referencia de herramientas (81 herramientas MCP)

Resumen matutino (nuevo en este fork)

Lectura de gráficos

Datos de indicadores personalizados (dibujos de Pine)

Lee la salida de line.new(), label.new(), table.new(), box.new() de cualquier indicador Pine visible.

Usa siempre study_filter para apuntar a un indicador específico: study_filter: "MyIndicator".

Control de gráficos

Desarrollo de Pine Script

Modo replay

Multipanel, alertas, dibujos, interfaz de usuario

CLI Commands

tv brief                           # run morning brief
tv session get                     # get today's saved brief
tv session save --brief "..."      # save a brief

tv status                          # check connection
tv quote                           # current price
tv symbol BTCUSD                   # change symbol
tv ohlcv --summary                 # price summary
tv screenshot -r chart             # capture chart
tv pine compile                    # compile Pine Script
tv pane layout 2x2                 # 4-chart grid
tv stream quote | jq '.close'      # monitor price ticks

Full command list: tv --help

Troubleshooting

Architecture

Claude Code  ←→  MCP Server (stdio or SSE)  ←→  CDP (port 9222)  ←→  TradingView Desktop (Electron)

• 78 original tools + 3 morning brief tools = 81 MCP tools total

• Transport: MCP over stdio (default) or SSE (TRANSPORT=sse)

• Connection: Chrome DevTools Protocol on localhost:9222

• No external network calls — everything runs locally

• Zero extra dependencies beyond the original

SSE Transport

Run the server over HTTP/SSE instead of stdio:

TRANSPORT=sse node src/server.js

The server listens on http://127.0.0.1:3000/sse by default. Override with:

TRANSPORT=sse PORT=8080 HOST=0.0.0.0 node src/server.js

Configure Claude Code to connect via SSE:

{
  "mcpServers": {
    "tradingview": {
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

Credits

• Upstream: tradingview-mcp by @tradesdontlie — the original MCP bridge and foundation.

• This fork: John Anthony — morning brief, session helpers, rules.json, and launch fixes for recent TradingView Desktop builds.

If you find the upstream useful, star their repository.

Disclaimer

This project is provided for personal, educational, and research purposes only.

This tool uses the Chrome DevTools Protocol (CDP), a standard debugging interface built into all Chromium-based applications. It does not reverse engineer any proprietary TradingView protocol, connect to TradingView's servers, or bypass any access controls. The debug port must be explicitly enabled by the user via a standard Chromium command-line flag.

By using this software you agree that:

1. You are solely responsible for ensuring your use complies with TradingView's Terms of Use and all applicable laws.

2. This tool accesses undocumented internal TradingView APIs that may change at any time.

3. This tool must not be used to redistribute, resell, or commercially exploit TradingView's market data.

4. The authors are not responsible for any account bans, suspensions, or other consequences.

Use at your own risk.

License

MIT — see LICENSE. Applies to source code only, not to TradingView's software, data, or trademarks.