Skip to main content
Glama

Server Details

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

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
atilaahmettaner/tradingview-mcp
GitHub Stars
5,292
Server Listing
TradingMCP
ChatGPT
–
Claude
–

TDQS

B3.3/5.0

Scored across 46 tools

Disambiguation3/5

Descriptions do heavy lifting to separate the analysis stack (coin_analysis vs multi_timeframe_analysis vs combined_analysis vs multi_agent_analysis), but the scanner family overlaps badly: egx_sector_scan vs egx_sector_scanner are nearly indistinguishable, and bollinger_scan / rating_filter / top_gainers / smart_volume_scanner / volume_breakout_scanner / consecutive_candles_scan all answer variants of 'what's moving on this exchange'. market_snapshot vs markets_dashboard and stock_prices vs yahoo_price also require reading the fine print to pick correctly.

Naming Consistency3/5

Everything is snake_case, which is good, but the verb/noun convention is not stable: some are verb_noun (backtest_strategy, watchlist_add, price_chart), some are noun_analysis (coin_analysis, market_sentiment, symbol_mentions), some are bare nouns (my_watchlist, financial_news). The scan/scanner pair (egx_sector_scan vs egx_sector_scanner) is a naming trap that implies a distinction the names don't convey.

Tool Count2/5

46 tools is far beyond a comfortable surface for one agent, and much of the bulk is redundant scanner variants rather than genuinely distinct capabilities. The EGX-specific cluster alone (fibonacci, index_analysis, market_overview, sector_scan, sector_scanner, smart_money_scanner, stock_screener, trade_plan) crowds out the general tools.

Completeness4/5

Coverage is genuinely broad: technical analysis, multi-timeframe, backtesting (including walk-forward), news/sentiment, futures, options, extended hours, screeners, and watchlist add/remove/list. Minor gaps exist — no alerts, no portfolio/P&L tracking, no explicit symbol search beyond the typeahead, and watchlist lacks a reorder/replace operation — but agents can work around all of them.

Available Tools

46 tools
advanced_candle_patternCandlestick Pattern AnalysisC
Read-only
Inspect

Advanced candle pattern analysis using multi-timeframe data.

Args:
    exchange: Exchange name (BINANCE, KUCOIN, etc.)
    base_timeframe: Base timeframe for analysis (5m, 15m, 1h, 4h)
    pattern_length: Number of consecutive periods to analyse (2-4)
    min_size_increase: Minimum percentage increase in candle size
    limit: Maximum number of results to return

Inputs: limit, exchange, base_timeframe, pattern_length, +1 more.

backtest_chartBacktest Equity CurveA
Read-only
Inspect

Run a strategy backtest and render its equity curve as an interactive chart in the conversation (capital growth + drawdown, with return / win-rate / Sharpe stats). Strategies: rsi, bollinger, macd, ema_cross, supertrend, donchian, rsi_pullback, keltner_breakout, triple_ema. period: 1mo|3mo|6mo|1y|2y, interval: 1d|1h. Clients without interactive app support can read the summary field.

Inputs: symbol (required), period, interval, strategy, +1 more.

backtest_strategyStrategy BacktestA
Read-only
Inspect

Backtest a trading strategy on historical data with institutional-grade metrics.

Args:
    symbol: Yahoo Finance symbol (AAPL, BTC-USD, THYAO.IS, ^GSPC)
    strategy: rsi | bollinger | macd | ema_cross | supertrend | donchian
              | rsi_pullback | keltner_breakout | triple_ema
              (rsi_pullback and triple_ema need period >= '1y' for SMA200 warmup)
    period: '1mo', '3mo', '6mo', '1y', '2y'
    initial_capital: Starting capital in USD (default $10,000)
    commission_pct: Per-trade commission % (default 0.1%)
    slippage_pct: Per-trade slippage % (default 0.05%)
    interval: '1d' (daily) or '1h' (hourly)
    include_trade_log: Include full per-trade log (default False)
    include_equity_curve: Include equity curve data points (default False)

Inputs: symbol (required), strategy (required), period, interval, +5 more.

bitcoin_market_pulseBitcoin Market PulseA
Read-only
Inspect

Single-call BTC macro context: price, dominance, total market cap + risk assessment.

Use this WHENEVER analyzing any cryptocurrency (altcoin or BTC itself) to
get the broader market frame in one shot. A SOL/ETH/whatever setup looks
very different when BTC is dumping with rising dominance vs. when alts
are leading. Calling this once gives Claude the macro context to provide
Bitcoin-aware commentary alongside the per-coin analysis - without
chaining 2-3 separate yahoo_price + manual reasoning calls.

Returns:
  - bitcoin: price, 24h change %, volume, market cap
  - dominance: BTC and ETH market-cap share of total crypto
  - total_market: total crypto mcap + 24h change + active coin count
  - assessment: label (HIGH_RISK / ALT_RISK / ALT_FAVORABLE / OPPORTUNITY_WITH_CAUTION / NEUTRAL) + 1-paragraph reasoning

Inputs: no named parameters.

bollinger_scanBollinger Squeeze ScannerA
Read-only
Inspect

Scan for assets with low Bollinger Band Width (squeeze detection). Works with crypto and stocks.

This scans a whole EXCHANGE for squeezes (canonical name is exactly
`bollinger_scan`; there is no "get_bollinger_band_analysis" tool). For
the Bollinger read of ONE symbol, call `coin_analysis` instead.

Example: bollinger_scan(exchange="BINANCE", timeframe="15m", bbw_threshold=0.008)

Args:
    exchange: Exchange — crypto: KUCOIN, BINANCE, BYBIT, MEXC; stocks: EGX, BIST, NASDAQ, NYSE, BURSA, HKEX, SSE, SZSE, TWSE, TPEX, EPA (Euronext Paris), AMS, BRU, LIS, MIL, LSE, SIX, BME, XETRA, FWB, TSX, TSXV, NSE, BSE (India), IDX (Indonesia)
    timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M. Typical squeeze thresholds: 15m→0.008, 1h→0.02, 4h→0.04, 1D→0.12
    bbw_threshold: Maximum BBW value to filter (default 0.04)
    limit: Number of rows to return (max 100)

Returns ``list[dict]`` on success. On ANY failure returns a structured
error envelope ``{"error": {"code": ..., "retryable": ...}}``.

Inputs: limit, exchange, timeframe, bbw_threshold. Returns: result

coin_analysisFull Technical AnalysisA
Read-only
Inspect

Get detailed analysis for a specific asset (coin or stock) on specified exchange and timeframe.

This is the canonical single-symbol technical readout (there is no
"get_technical_analysis" or "get_technical_summary" tool — use THIS one).
Use `multi_timeframe_analysis` instead when you need trend alignment
across several timeframes, and `combined_analysis` when you also want
news sentiment + headlines in the same call. Futures contracts (ES1!,
CL1!, …) and oil/gas/copper are quoted by the futures_* tools, not
analysed here; gold, silver, platinum and palladium are (GC1! → TVC:GOLD).

Example: coin_analysis(symbol="BTCUSDT", exchange="BINANCE", timeframe="1h")

Args:
    symbol: Bare ticker, no exchange prefix — crypto: "BTCUSDT", "ETHUSDT"; stocks: "COMI" (EGX), "THYAO" (BIST), "600519" (SSE), "300251" (SZSE), "2330" (TWSE), "3105" (TPEX)
    exchange: Exchange — crypto: KUCOIN, BINANCE, MEXC; stocks: EGX, BIST, NASDAQ, NYSE, BURSA, HKEX, SSE, SZSE, TWSE, TPEX, EPA (Euronext Paris), AMS, BRU, LIS, MIL, LSE, SIX, BME, XETRA, FWB, TSX, TSXV, NSE, BSE (India), IDX (Indonesia). If the symbol isn't listed there, the error's `listed_on` field names exchanges that do list it.
    timeframe: Time interval (5m, 15m, 1h, 4h, 1D, 1W, 1M)

Returns:
    Detailed analysis with all indicators and metrics

Inputs: symbol (required), exchange, timeframe.

combined_analysisCombined TA + Sentiment + NewsA
Read-only
Inspect

POWER TOOL: TradingView technical analysis + news sentiment + financial news.

Use this when you want TA AND sentiment AND news for one symbol in a
single call. For indicators only, `coin_analysis` is faster; for
cross-timeframe trend alignment use `multi_timeframe_analysis`.

Example: combined_analysis(symbol="NVDA", exchange="NASDAQ", timeframe="1D")

Args:
    symbol: Bare ticker, no exchange prefix ("AAPL", "BTCUSDT", "THYAO", "GDX")
    exchange: Exchange (NASDAQ, NYSE, AMEX, NYSEARCA, PCX, BINANCE, KUCOIN, MEXC, BIST, EGX, TWSE, TPEX)
    timeframe: Analysis timeframe (5m, 15m, 1h, 4h, 1D, 1W)

Inputs: symbol (required), exchange, timeframe.

compare_strategiesStrategy Comparison RaceA
Read-only
Inspect

Run all 9 strategies (RSI, Bollinger, MACD, EMA Cross, Supertrend, Donchian, RSI Pullback, Keltner Breakout, Triple EMA) and return a ranked leaderboard.

Args:
    symbol: Yahoo Finance symbol (AAPL, BTC-USD, SPY…)
    period: '1mo', '3mo', '6mo', '1y', '2y'
            (period >= '1y' recommended so rsi_pullback and triple_ema can
             complete SMA200 warmup; otherwise they contribute zero trades)
    initial_capital: Starting capital in USD (default $10,000)
    interval: '1d' (daily) or '1h' (hourly)

Inputs: symbol (required), period, interval, initial_capital.

consecutive_candles_scanConsecutive Candles ScannerB
Read-only
Inspect

Scan for coins with consecutive growing/shrinking candles pattern.

Args:
    exchange: Exchange name (BINANCE, KUCOIN, etc.)
    timeframe: Time interval (5m, 15m, 1h, 4h)
    pattern_type: "bullish" (growing candles) or "bearish" (shrinking candles)
    candle_count: Number of consecutive candles to check (2-5)
    min_growth: Minimum growth percentage for each candle
    limit: Maximum number of results to return

Inputs: limit, exchange, timeframe, min_growth, +2 more.

egx_fibonacci_retracementEGX Fibonacci RetracementB
Read-only
Inspect

Fibonacci retracement analysis for EGX stocks.

Args:
    symbol: EGX stock symbol (e.g., "COMI", "TMGH", "FWRY")
    lookback: Period for swing high/low — "1M", "3M", "6M", "52W", "ALL" (default 52W)
    timeframe: Analysis timeframe (5m, 15m, 1h, 4h, 1D, 1W, 1M — default 1D)

Inputs: symbol (required), lookback, timeframe.

egx_index_analysisEGX Index AnalysisB
Read-only
Inspect

Analyse an EGX index showing constituent performance with full indicators.

Args:
    index: EGX30, EGX70, EGX100, SHARIAH33, EGX35LV, TAMAYUZ
    timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M (default 1D)
    limit: Number of stocks to show in detail (max 100)

Inputs: index, limit, timeframe.

egx_market_overviewEGX Market OverviewB
Read-only
Inspect

Get a comprehensive overview of the Egyptian Exchange (EGX) market.

Args:
    timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M (default 1D for stocks)
    limit: Number of stocks per category (max 20)

Inputs: limit, timeframe.

egx_sector_scanEGX Sector ScanA
Read-only
Inspect

Scan EGX stocks by sector. Shows available sectors if none specified.

Args:
    sector: Sector name (banks, healthcare_and_pharma, real_estate, etc.)
            Leave empty to list all sectors.
    timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M
    limit: Max results per sector (max 50)

Inputs: limit, sector, timeframe.

egx_sector_scannerEGX Sector Rotation ScannerB
Read-only
Inspect

Sector rotation scanner for EGX — identifies hot/cold sectors and top picks.

Args:
    timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M (default 1D)
    top_n_sectors: Number of top sectors to show stock picks for (1-18, default 5)
    top_n_stocks: Number of top stocks per highlighted sector (1-10, default 3)
    min_stock_score: Minimum stock score for picks (0-100, default 60)

Inputs: timeframe, top_n_stocks, top_n_sectors, min_stock_score.

egx_smart_money_scannerEGX Smart Money ScannerA
Read-only
Inspect

Rank EGX index constituents by smart-money accumulation evidence.

Runs the full smart_money_analysis per constituent (Yahoo .CA history,
bounded thread pool) and ranks by the volume-flow composite score, with
the banker decomposition and oscillator state attached per row. Rows the
data source can't serve are listed under `skipped`, never silently
dropped.

Args:
    index: EGX30 | EGX70 | EGX100 | SHARIAH33 | EGX35LV | TAMAYUZ
    limit: Max ranked rows to return (default 10, max 50)
    period: History window — 1mo | 3mo | 6mo | 1y | 2y (default 6mo)
    min_score: Only include rows with composite score >= this (0-100)

