tradingview-mcp
tradingview-mcp
tradingview-mcp/ v0.1 ──────────────────────────────────────────────────Un servidor MCP enfocado y con tipado fuerte que permite a Claude Code (o cualquier cliente compatible con MCP) controlar una aplicación de TradingView Desktop en ejecución local: leer el estado del gráfico, cambiar símbolos y marcos temporales, obtener barras OHLCV y capturar capturas de pantalla.
[!IMPORTANT] Este proyecto no está afiliado, respaldado ni asociado con TradingView Inc. Es un puente de uso personal que interactúa con su aplicación TradingView Desktop en ejecución local a través del protocolo Chrome DevTools, el mismo estándar de interfaz de depuración integrado en Slack, VS Code, Discord y cualquier otra aplicación de Electron.
[!IMPORTANT] Requiere una suscripción válida de TradingView. Esta herramienta no omite, extrae ni elude ningún muro de pago o control de acceso de TradingView. Todo sucede en su máquina, contra la instancia de TradingView Desktop en la que ya ha iniciado sesión y por la que ha pagado.
[!NOTE] Todo el procesamiento es local. Esta herramienta no transmite, almacena ni redistribuye datos de TradingView. Sus gráficos, sus datos, su máquina.
[!CAUTION] La API interna de la página de TradingView no está documentada. Puede cambiar entre versiones de escritorio. Fije una versión de TradingView Desktop que funcione si desea estabilidad, y consulte la nota de compatibilidad de versiones antes de actualizar.
Lo que hace
Envuelve el gráfico de TradingView Desktop en un pequeño conjunto de herramientas MCP bien definidas. Las herramientas están tipadas de extremo a extremo con esquemas de Zod, validadas en el límite y muestran mensajes de error útiles cuando algo sale mal.
┌───────────────┐
│ Claude Code │
│ (or any MCP │
│ client) │
└───────┬───────┘
│ stdio (MCP)
▼
┌───────────────┐
│tradingview-mcp│
└───────┬───────┘
│ Chrome DevTools Protocol
▼
┌───────────────┐
│ TradingView │
│ Desktop │
│ (--remote- │
│ debugging- │
│ port=9222) │
└───────────────┘Related MCP server: TradingView MCP Jackson
¿Por qué otra integración de TradingView?
Existen proyectos de automatización de TradingView. Este está deliberadamente limitado:
12 herramientas, no 78. Cada herramienta está documentada, tipada y probada.
TypeScript estricto. Sin
any, sin retornos implícitos,noUncheckedIndexedAccessactivado.Una responsabilidad por archivo. La conexión, la página, las herramientas y el servidor son capas separadas: la deriva de versiones solo requiere arreglar un punto.
Errores tipados.
ConnectionError,ToolExecutionError,ChartStateError, etc., con mensajes procesables.tradingview-mcp doctor. Un comando de diagnóstico que le dice exactamente qué está mal en su configuración.
Use esto si desea una superficie pequeña y predecible que pueda leer en una tarde. Use las alternativas "todo incluido" si desea que cada función de TradingView esté envuelta.
Instalación
Requiere Node.js 20+.
npm install -g tradingview-mcp
# or, in a project:
npm install tradingview-mcpPara desarrollo:
git clone https://github.com/harshil1502/tradingview-mcp.git
cd tradingview-mcp
npm install
npm run buildConfiguración: tres pasos
1. Cierre cualquier TradingView Desktop en ejecución
De lo contrario, el puerto de depuración no se puede habilitar.
2. Inicie TradingView Desktop con el puerto de depuración habilitado
macOS:
open -a "TradingView" --args --remote-debugging-port=9222Windows:
& "C:\Users\<you>\AppData\Local\Programs\TradingView\TradingView.exe" --remote-debugging-port=9222Linux:
tradingview --remote-debugging-port=9222[!NOTE] La bandera
--remote-debugging-portes una bandera de depuración estándar de Chromium. Es opcional y está deshabilitada por defecto. No sucede nada sin que usted la pase explícitamente.
3. Verifique la conexión
tradingview-mcp doctorSi todo está conectado, verá algo como:
tradingview-mcp · doctor
─────────────────────────────────────────────
[ok] CDP endpoint reachable on localhost:9222
[ok] TradingView page found (NASDAQ:AAPL · 1h)
[ok] tvWidget detected — chart state readable
─────────────────────────────────────────────
ready.Uso con Claude Code
Añada esto a su configuración de MCP de Claude Code (~/.claude/mcp.json o .mcp.json del proyecto):
{
"mcpServers": {
"tradingview": {
"command": "tradingview-mcp",
"env": {
"TV_MCP_PORT": "9222"
}
}
}
}Reinicie Claude Code. Las herramientas a continuación estarán disponibles.
Herramientas
Herramienta | Descripción |
| Leer el símbolo actual, marco temporal, estudios visibles, último precio |
| Cambiar el símbolo activo (ej. |
| Cambiar resolución ( |
| Obtener hasta 5,000 barras OHLCV más recientes del gráfico activo |
Próximamente más herramientas: consulte docs/roadmap.md.
Sesión de ejemplo
You: What's the chart showing?
Claude: [calls chart_get_state]
Showing NASDAQ:AAPL on 1h timeframe with EMA20, EMA50.
Last price 187.42.
You: Switch to BTCUSDT 4h and pull the last 200 bars.
Claude: [calls chart_set_symbol, chart_set_timeframe, chart_get_ohlcv]
Done. Range: 187 days. Open at start: 62,440.
Close at end: 67,830. +8.6%.Configuración
Variable de entorno | Predeterminado | Descripción |
|
| Host CDP |
|
| Puerto de depuración CDP |
| (autodetectar) | ID de destino CDP explícito: solo necesario si tiene varias ventanas de TradingView abiertas |
Desarrollo
npm install
npm run build # tsc to dist/
npm run dev # tsc --watch
npm test # vitest run
npm run test:coverage # with v8 coverage report
npm run typecheck # tsc --noEmitLa base de código tiene cuatro capas:
src/
├── index.ts entry — reads env, starts stdio server
├── server.ts MCP server, tool registration, request handlers
├── errors.ts typed error classes
├── types.ts shared types + Zod schemas
├── connection/
│ ├── cdp.ts CDP client wrapper (chrome-remote-interface)
│ └── tradingview.ts TradingView-page interactions (all evaluated JS lives here)
└── tools/
├── index.ts tool registry
└── chart.ts chart_* toolsPara añadir una herramienta:
Cree un nuevo archivo en
src/tools/(o extienda uno existente).Exporte los esquemas de Zod
<name>Inputy<name>Outputademás de la función manejadora.Añada la entrada a
TOOLSensrc/tools/index.ts.Añada una prueba en
tests/.
Eso es todo: autorregistrado, autovalidado, autointrospectivo.
Compatibilidad de versiones
TradingView Desktop | tradingview-mcp | Estado |
2026.x.x | 0.1.x | Probado |
Si TradingView se actualiza y las herramientas comienzan a fallar, revise primero connection/tradingview.ts: ese es el único archivo que conoce la API interna de TradingView.
Descargo de responsabilidad
Este software se proporciona "tal cual" sin garantía de ningún tipo. Al ejecutarlo, usted reconoce:
Está utilizando su propia instancia de TradingView Desktop pagada, contra sus propios datos.
Usted mismo habilitó el puerto de depuración de Chrome DevTools.
La API interna de TradingView no está documentada y puede romperse.
Nada en este software garantiza la corrección de las decisiones comerciales tomadas por un agente de IA sobre él. Úselo en una cuenta de papel antes de dejar que toque capital real.
Licencia
MIT © 2026 Harshil Patel
Agradecimientos
Esta es una implementación nueva, construida desde cero con el objetivo de ser pequeña, bien tipada y fácil de leer. Si ha trabajado en herramientas similares en este espacio, gracias por abrir el camino.
Available Tools
11 toolschart_get_ohlcvB
Fetch recent OHLCV bars from the active chart.
Inputs: count.
chart_get_stateA
Read the current chart state: symbol, timeframe, visible studies, and last price.
Inputs: no named parameters.
chart_set_symbolB
Change the active chart symbol (e.g. "NASDAQ:AAPL").
Inputs: symbol (required).
chart_set_timeframeB
Change the active chart timeframe / resolution.
Inputs: timeframe (required).
pine_compileB
Trigger a Pine compile and return diagnostics (errors, warnings).
Inputs: no named parameters.
pine_get_sourceA
Read the current Pine Editor source code. Pine Editor must be open.
Inputs: no named parameters.
pine_saveA
Save the current Pine script (commits + reloads the indicator on the chart).
Inputs: no named parameters.
pine_set_sourceB
Replace the Pine Editor source code with new content.
Inputs: code (required).
quote_getA
Get a real-time quote snapshot for the active symbol (last price, day OHLC, volume).
Inputs: no named parameters.
screenshot_chartA
Capture the chart pane as a base64-encoded PNG.
Inputs: no named parameters.
screenshot_fullA
Capture the full TradingView viewport as a base64-encoded PNG.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose. The chart_* tools handle different aspects of chart interaction, pine_* tools manage Pine script editing and compilation, screenshot_* tools capture images, and quote_get fetches real-time quotes. No overlapping functionality.
Tool names follow a consistent pattern: <domain>_<verb>_<noun> (e.g., chart_get_ohlcv, pine_set_source, screenshot_chart). All use lowercase with underscores, and the verb-noun structure is uniform across domains.
With 11 tools, the server is well-scoped for a TradingView MCP. It covers chart manipulation, Pine scripting, quotes, and screenshots without being bloated or too sparse.
The tool set covers core workflows like symbol/timeframe changes, data retrieval, Pine script management, and screenshots. A minor gap is the lack of tools to add or remove studies (only visible studies are read), but this does not severely hinder typical use cases.
Maintenance
Related MCP Connectors
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
> TradingMCP puts a market analyst inside your AI assistant. Paste one URL into Claude, ChatGPT, Cursor, VS Code or any MCP client and ask in plain language: screen for breakouts, run a multi-timeframe analysis, backtest a strategy with walk-forward validation, scan for smart-money and volume signals, or get a one-prompt morning market brief. In clients that support MCP Apps, price charts and the Markets panel are drawn right in the chat. > 40+ tools covering crypto (real-time), stocks, ETFs, FX, futures and commodities across major global exchanges. > Hosted, nothing to install: Pro $9/month (2,500 tool calls) or Pro+ $29/month (10,000). Paid upfront with a 14-day money-back guarantee; your API key arrives right after checkout. > Built on the open-source tradingview-mcp core (MIT, ~5k GitHub stars): self-host it free, or use the hosted version with zero ops. > For research and education, not financial advice. Not affiliated with TradingView
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Related MCP Servers
- AlicenseBqualityAmaintenanceMCP server that lets AI agents directly control and interact with the TradingView desktop app via 88 chart-control tools, enabling automated chart reading, Pine Script compilation, strategy optimization, and replay control.11347 npm60MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that connects to TradingView Desktop via Chrome DevTools Protocol, enabling chart control, Pine Script development, and a morning brief workflow with AI-driven analysis.88 npm-
- AlicenseAqualityDmaintenanceA Codex-first MCP server that bridges TradingView Desktop via Chrome DevTools Protocol, enabling launch, symbol/timeframe control, and health checks from Codex CLI.54MIT
- AlicenseNot gradedqualityAmaintenanceA local MCP server that connects TradingView Desktop to AI assistants via Chrome DevTools Protocol, enabling Pine Script development, multi-timeframe analysis, and Wyckoff scanning with a rules engine.44 npm1MIT