claude-tradingview-mcp
Allows Claude to analyze your TradingView charts by reading the desktop app window and capturing screenshots. Provides read-only tools for getting symbol, timeframe, screenshot, indicators (RSI, EMA, MACD, etc.), watchlist, and alerts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@claude-tradingview-mcp What's on my screen?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
claude-tradingview-mcp
Let Claude see your TradingView charts. Never let it trade them.
An MCP server that lets Claude analyze the chart you're looking at in the TradingView desktop app — by reading the window with AppleScript and screenshotting it. It has no order tools, no alert-write tools, no money-movement tools, and it refuses to boot if anyone adds one.
2. Demo
GIF placeholder:
docs/media/demo.gif— Claude Desktop receiving ascreenshot_chart()of an AAPL daily, then callingextract_indicators()and giving a plain-language read. (Record a 12–20s loop: ask "what's on my screen?" → Claude shows the chart back + the RSI/EMA/MACD read.)
Related MCP server: traderspost-mcp
3. Install
# 1) install the server (pipx keeps it isolated)
pipx install claude-tradingview-mcp # or: uv tool install claude-tradingview-mcp
# 2) register it with Claude
claude mcp add tradingview claude-tradingview-mcpThen grant macOS Accessibility + Screen Recording to the app running the server (Terminal / Claude Desktop) — see docs/install.md.
4. Quickstart
Drop the snippet from examples/claude-desktop-config.json
into your Claude Desktop config, chart any symbol in TradingView, and ask:
"What's on my screen?"
Claude calls get_symbol() → screenshot_chart() → extract_indicators() and tells
you what it sees.
5. Why
Claude can already analyze prose. Now it can analyze your charts — the exact ones on your screen, with your indicators and your layout. The chart stays on your machine: the screenshot is captured from your window, handed to Claude, and the temp file is deleted immediately. Nothing is uploaded by this tool, and nothing it exposes can place a trade.
6. The tools (all read-only)
Tool | What it returns |
| the charted symbol + timeframe (from the window title) |
| a base64 PNG of only the TradingView window |
| RSI, EMA20/50/200, MACD, ATR, Bollinger, VWAP, Supertrend + a verdict |
| symbols TradingView currently exposes |
| read-only view of visible alert configs |
resource | current symbol + open windows snapshot |
Tools this server will never have
place_order · modify_alert · paper_trade · withdraw · buy · sell ·
cancel_order · close_position · transfer — registration of any of these raises
at boot. See safety.py and
tests/test_safety.py.
7. Demo video
Placeholder: a 60-second screencast (link here). Show the boot-time safety abort when a write tool is added — that's the moment that sells the project.
8. FAQ
Will it ever execute a trade?
No. There is no code path that can. Tools are registered through a hardcoded allowlist
in safety.py; any tool whose name even
contains a trade/write verb raises SafetyViolation before the server starts. The
test suite asserts the registry is exactly the five read-only tools.
Does my chart get uploaded anywhere? The screenshot is captured locally and deleted from disk right after it's encoded. This tool uploads nothing. (Your MCP client — Claude — receives the image to analyze; that's the point.)
Does it work on Windows/Linux?
Not yet — it relies on macOS AppleScript + screencapture. PRs welcome for a
Windows/Linux read path, as long as they stay read-only.
Do I need a TradingView API key / paid plan? No. There is no TradingView API here — it reads the desktop app's window. Indicator math uses free public OHLC from yfinance.
9. Comparison
claude-tradingview-mcp | ccxt MCP servers | tradingview-screener | |
Reads your actual on-screen chart | ✅ | ❌ | ❌ |
Can place orders | ❌ never | ✅ (that's the point) | ❌ |
Needs API keys / exchange creds | ❌ | ✅ | ❌ |
Screenshot of your live window | ✅ | ❌ | ❌ |
Indicator bundle | ✅ (local, MIT) | varies | scanner-based |
Safety model | read-only by construction | you hold the keys | read-only |
10. Contributing
PRs welcome — with one hard rule: we will not merge any PR that adds a write tool (orders, alert mutation, money movement, "just paper trading", anything). The CI safety test will fail it, and so will we. See docs/threat-model.md.
11. License & sponsors
MIT © 2026 Aiden Hecker. See LICENSE. Indicator formulas are pure pandas (no AGPL dependency). If this saves you time, sponsorship keeps it maintained.
12. Requirements
macOS · TradingView desktop app · Python 3.10+ · Accessibility + Screen Recording permission for the host app. How it works: docs/how-it-works.md.
Available Tools
5 toolsextract_indicatorsA
Compute a technical-indicator bundle for the charted (or given) symbol.
Reads PUBLIC historical candles (yfinance) and computes RSI, EMA20/50/200, MACD, ATR, Bollinger, VWAP, Supertrend — plus plain-language signals and a verdict. This reads market data only; it cannot and will not place a trade. If symbol/interval are omitted, they're read from the current TradingView window.
Inputs: symbol, interval, lookback. Returns: object
get_symbolA
Read the symbol + timeframe currently charted in the TradingView desktop app.
Returns {symbol, exchange, interval, raw_title}. On a permission/parse failure returns {error, hint, raw_title} — then just ask the user for the ticker.
Inputs: no named parameters. Returns: object
get_watchlistA
Read the symbols TradingView currently exposes (one per open chart window).
Returns {symbols: [{symbol, exchange, interval, raw_title}], count}. Read-only.
Inputs: no named parameters. Returns: object
read_alertsA
READ-ONLY, best-effort read of your visible TradingView alert configs.
Returns {alerts, readable, note}. This tool can NEVER create, modify, arm, or delete an alert — there is no such code path.
Inputs: no named parameters. Returns: object
screenshot_chartA
Capture ONLY the TradingView window and return a base64 PNG of your chart.
The chart stays on your machine: the file is deleted from disk immediately after encoding, and this tool uploads nothing. Returns {format, base64, bytes, region, symbol, interval, note} or {error, hint}.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: extract_indicators computes technical indicators, get_symbol reads the current symbol, get_watchlist lists all open chart symbols, read_alerts reads alert configs, and screenshot_chart captures an image. No overlapping functionality.
All tool names follow a consistent verb_noun pattern using snake_case (extract_indicators, get_symbol, get_watchlist, read_alerts, screenshot_chart). The pattern is uniform and predictable.
Five tools is well-scoped for a TradingView-focused server. Each tool serves a distinct function without unnecessary bloat or missing essentials for the declared read-only analysis purpose.
The tool set covers core needs: reading symbols, watchlist, alerts, indicators, and screenshots. However, a tool for raw historical price data (beyond indicators) or a search tool for symbols is absent, though extract_indicators partially fills that gap.
Related MCP Connectors
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Hosted Screenshots MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
> 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
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
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.11344 npm61MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives Claude direct access to TradersPost webhook trading. Send trade signals, inspect strategy configs, query trade history, and monitor positions.MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that gives Claude the ability to analyze trading setups across IDX, Forex, and Crypto markets without executing trades.-
- FlicenseNot gradedqualityDmaintenanceAn MCP server that gives Claude the ability to watch any desktop window, detecting changes and providing compact image bundles for Claude's vision, enabling real-time screen-watching without API costs.-