Inputs: index, limit, period, min_score.

egx_stock_screenerEGX Stock ScreenerB
Read-only
Inspect

Production stock ranking engine for EGX — finds strong stocks with actionable setups.

Args:
    timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M (default 1D)
    min_score: Minimum stock score to include (0-100, default 55)
    index_filter: Filter by index — EGX30, EGX70, EGX100, SHARIAH33, EGX35LV, TAMAYUZ
    limit: Number of results (max 50)

Inputs: limit, min_score, timeframe, index_filter.

egx_trade_planEGX Trade PlanB
Read-only
Inspect

Generate a full trade plan for a specific EGX stock.

Args:
    symbol: EGX stock symbol (e.g., "COMI", "TMGH", "FWRY")
    timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M (default 1D)

Inputs: symbol (required), timeframe.

financial_newsFinancial News FeedA
Read-only
Inspect

Real-time financial news via Marketaux (licensed).

Args:
    symbol: Optional symbol filter ("AAPL", "BTC"). None = all news.
    category: News category ("crypto", "stocks", "all")
    limit: Max number of news items

Inputs: limit, symbol, category.

futures_category_snapshotFutures Category SnapshotB
Read-only
Inspect

Quote all major front-month contracts in a specific futures category.

Args:
    category: equity_index | energy | metals | agriculture | rates | forex | crypto_futures

Returns:
    OHLCV quotes for the standard watchlist of contracts in that category.
    Example symbols: ES1! NQ1! (equity_index), CL1! NG1! (energy), GC1! SI1! (metals).

Inputs: category.

futures_market_overviewFutures Market OverviewA
Read-only
Inspect

Top futures contracts sorted by trading volume.

Args:
    category:   all | equity_index | energy | metals | agriculture | rates | forex | crypto_futures
    exchanges:  us (CME, COMEX, NYMEX, CBOT) | global (adds ICE, EUREX)
    limit:      max contracts to return (default 30)
    volume_min: minimum volume filter (0 = no filter)

Returns:
    Dict with total_available count and list of contracts with OHLCV + % change.

Inputs: limit, category, exchanges, volume_min.

futures_top_moversFutures Top MoversA
Read-only
Inspect

Futures contracts with the biggest percentage moves today.

Args:
    direction:  gainers | losers
    exchanges:  us | global
    limit:      max results
    volume_min: minimum volume filter (default 10, filters illiquid contracts)

Returns:
    List of futures ranked by % change with OHLCV data.

Inputs: limit, direction, exchanges, volume_min.

futures_watchlistFutures WatchlistA
Read-only
Inspect

Return the full categorized list of well-known front-month futures symbols.

Categories: equity_index, energy, metals, agriculture, rates, forex, crypto_futures.
Use these symbols with futures_category_snapshot or coin_analysis for deeper analysis.

Inputs: no named parameters.

markets_dashboardTradingMCP MarketsA
Read-only
Inspect

The user's live market board. Start here when they ask how the markets are doing in general: "how are the markets today?", "what's moving?", "market update", a morning check before the open, or "open the market dashboard".

One call covers the overview: the user's own symbols on top (their watchlist, then what they asked about most in the last 30 days), then major indices (US, India, Türkiye, Indonesia, VIX), crypto, commodities and FX, each with today's change. Don't also call market_snapshot for the same overview; add other tools only for what the board doesn't show (futures, news, sectors). For a single symbol's price or analysis, use that symbol's own tool instead.

Opens as an interactive dashboard; clicking a row asks for that market's chart or analysis. Clients without app support can read the summary field.

Inputs: no named parameters. Returns: object

market_sentimentMarket News SentimentB
Read-only
Inspect

News sentiment for stocks and crypto (licensed Marketaux entity sentiment).

Args:
    symbol: Asset symbol ("AAPL", "BTC", "ETH", "TSLA")
    category: News group to search ("crypto", "stocks", "all")
    limit: Max articles to analyse

Inputs: symbol (required), limit, category.

market_snapshotGlobal Market SnapshotA
Read-only
Inspect

Global market overview: major indices, top crypto, FX rates, and key ETFs. Powered by Yahoo Finance.

Inputs: no named parameters.

multi_agent_analysisMulti-Agent Market DebateA
Read-only
Inspect

