/ Directory / Playground / tradingview-mcp
● Community atilaahmettaner ⚡ Instant

tradingview-mcp

by atilaahmettaner · atilaahmettaner/tradingview-mcp

Real-time screens, 30+ technical indicators, backtests and Reddit/news sentiment for crypto and equities — no paid key required.

tradingview-mcp wraps public market data (TradingView, Yahoo Finance, Reddit, news RSS, Binance/KuCoin/Bybit) behind MCP tools. Scan, analyze indicators, detect candlestick patterns, backtest strategies, pull sentiment. No API key needed for core tools.

Why use it

Key features

Live Demo

What it looks like in practice

tradingview.replay ▶ ready
0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": [
        "tradingview-mcp"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": [
        "tradingview-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": [
        "tradingview-mcp"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": [
        "tradingview-mcp"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "tradingview",
      "command": "uvx",
      "args": [
        "tradingview-mcp"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "tradingview": {
      "command": {
        "path": "uvx",
        "args": [
          "tradingview-mcp"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add tradingview -- uvx tradingview-mcp

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use tradingview-mcp

How to generate a daily market brief with signals and sentiment

👤 Retail traders, analysts ⏱ ~15 min intermediate

When to use: Pre-market coffee, 10 minutes before the open.

Prerequisites
  • Python + pip — pip install tradingview-mcp-server
Flow
  1. Snapshot the global state
    Give me a market_snapshot: S&P500, NASDAQ, VIX, BTC, ETH, EURUSD, gold.✓ Copied
    → Table of quotes + 24h change
  2. Scan for signals
    Use scan_by_signal to find S&P 500 stocks showing RSI < 30 AND MACD bullish crossover today.✓ Copied
    → List of 5-30 tickers
  3. Layer sentiment
    For each of the top 5, run combined_analysis — technical + Reddit + news.✓ Copied
    → Per-ticker composite rating

Outcome: A five-ticker watchlist with a reasoned thesis per name.

Pitfalls
  • Reddit sentiment is a crowd signal, not a crystal ball — Never act on sentiment alone — always pair with a technical or fundamental thesis
  • Yahoo Finance quotes lag by 15 minutes for US stocks — For real-time intraday, confirm via your broker before trading
Combine with: alpaca

How to backtest a simple strategy before risking capital

👤 Self-directed traders ⏱ ~20 min advanced

When to use: You want numbers, not vibes, on whether an idea works.

Flow
  1. Pick a symbol and strategy
    backtest_strategy: BB_bounce on SPY 2020-01-01 to 2026-04-01. Report Sharpe, max drawdown, trade count.✓ Copied
    → Metrics table + equity curve description
  2. Compare strategies
    compare_strategies on the same symbol and window — rank all 6.✓ Copied
    → Ranked table
  3. Sanity check
    Does the top strategy just ride a bull market? Show its performance only during drawdown periods.✓ Copied
    → Regime-specific breakdown

Outcome: A realistic view of whether a strategy has edge or just beta.

Pitfalls
  • Backtest overfitting — the best past strategy is often the worst live — Use out-of-sample windows and worry about Sharpe degradation, not peak Sharpe

How to screen crypto across Binance, KuCoin, and Bybit

👤 Crypto traders watching multiple venues ⏱ ~15 min intermediate

When to use: You want to find setups on whichever exchange has the cleanest liquidity.

Flow
  1. Screen the filter
    screen_stocks with exchange in [BINANCE, KUCOIN, BYBIT]: price change 24h > 5%, volume in USD > 10M, RSI between 40 and 60.✓ Copied
    → Cross-exchange list
  2. Check patterns
    For each result, run get_candlestick_patterns on the 4h timeframe.✓ Copied
    → Patterns surfaced per ticker

Outcome: A short list of candidates with technical context.

Combinations

Pair with other MCPs for X10 leverage

tradingview + alpaca

Screen with tradingview, then paper-trade via alpaca to validate

Find 3 SPY options setups with tradingview signals, open paper-trade positions via alpaca, and log to a Google Sheet.✓ Copied
tradingview + google-workspace

Log daily briefs to a Google Sheet for longitudinal tracking

Run a daily market_snapshot and append to tab 'Daily' in spreadsheet xyz.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
market_snapshot Morning brief free (Yahoo)
yahoo_price symbol: str Real-ish-time quote (15m delayed on US equities) free
get_technical_analysis symbol, timeframe RSI/MACD/BB snapshot free
get_bollinger_band_analysis symbol, timeframe Mean-reversion screening free
get_candlestick_patterns symbol, timeframe Pattern confirmation free
screen_stocks filters: {...} Multi-factor scans free
scan_by_signal signal: str, universe?: str Filter by one signal type free
backtest_strategy strategy: str, symbol, start, end Historical validation free
compare_strategies symbol, start, end Broad comparison free
market_sentiment symbol: str Retail sentiment check free (Reddit)
financial_news topic?: str Headlines feed free (RSS)
combined_analysis symbol One-shot full ticker read free

Cost & Limits

What this costs to run

API quota
Yahoo Finance: informal caps (roughly 2000 req/h). Reddit RSS: 60/min per IP.
Tokens per call
Screens: 500-3000 tokens depending on result count
Monetary
Free — all data sources are public
Tip
Cache indicator calls for the same bar close — rerunning inside a minute is wasteful.

Security

Permissions, secrets, blast radius

Minimum scopes: None — read-only public data
Credential storage: None required
Data egress: Yahoo Finance, TradingView, Reddit, RSS feeds, Binance/KuCoin/Bybit public endpoints
Never grant: Never use this for order placement; it is analysis-only

Troubleshooting

Common errors and fixes

Yahoo returns 429

Too many requests in a short window. Back off 60s and reduce request frequency.

TradingView indicator returns null

Symbol may not be listed on TradingView or timeframe is wrong. Try a known symbol like SPY first.

market_sentiment returns no data

The ticker may not be discussed on the tracked subreddits. Low-sentiment = no signal, not an error.

backtest runs forever

Narrow the date window; long histories with 1-minute bars are slow. Use daily bars first.

Alternatives

tradingview-mcp vs others

AlternativeWhen to use it insteadTradeoff
yfinance MCPYou only need raw Yahoo data, no indicatorsNo screeners/backtests/sentiment
Alpaca MCPYou want to actually execute tradesRequires a brokerage account; different tool scope

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills