AutoGineer
Generated banner for Tradingview MCP
Generated logo for Tradingview MCP

Tradingview MCP

Alex YangCommunityCreated by Alex Yang

  • Skill
  • Tool integration
  • Data and AI
  • MIT
  • No issues found
Download ZIP

From the author

Query TradingView market data through the bundled tradingview MCP server without a desktop app or login. Use whenever the user wants a technical analysis readout (RSI, MACD, Bollinger rating, BUY/SELL summary), multi-timeframe alignment (weekly→daily→4h→1h→15m), exchange-wide scans (Bollinger squeeze, volume breakout, consecutive candles, smart volume), top gainers/losers by exchange, futures market data (NQ/ES/CL/GC overview, overnight movers, category snapshots), pre-market / after-hours quotes, a quick options chain or unusual options activity (volume/OI by strike), bulk stock prices, a global market snapshot, strategy backtests (Sharpe, drawdown, win rate), or crypto exchange scans. Triggers include "TA on X", "multi-timeframe read", "BB squeeze scan", "futures movers", "NQ overnight", "pre-market price", "unusual options activity", "backtest RSI on AAPL", and "top gainers on NASDAQ". For options greeks, watchlists, alerts, or chart screenshots use tradingview-reader instead.
— the description by Alex Yang

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The tradingview-mcp skill provides a headless interface to access market data, technical analysis, and exchange-wide scans. It leverages a bundled MCP server to retrieve information such as indicator ratings, multi-timeframe trends, futures data, and options chains without requiring a TradingView account or desktop application. The skill is designed for read-only analytical tasks, including strategy backtesting and market pulse monitoring.

What it does

  • Provides technical analysis readouts including RSI, MACD, and Bollinger ratings.
  • Performs multi-timeframe trend alignment across various intervals.
  • Executes exchange-wide scans for volume breakouts, gainers, losers, and candle patterns.
  • Retrieves futures market data, including category snapshots and overnight movers.
  • Fetches options chains and identifies unusual options activity by volume and open interest.
  • Runs historical strategy backtests to calculate metrics like Sharpe ratio and win rate.

When to use it

  • When you need a quick technical analysis readout or indicator summary for a specific asset.
  • When performing exchange-wide scans to identify market movers or volume breakouts.
  • When analyzing futures market data or pre-market/after-hours price quotes.
  • When you need to perform historical backtesting of trading strategies.
  • When you require a snapshot of global market indices, crypto, or FX data.

Advantages

  • Operates without requiring a TradingView desktop application or user login.
  • Provides a unified interface for both TradingView scanner data and Yahoo Finance quotes.
  • Supports bulk stock price lookups and multi-timeframe analysis in single calls.
  • Enables programmatic access to strategy backtesting and market sentiment data.

Usage examples

“TA on NVDA”
The agent returns a technical analysis readout including RSI, MACD, and a BUY/SELL summary for NVIDIA.
“BB squeeze scan on NASDAQ”
The agent provides a list of stocks on the NASDAQ exchange currently exhibiting Bollinger squeeze patterns.
“backtest RSI on AAPL”
The agent runs a historical RSI strategy backtest on Apple stock and reports metrics like Sharpe ratio and win rate.
“futures movers”
The agent displays a list of the biggest percentage movers across various futures categories for the current session.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/himself65/tradingview-mcp/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip tradingview-mcp.zip -d .agents/skills

Documentation by Alex Yang

TradingView MCP (Headless Market Data)