Run a multi-agent debate (Technical, Sentiment, Risk) for a specific symbol.

Args:
    symbol: Symbol — crypto: "BTCUSDT"; stocks: "COMI" (EGX), "THYAO" (BIST), "600519" (SSE), "300251" (SZSE), "2330" (TWSE), "3105" (TPEX), "GDX" (AMEX)
    exchange: Exchange — crypto: KUCOIN, BINANCE, MEXC; stocks: EGX, BIST, NASDAQ, NYSE, AMEX, NYSEARCA, PCX, SSE, SZSE, TWSE, TPEX, EPA (Euronext Paris), AMS, BRU, LIS, MIL, LSE, SIX, BME, XETRA, FWB, TSX, TSXV, NSE, BSE (India), IDX (Indonesia)
    timeframe: Time interval (5m, 15m, 1h, 4h, 1D, 1W)

Returns:
    A structured debate between 3 AI agents culminating in a final trading decision.

Inputs: symbol (required), exchange, timeframe.

multi_timeframe_analysisMulti-Timeframe AnalysisA
Read-only
Inspect

Multi-timeframe alignment analysis (Weekly → Daily → 4H → 1H → 15m).

Canonical name is exactly `multi_timeframe_analysis` (there is no
"get_multi_timeframe_analysis" tool). Use this for cross-timeframe trend
alignment on ONE symbol; for a single-timeframe deep dive use
`coin_analysis`; for TA + sentiment + news use `combined_analysis`.

Example: multi_timeframe_analysis(symbol="SOLUSDT", exchange="BINANCE")

Args:
    symbol: Bare ticker, no exchange prefix — crypto: "BTCUSDT"; stocks: "COMI" (EGX), "THYAO" (BIST), "600519" (SSE), "300251" (SZSE), "2330" (TWSE), "3105" (TPEX), "GDX" (AMEX)
    exchange: Exchange — crypto: KUCOIN, BINANCE, MEXC; stocks: EGX, BIST, NASDAQ, NYSE, AMEX, NYSEARCA, PCX, SSE, SZSE, TWSE, TPEX, EPA (Euronext Paris), AMS, BRU, LIS, MIL, LSE, SIX, BME, XETRA, FWB, TSX, TSXV, NSE, BSE (India), IDX (Indonesia)

Inputs: symbol (required), exchange.

my_watchlistA
Read-onlyIdempotent
Inspect

Show the user's personal watchlist. By default also fetches live prices + daily % change for every symbol on it (one batched request). Start here whenever the user says 'my watchlist', 'my list', or 'my coins/stocks'.

Inputs: include_quotes.

price_chartInteractive Price ChartA
Read-only
Inspect

Render an interactive candlestick chart for a symbol inside the conversation. Accepts crypto pairs (BTCUSDT, BTC-USD), stocks (AAPL, NVDA) or any Yahoo Finance symbol. period: 1mo|3mo|6mo|1y|2y (1h also takes 1d|5d), interval: 1d|1h|15m. 15m charts show recent action only: period is limited to 1d|5d|1mo (longer values auto-adjust to 5d) and the most recent 350 bars are drawn. Set bollinger=true to overlay Bollinger Bands (SMA20 ± 2σ); the latest band values are returned in the result. Clients without interactive app support can read the summary field of the result.

Inputs: symbol (required), period, interval, bollinger.

rating_filterBollinger Rating FilterA
Read-only
Inspect

Filter coins by Bollinger Band rating.

Args:
    exchange: Exchange name like KUCOIN, BINANCE, BYBIT, MEXC, etc.
    timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M
    rating: BB rating (-3 to +3): -3=Strong Sell, -2=Sell, -1=Weak Sell, 1=Weak Buy, 2=Buy, 3=Strong Buy
    limit: Number of rows to return (max 50)

Returns ``list[dict]`` on success. On ANY failure returns a structured
error envelope ``{"error": {"code": ..., "retryable": ...}}``.

Inputs: limit, rating, exchange, timeframe. Returns: result

smart_money_analysisSmart Money AnalysisA
Read-only
Inspect

Banker/hot-money proxy read for one symbol from price+volume history.

