tradingview-mcp
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.
- Installs
- 205
- Last 24h
- +8
- Trending rank
- #9398
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/himself65/finance-skills --skill tradingview-mcp- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads tradingview-mcp automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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
| Need | Skill |
|---|---|
| Quotes, TA readout, indicator ratings, multi-timeframe alignment | this skill |
| Exchange-wide scans: squeeze / volume breakout / gainers / losers | this skill |
| Futures (NQ, ES, CL, GC…) overview, movers, category quotes | this skill |
| Pre-market / after-hours price | this skill |
| Options chain quick look (bid/ask/IV/OI, no greeks), unusual activity | this skill (fallback / positioning scan) |
| Options chain with greeks (delta/gamma/theta/vega), IV skew, expiries with contract counts | tradingview-reader (desktop app) |
| Watchlists, alerts, TV news, chart state / screenshots, custom-column screener | tradingview-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
uvinstalled (brew install uv) — the server runs viauvxand 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_TOKENenablesmarket_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
| Tool | Use 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)
| Tool | Use 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
| Tool | Use 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_scanner | Volume + price breakout detection. |
consecutive_candles_scan / advanced_candle_pattern | Candle-pattern scans. |
stock_screener(country, stock_type, limit, …) | Common/preferred share screen by country (america, japan, …), mcap-ranked. |
Futures (夜盘 / overnight)
| Tool | Use 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)
| Tool | Use 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
| Tool | Use 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
exchangedefaults toKUCOIN(crypto!) on most scan/TA tools — always passNASDAQ/NYSEexplicitly for US equities.- Three symbologies coexist: scanner tools take bare symbol +
exchangeparam;stock_pricestakesEXCHANGE:SYMBOL; Yahoo-backed tools (yahoo_price, backtests, options) take Yahoo tickers (BTC-USD,^VIX,THYAO.IS). - Timeframes:
5m, 15m, 1h, 4h, 1D, 1W, 1M. Intraday scans on stock exchanges can be sparse — prefer1Dfor equities. - Tool names are canonical as listed. Use
coin_analysisandmulti_timeframe_analysis, not README-style aliases such asget_technical_analysis.
Step 4: Validate and interpret results
- Check timestamps, exchange, symbol, session, and currency before drawing conclusions.
- 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.
- Filter wide scanner results to roughly 10 rows and the columns relevant to the question.
- 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. - 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.
FAQ
What does the tradingview-mcp skill do?
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.
How do I install tradingview-mcp?
Run npx skills add https://github.com/himself65/finance-skills --skill tradingview-mcp in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tradingview-mcp/ (personal) or .claude/skills/tradingview-mcp/ (project).
Which AI agents can use tradingview-mcp?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is tradingview-mcp safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains tradingview-mcp?
It is published by himself65 in himself65/finance-skills. It has 205 recorded installs.
More from himself65/finance-skills
yfinance-data
himself65/finance-skills
Fetch financial and market data with the yfinance Python library (Yahoo Finance). Use this skill whenever the user wants stock data: current quotes and price history, financial statements (income statement, balance sheet, cash flow), options chains, dividends and splits, earnings and analyst estimates, price targets and ratings, institutional and insider holdings, news, multi-ticker comparisons, stock screens, or sector and industry data. Use it even when the user gives only a ticker symbol (AAPL, MSFT, TSLA) and the intent has to be inferred. For earnings previews or recaps, estimate revisions, valuation, correlation, liquidity, or ETF premium analysis, prefer the dedicated skill.
stock-correlation
himself65/finance-skills
Analyze how stocks move together using Yahoo Finance price history (yfinance): find correlated peers for a ticker, measure correlation, beta, and spread between specific tickers, cluster a group into a correlation matrix, and track rolling or regime-dependent correlation. Use this skill whenever the user asks what moves with a stock, what else drops when it drops, related tickers or sympathy plays, sector or supply-chain peers, pair trading or hedging pairs, beta or relative performance, correlation matrices, co-movement, or rolling/realized correlation — including well-known pairs like AMD/NVDA, GOOGL/AVGO, or LITE/COHR. With a single ticker, assume the user wants its correlated peers.
options-payoff
himself65/finance-skills
Render an interactive options payoff chart — expiry P&L plus Black-Scholes theoretical value — with sliders for strikes, premium, IV, DTE, and spot. Use this skill whenever the user describes or shares an options position or strategy and wants to see how it makes or loses money: vertical, calendar, diagonal, or ratio spreads, butterflies, condors and iron condors, straddles, strangles, covered calls, protective or naked puts, or any multi-leg structure. This includes pasted strikes, premiums, and expiries, requests like "show me the payoff" or "draw the P&L curve", and broker screenshots (IBKR, TastyTrade, Robinhood). Use it even when details are partial — defaults fill the gaps.
earnings-preview
himself65/finance-skills
Build a pre-earnings briefing for a stock from Yahoo Finance data (yfinance): the upcoming report date and timing, consensus EPS and revenue estimates with their range, the beat/miss track record, analyst ratings and price targets, and what to watch in the print. Use this skill whenever the user is preparing for an upcoming earnings report or asks what the street expects — consensus or whisper numbers, EPS expectations, whether a company will beat, an earnings setup, or an earnings-season preview — and whenever a ticker comes up in the context of upcoming earnings, even without the word "preview". For results that are already out, use earnings-recap.
earnings-recap
himself65/finance-skills
Analyze a company's most recent (or a specified past) earnings report from Yahoo Finance data (yfinance): actual vs estimated EPS, surprise size, revenue and margin trends, and the stock's price reaction. Use this skill whenever the user asks how earnings went — beat or miss, earnings surprise, quarterly results, the post-earnings move, or an earnings call recap — including casual references to a past report such as "AMZN reported last night" or "how did they do". For an upcoming report, use earnings-preview.
generative-ui
himself65/finance-skills
Design system and templates for interactive HTML/SVG visuals in Claude and Codex, using an available inline renderer or a standalone HTML file. Use this skill whenever the user wants visual or interactive output rather than plain text or markdown: charts and dashboards, diagrams, flowcharts and architecture drawings, mockups, comparison grids, illustrations, interactive explainers ("explain how X works" with a visual), or tools with sliders, toggles, and live-updating displays — including financial data shown visually and requests phrased as "show me", "visualize", "draw", or "chart this".
Popular ai & agents skills
google-agents-cli-publish
google/agents-cli
This skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini", "publish to Gemini" (formerly Gemini Enterprise), or needs guidance on the agents-cli publish gemini command. Also use when the user wants to "manage agents in Agent Registry", "list/update/delete registered agents", or "register an MCP server". Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, Agent Registry fleet management, and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment (use google-agents-cli-deploy).
google-agents-cli-eval
google/agents-cli
This skill should be used when the user wants to "run an evaluation", "evaluate my agent", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Gemini platform eval methodology and the Quality Flywheel. Covers eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Applies to any agents-cli project, whatever framework the agent is written in. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use google-agents-cli-scaffold).
skill-creator
anthropics/skills
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
codex-pet
prime-skills/runcomfy-agent-skills
Codex Pet generator on RunComfy. Build a Codex-compatible Codex Pet spritesheet.webp + pet.json from a single reference image, drop it into ${CODEXHOME:-$HOME/.codex}/pets/ / and Codex picks it up as a custom Codex Pet next to the 8 built-ins. This skill produces the exact Codex Pet atlas Codex expects (1536x1872 PNG/WebP, 8 cols x 9 rows, 192x208 cells, 9 animation states — idle, running-right, running-left, waving, jumping, failed, waiting, running, review). Calls OpenAI GPT Image 2 edit ONCE via the local RunComfy CLI as runcomfy run openai/gpt-image-2/edit to produce a canonical Codex Pet pose, then assembles all 9 animation rows programmatically with ImageMagick micro-transforms — no Codex Pro, no $imagegen, no OPENAIAPIKEY required, only RUNCOMFYTOKEN. Triggers on "codex pet", "create codex pet", "make codex pet", "hatch codex pet", "/hatch image", "desktop pet codex", "codex pets", "spritesheet.webp", or any explicit ask to build a custom pet for OpenAI Codex.
full-output-enforcement
leonxlnx/taste-skill
Overrides default LLM truncation behavior. Enforces complete code generation, bans placeholder patterns, and handles token-limit splits cleanly. Apply to any task requiring exhaustive, unabridged output.
executing-plans
obra/superpowers
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available