Market data via the bundled tradingview MCP server — TradingView's public scanner API plus Yahoo Finance, spoken over MCP. No TradingView desktop app or account. Most tools need no API key. The server ships with the full plugin (mcp.json for portable/Codex packages, .mcp.json for legacy clients) and starts when enabled in a host that supports local stdio MCP processes. Its 39 tools appear under the plugin's tradingview MCP namespace (load them through the client's deferred-tool mechanism when necessary). Installing only the skill does not install the MCP server; use the full finance-data-providers plugin or configure the server separately.

Read-only. Nothing here places trades or mutates any account.

When to use this vs the other data skills

NeedSkill
Quotes, TA readout, indicator ratings, multi-timeframe alignmentthis skill
Exchange-wide scans: squeeze / volume breakout / gainers / losersthis skill
Futures (NQ, ES, CL, GC…) overview, movers, category quotesthis skill
Pre-market / after-hours pricethis skill
Options chain quick look (bid/ask/IV/OI, no greeks), unusual activitythis skill (fallback / positioning scan)
Options chain with greeks (delta/gamma/theta/vega), IV skew, expiries with contract countstradingview-reader (desktop app)
Watchlists, alerts, TV news, chart state / screenshots, custom-column screenertradingview-reader (desktop app)

Rule of thumb: this skill first for anything price/TA/scan shaped — it needs zero setup and won't force a CDP relaunch of the user's TradingView app. Drop to tradingview-reader only for greeks or account-bound data (watchlists, alerts, charts).

Step 1: Check requirements

  • uv installed (brew install uv) — the server runs via uvx and self-installs on first launch (give the first call ~30s).

  • Python 3.10–3.13. The pinned upstream currently excludes Python 3.14.

  • Optional: MARKETAUX_API_TOKEN enables market_sentiment, financial_news, and the news legs of combined analysis.

If the MCP tools are missing, ask the user to restart the agent after enabling the plugin. Do not silently replace market data with invented values.

Step 2: Select the smallest useful tool set

Prefer one focused call for a simple question. For a research brief, combine only the independent views that matter: price/snapshot, TA, volume, and optionally news. Avoid calling multiple overlapping TA tools merely to produce more output.

Quotes & snapshots
ToolUse for
stock_prices(tickers)Bulk quotes. tickers is comma-separated EXCHANGE:SYMBOL (e.g. "NASDAQ:NVDA,NYSE:DELL"), up to 1,000 rows in one call. OHLC + change%.
yahoo_price(symbol)Single quote, Yahoo symbology: AAPL, BTC-USD, SPY, ^GSPC, ^VIX, EURUSD=X, THYAO.IS.
stock_extended_hours(symbol)Pre-market / after-hours price for a US symbol — earnings reactions, overnight moves.
market_snapshot()Global one-shot: major indices, top crypto, FX, key ETFs.
bitcoin_market_pulse()BTC price + dominance + total mcap risk frame — call before analyzing any crypto.
Technical analysis (single symbol)
ToolUse for
coin_analysis(symbol, exchange, timeframe)The canonical TA readout for one stock or coin — RSI, MACD, Bollinger rating, indicator summary. Despite the name it handles stocks: coin_analysis("NVDA", "NASDAQ", "1D").
multi_timeframe_analysis(symbol, exchange)Weekly → Daily → 4H → 1H → 15m trend alignment.
combined_analysis(symbol, exchange, timeframe)TA + news + sentiment in one call (news legs need MARKETAUX_API_TOKEN).
multi_agent_analysis(symbol, exchange, timeframe)Technical vs Sentiment vs Risk "debate" summary.
volume_confirmation_analysis(symbol, exchange, timeframe)Is the move volume-confirmed?
smart_money_analysis(symbol, exchange, period, interval)Accumulation/distribution proxy from Yahoo OHLCV (banker/hot-money RSI split, banker-fund oscillator, CMF+MFI+OBV composite). Formula-based proxy, not real institutional-flow data. exchange defaults to EGX (appends .CA) — pass NASDAQ/NYSE for US tickers.
Exchange-wide scans
ToolUse for
top_gainers / top_losers(exchange, timeframe, limit)Movers on one exchange.
bollinger_scan(exchange, timeframe, bbw_threshold, limit)Low-BBW squeeze candidates.
rating_filter(exchange, timeframe, rating, limit)Filter by BB rating −3 (strong sell) … +3 (strong buy).
volume_breakout_scanner / smart_volume_scannerVolume + price breakout detection.
consecutive_candles_scan / advanced_candle_patternCandle-pattern scans.
stock_screener(country, stock_type, limit, …)Common/preferred share screen by country (america, japan, …), mcap-ranked.
Futures (夜盘 / overnight)
ToolUse for
futures_market_overview(category, exchanges, limit)Top contracts by volume. category: all / equity_index / energy / metals / agriculture / rates / forex / crypto_futures; exchanges: us / global.
futures_top_movers(direction, exchanges, limit)Biggest % movers today.
futures_category_snapshot(category)OHLCV for all front-month contracts in one category — e.g. equity_index → NQ, ES, YM, RTY.
futures_watchlist()Canonical front-month symbol list per category.
Options (US equities — no greeks)
ToolUse for
stock_options_chain(symbol, expiry)Calls + puts for one expiry (YYYY-MM-DD; omit → nearest). Returns strike, last, bid/ask, volume, OI, IV, ITM flag, plus the full available_expiries list. Source: Yahoo. No delta/gamma/theta/vega — use tradingview-reader for greeks.
stock_options_unusual_activity(symbol, top_n, min_volume, expiries)Top strikes by volume/OI ratio across the soonest expiries — positioning scan before earnings.
Backtesting
ToolUse for
backtest_strategy(symbol, strategy, period, interval, …)One strategy (rsi, bollinger, macd, ema_cross, supertrend, donchian, rsi_pullback, keltner_breakout, triple_ema) with Sharpe, max DD, win rate, vs buy-and-hold. Yahoo symbology.
compare_strategies(symbol, period, …)All 9 strategies ranked.
walk_forward_backtest_strategy(…)Train/test split with an overfitting verdict.
News & sentiment (needs MARKETAUX_API_TOKEN)

market_sentiment(symbol, category) · financial_news(symbol, category, limit)

Regional extras

egx_* (Egyptian Exchange suite, incl. egx_smart_money_scanner) — rarely relevant; also BIST, HKEX, SSE, SZSE, TWSE supported via the exchange param on scan tools.

Step 3: Normalize inputs

  1. exchange defaults to KUCOIN (crypto!) on most scan/TA tools — always pass NASDAQ / NYSE explicitly for US equities.

  2. Three symbologies coexist: scanner tools take bare symbol + exchange param; stock_prices takes EXCHANGE:SYMBOL; Yahoo-backed tools (yahoo_price, backtests, options) take Yahoo tickers (BTC-USD, ^VIX, THYAO.IS).

  3. Timeframes: 5m, 15m, 1h, 4h, 1D, 1W, 1M. Intraday scans on stock exchanges can be sparse — prefer 1D for equities.

  4. Tool names are canonical as listed. Use coin_analysis and multi_timeframe_analysis, not README-style aliases such as get_technical_analysis.

Step 4: Validate and interpret results

  1. Check timestamps, exchange, symbol, session, and currency before drawing conclusions.

  2. Treat a returned error envelope as an error, not as an empty result. Use its retryability and symbol suggestions; retry at most once when marked retryable.

  3. Filter wide scanner results to roughly 10 rows and the columns relevant to the question.

  4. Treat Yahoo options IV as suitable for chain shape and OI/volume positioning, not precise IV rank or skew. Cross-check IV-sensitive work with tradingview-reader.

  5. Backtests are historical simulations. Report the period, interval, costs, sample size, benchmark, and walk-forward result when available; do not present them as forecasts.

Step 5: Respond to the user

Lead with the answer, then show a compact evidence table. Include an as-of timestamp and data source, name any missing or stale fields, and separate observed facts from interpretation. For trading-shaped requests, keep the response analytical and read-only: discuss risks and scenarios without placing or offering to place a trade.

Files

README.md

tradingview-mcp

Read-only, headless TradingView market data through the bundled tradingview-mcp server. It uses TradingView scanner data and Yahoo Finance without requiring the TradingView desktop app or an account.

What it does

  • Technical analysis and multi-timeframe alignment

  • Exchange-wide gainers, losers, squeeze, candle, and volume scans

  • Futures overviews, category snapshots, and overnight movers

  • Regular and extended-hours quotes

  • US options chains and volume/OI unusual-activity scans (no greeks)

  • Nine-strategy and walk-forward backtests

  • Global market and Bitcoin snapshots

  • Optional Marketaux-powered news and sentiment

All 39 bundled MCP tools are annotated read-only. The skill never places trades or changes an account.

When to choose the desktop reader instead

Use tradingview-reader for per-strike greeks, detailed IV skew, account watchlists and alerts, TradingView news, chart state, or screenshots. It requires the logged-in macOS desktop app and the opencli adapter.

Installation

# Choose finance-data-providers when the plugin installer prompts.
npx plugins add himself65/finance-skills

# Or install only this Agent Skill.
npx skills add himself65/finance-skills --skill tradingview-mcp

Restart the agent after enabling the plugin so its bundled MCP server is loaded.

Requirements

  • uv / uvx (brew install uv on macOS)

  • Python 3.10–3.13

  • Optional MARKETAUX_API_TOKEN for news and sentiment tools

The first call downloads the pinned server and dependencies, so it can take about 30 seconds. Subsequent starts use the local uv cache.

Upstream pin

The plugin pins an immutable upstream Git SHA in ../../.mcp.json. Maintainers should upgrade the SHA deliberately: pick a reviewed commit, update the pin, run a real MCP initialize + tools/list handshake, confirm every tool is still read-only, and reconcile the tool catalog in SKILL.md with the registered tool names and schemas before release.

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs an MCP server, Needs an API key

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
Alex Yang
Publisher
Alex Yang (Community)
Source
himself65/finance-skills · plugins/data-providers/skills/tradingview-mcp · commit a085078
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Alex Yang.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download tradingview-mcp.zip