Three independent families, computed from Yahoo Finance OHLCV:
  - mcdx_style: RSI-horizon decomposition (banker RSI50 / hot-money RSI40
    / retail RSI14, each scaled 0-20) — sustained slow-horizon strength
    that fast horizons can't fake reads as institutional accumulation.
  - banker_fund_oscillator: EMA(13)-smoothed 34-bar stochastic of the
    weighted typical price, 0-100, with BANKER_ENTRY/EXIT states.
  - volume_flow_composite: CMF(20) + MFI(14) + OBV trend + up/down volume
    balance → 0-100 accumulation score.
Plus a consensus vote across the three.

These are documented, reproducible formula variants inspired by the
public "banker fund" indicator family — NOT actual institutional-flow
data, and not copies of any closed-source script.

Args:
    symbol: Bare ticker — EGX: "COMI", "TMGH"; US: "AAPL"; crypto pairs
        work via Yahoo notation ("BTC-USD").
    exchange: EGX (maps to Yahoo .CA), BIST (.IS), TADAWUL (.SR); anything
        else passes the symbol to Yahoo unchanged, except spot metals
        (XAUUSD on OANDA → gold futures GC=F; the result's `note` says so).
    period: 1mo | 3mo | 6mo | 1y | 2y (default 6mo)
    interval: 1d (default) or 1h

Inputs: symbol (required), period, exchange, interval.

smart_volume_scannerSmart Volume ScannerA
Read-only
Inspect

Smart volume + technical analysis combination scanner.

Args:
    exchange: Exchange name
    min_volume_ratio: Minimum volume multiplier (default 2.0)
    min_price_change: Minimum price change percentage (default 2.0)
    rsi_range: "oversold" (<30), "overbought" (>70), "neutral" (30-70), "any"
    limit: Number of results (max 30)

Returns ``list[dict]`` on success. On ANY failure returns a structured
error envelope ``{"error": {"code": ..., "retryable": ...}}``.

Inputs: limit, exchange, rsi_range, min_price_change, +1 more. Returns: result

stock_extended_hoursExtended-Hours Stock PriceA
Read-only
Inspect

Real-time pre-market and after-hours prices for a US stock symbol.

Use this when the user asks about a stock outside the regular 9:30am-4pm
ET session — earnings reactions, overnight news, "what is X doing in
after-hours?", "how did Y open in pre-market?". Returns the most recent
valid print from each session window (pre-market, regular, post-market)
along with computed % changes vs. the previous close and the regular
close, respectively.

During the regular session, post_market will be null (no data yet).
On weekends/holidays, returns whatever's most recent in each window.

Args:
    symbol: US stock symbol — AAPL, NVDA, TSLA, SPY, ^GSPC, etc.

Returns:
    - pre_market: {price, as_of_utc, change_vs_previous_close_pct, reference_close} or null;
      the change is measured from reference_close, the last regular close
      (before the open that is newer than previous_close)
    - regular: {price, as_of_utc, change_pct} (consolidated tape close)
    - post_market: {price, as_of_utc, change_vs_regular_close_pct} or null
    - previous_close, currency, exchange, market_state for context

Inputs: symbol (required).

stock_options_chainOptions ChainA
Read-only
Inspect

Full options chain (calls + puts) for a US stock symbol and one expiry.

Use this when the user asks "what's the options chain for X?", "show me
AAPL puts expiring next Friday", or wants to inspect bid/ask/IV/volume on
a specific strike. If no expiry is provided, returns the nearest expiry
so Claude can quote it back and ask "want a different one?".

Args:
    symbol: US stock symbol — AAPL, NVDA, TSLA, SPY, etc.
    expiry: Optional ISO date (YYYY-MM-DD). Must match one of the
        `available_expiries` Yahoo returns; otherwise returns an error
        with the list of valid dates.

Returns:
    - underlying_price, underlying_change_pct
    - requested_expiry, available_expiries (list of YYYY-MM-DD)
    - call_count, put_count
    - calls: list of {strike, last_price, bid, ask, volume,
      open_interest, implied_volatility, in_the_money, expiration}
    - puts: same shape as calls

Inputs: symbol (required), expiry.

stock_options_unusual_activityUnusual Options ActivityA
Read-only
Inspect

Top strikes by volume / open-interest ratio — institutional positioning signal.

Use this when the user asks "any unusual options activity on X?", "where
is the smart money positioned on NVDA before earnings?", or wants a
V/OI screener for a ticker. A V/OI ratio > 1 means today's volume already
exceeds standing open interest, which classically flags fresh institutional
positioning on a specific strike in a specific direction (call vs put).

Scans the soonest few expirations, filters out illiquid strikes (under
`min_volume`), and returns the top-N sorted by V/OI descending. Also
returns aggregate call vs put volume so Claude can comment on the
overall directional bias.

Args:
    symbol: US stock symbol — AAPL, NVDA, TSLA, SPY, META, etc.
    top_n: How many strikes to return. Default 10.
    min_volume: Filter floor for today's volume — prevents noise from
        illiquid strikes with high V/OI ratios. Default 100.
    expiries: Number of soonest expirations to scan. Default 4
        (typically covers ~1 month of weeklies + monthlies).

Returns:
    - underlying_price
    - expiries_scanned (list of YYYY-MM-DD)
    - total_call_volume, total_put_volume, put_call_volume_ratio
    - unusual: list of top-N contracts sorted by V/OI desc, each with
      {strike, side (call|put), expiration, volume, open_interest,
      v_oi_ratio, last_price, implied_volatility, in_the_money,
      strike_vs_spot_pct (moneyness)}

Inputs: symbol (required), top_n, expiries, min_volume.

stock_pricesMulti-Symbol Stock PricesA
Read-only
Inspect

Current price + daily % change for specific stock symbols.

Args:
    tickers: comma-separated EXCHANGE:SYMBOL list (max 2000 — one
        upstream request even at full size), e.g.
        "NASDAQ:NVDA, NASDAQ:TSLA, KRX:005930". The exchange prefix is
        required — the scanner's direct-ticker lookup is exchange-scoped.

Returns:
    Envelope dict: rows of {ticker, symbol, description, exchange, price,
    open, high, low, currency, change_percent} plus a not_found list naming any requested
    ticker the scanner didn't recognize.

Inputs: tickers (required).

stock_screenerUS Stock ScreenerA
Read-only
Inspect

Screen stocks by share type — the API twin of TradingView's "Common stock" / "Preferred stock" symbol-search filter.

Args:
    country: TradingView market name — e.g. america, korea, germany,
        brazil, japan, uk, india, turkey, canada, australia, france, hongkong
    stock_type: common | preferred
    limit: rows to return (max 2000, single upstream request), ranked by market cap descending
    exclude_otc: default True — drop OTC listings (foreign companies traded
        over-the-counter); "america" otherwise means "US venue", not "US company"
    compact: default False — True returns only ticker/symbol/price/currency/
        change_percent per row (light payload for bulk price feeds)
    sort_by: market_cap (default) | dividend_yield | change | price —
        server-side descending sort over the WHOLE market, so e.g.
        sort_by=dividend_yield with limit=20 is the market's true top-20
        dividend payers, not just the biggest companies re-sorted

Returns:
    Envelope dict: total_matches (market-wide count), returned, and rows
    of {ticker, symbol, description, exchange, price, open, high, low,
    currency, change_percent, dividend_yield, market_cap} — price is the
    current/last close; open/high/low are the current session's daily bar. Prices are in the
    market's local currency (e.g. KRW for korea).

Inputs: limit, compact, country, sort_by, +2 more.

symbol_mentionsFind a symbolA
Read-only
Inspect

Typeahead search for @-mentions: tickers on NASDAQ, NYSE, BIST and Binance as EXCHANGE:SYMBOL references.

Inputs: query. Returns: object

top_gainersTop Gainers ScreenerA
Read-only
Inspect

Return top gainers for an exchange and timeframe using Bollinger Band analysis.

Args:
    exchange: Exchange name — crypto: KUCOIN, BINANCE, BYBIT, MEXC; stocks: EGX, BIST, NASDAQ, NYSE, BURSA, HKEX, SSE, SZSE, TWSE, TPEX, EPA (Euronext Paris), AMS, BRU, LIS, MIL, LSE, SIX, BME, XETRA, FWB, TSX, TSXV, NSE, BSE (India), IDX (Indonesia)
    timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M
    limit: Number of rows to return (max 50)

Returns:
    list[dict] on success. On ANY failure returns a structured error
    envelope ``{"error": {"code": ..., "retryable": ...}}`` — never a
    raw exception string.

Inputs: limit, exchange, timeframe. Returns: result

top_losersTop Losers ScreenerA
Read-only
Inspect

Return top losers for an exchange and timeframe. Supports crypto (KUCOIN, BINANCE, MEXC) and stocks (EGX, BIST, NASDAQ).

Returns ``list[dict]`` on success. On ANY failure returns a structured
error envelope ``{"error": {"code": ..., "retryable": ...}}``.

Inputs: limit, exchange, timeframe. Returns: result

volume_breakout_scannerVolume Breakout ScannerA
Read-only
Inspect

Detect coins with volume breakout + price breakout.

Args:
    exchange: Exchange name like KUCOIN, BINANCE, BYBIT, MEXC, etc.
    timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M
    volume_multiplier: How many times the volume should be above normal level (default 2.0)
    price_change_min: Minimum price change percentage (default 3.0)
    limit: Number of rows to return (max 50)

Returns ``list[dict]`` on success, or an error envelope on total upstream
failure (``{"error": {"code": "ALL_BATCHES_FAILED", ...}}``). The empty
list now strictly means "no matches today"; rate-limit cliffs surface
explicitly.

Inputs: limit, exchange, timeframe, price_change_min, +1 more. Returns: result

volume_confirmation_analysisVolume Confirmation AnalysisC
Read-only
Inspect

Detailed volume confirmation analysis for a specific coin.

Args:
    symbol: Coin symbol (e.g., BTCUSDT)
    exchange: Exchange name
    timeframe: Time frame for analysis

Inputs: symbol (required), exchange, timeframe.

walk_forward_backtest_strategyWalk-Forward BacktestA
Read-only
Inspect

Walk-forward backtest to detect overfitting — validates strategy on unseen data.

Args:
    symbol: Yahoo Finance symbol (AAPL, BTC-USD, SPY…)
    strategy: rsi | bollinger | macd | ema_cross | supertrend | donchian
              | keltner_breakout
              (rsi_pullback and triple_ema not supported here — SMA200 warmup
               exceeds typical fold size; use run_backtest with period='2y')
    period: '1mo', '3mo', '6mo', '1y', '2y' (recommend '2y')
    initial_capital: Starting capital per fold in USD (default $10,000)
    commission_pct: Per-trade commission % (default 0.1%)
    slippage_pct: Per-trade slippage % (default 0.05%)
    n_splits: Number of walk-forward folds (default 3, max 10)
    train_ratio: Fraction of each fold used for training (default 0.7)
    interval: '1d' (daily) or '1h' (hourly)

Inputs: symbol (required), strategy (required), period, interval, +5 more.

watchlist_addA
Idempotent
Inspect

Add symbols to the user's personal watchlist (stored server-side, follows their API key across Claude/ChatGPT/any MCP client; max 50 symbols). Tickers must be EXCHANGE:SYMBOL, comma-separated — e.g. 'KUCOIN:BTCUSDT, NASDAQ:NVDA, BIST:THYAO, COMEX:GC1!'. Mixing asset classes is fine — crypto, stocks, futures, FX in one list.

Inputs: tickers (required).

watchlist_removeA
Idempotent
Inspect

Remove symbols from the user's personal watchlist. Tickers must be EXCHANGE:SYMBOL, comma-separated — e.g. 'KUCOIN:BTCUSDT, NASDAQ:NVDA, BIST:THYAO, COMEX:GC1!'. Removing is reversible (just add again).

Inputs: tickers (required).

yahoo_priceReal-Time Price QuoteA
Read-only
Inspect

Real-time price quote from Yahoo Finance for any stock, crypto, ETF or index.

Yahoo has no spot gold, silver, platinum or palladium (XAUUSD=X, XAGUSD,
OANDA:XPTUSD…): those are quoted from the front-month futures (GC=F,
SI=F, PL=F, PA=F), and the result's `note` says so.

Args:
    symbol: Yahoo Finance symbol — e.g. AAPL, BTC-USD, SPY, ^GSPC, EURUSD=X, THYAO.IS

Inputs: symbol (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      TradingView MCP server — real-time market data, technical indicators, screeners, and backtesting for Claude, ChatGPT, Cursor, Copilot, and any MCP client. Stocks, crypto, forex & futures across global exchanges.
      44
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that lets AI assistants interact with TradingView for real-time quotes, historical OHLCV data, screener, alerts, watchlists, news, chart layouts, Pine scripts, and more. Connect it to Claude Desktop, Cursor, or any MCP-compatible client to control TradingView via natural language.
      88 npm
      6
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that extends TradingView with AI-driven morning briefs, trading rule automation, and 81 tools for chart control, Pine Script development, replay practice, and multi-pane layouts.
      88 npm
      -
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.