Skip to main content
Glama
tradingview-mcp-india

tradingview-mcp-india

tradingview-mcp-india

A fork of tradingview-mcp-server by Atila Ahmettaner (MIT), with Indian stock-market (NSE / BSE) support added.

What this fork adds

  • Registered NSE and BSE as stock exchanges mapped to TradingView's india market (src/tradingview_mcp/core/utils/validators.py).

  • Bundled symbol lists coinlist/nse.txt and coinlist/bse.txt (top ~1,000 most-liquid tickers each), so symbol-iterating tools work too.

  • Indian news: new india RSS category (Economic Times, Moneycontrol, LiveMint, Hindu BusinessLine) and a dedicated india_news MCP tool.

  • Indian sentiment: new india Reddit group (r/IndianStockMarket, r/IndianStreetBets, r/DalalStreetTalks, r/StockMarketIndia, r/IndiaInvestments).

  • Indian indices in market_snapshot: Nifty 50 (^NSEI), Sensex (^BSESN), Bank Nifty (^NSEBANK), plus USDINR FX.

  • combined_analysis routing: NSE/BSE now pull Indian news + Indian sentiment (previously fell through to Reuters/US subreddits and returned nothing).

  • SSL reliability fix (important): all outbound HTTPS (Yahoo Finance, Reddit, RSS) now uses a certifi-backed SSL context — via proxy_manager._https_handler() for the shared opener and a dedicated fetch in news_service, plus browser User-Agent and manual HTTP 308 redirect following. Without this, the macOS CERTIFICATE_VERIFY_FAILED error silently broke every network tool (Yahoo price, snapshot, backtest, sentiment, news) — not just India.

Everything else is unchanged from upstream v0.7.1.

Related MCP server: mcp-indian-stocks

Install (editable)

python3 -m venv venv && source venv/bin/activate
pip install -e .

Editable means your local edits to src/ are live immediately — no reinstall, and a pip install --upgrade of the original PyPI package can never overwrite this fork.

Usage for Indian markets

Screener / technical-analysis tools — pass exchange="NSE" (or "BSE"), use 1D/1W timeframes:

top_gainers(exchange="NSE", timeframe="1D")
coin_analysis(symbol="RELIANCE", exchange="NSE", timeframe="1D")
multi_agent_analysis(symbol="INFY", exchange="NSE", timeframe="1D")

Yahoo / backtest tools — use the .NS (NSE) or .BO (BSE) suffix:

backtest_strategy("TCS.NS", "rsi", "1y")
compare_strategies("INFY.NS")

Indian news:

india_news(limit=10)                 # all India market headlines
india_news(symbol="RELIANCE")        # only headlines mentioning RELIANCE
financial_news(category="india")     # same feeds via the generic tool

Stock suggestion engine (NSE/BSE)

AI-assisted LONG trade ideas — each with entry (CMP), stop-loss, two targets, risk/reward, a 0–100 conviction score, and a plain-English rationale:

india_swing_picks(exchange="NSE", top_n=5)                 # 2-7 day swing ideas (daily TF)
india_swing_picks(direction="short")                       # bearish setups
india_swing_picks(index_filter="NIFTY50")                  # restrict to an index universe
india_intraday_signals(exchange="NSE", top_n=5)            # same-session ideas (15m, VWAP-aware)
india_trade_plan("AXISBANK", mode="swing", direction="auto")  # full plan for one stock
india_backtest("TCS", period="2y")                         # validate vs history (6-strategy leaderboard)
india_swing_picks(capital=200000, risk_pct=1.5)            # add position sizing (qty + ₹ P&L)
  • Position sizing: pass capital (INR) and risk_pct to any idea tool. Each idea then carries position_sizing: share quantity sized so a stop-out loses ~risk_pct of capital (capped by capital), plus position_value, rupee loss_at_stop, and profit_at_t1/t2. Short sizing is notional (real shorting needs margin).

  • direction: "auto" (long uptrends / short downtrends), "long", or "short". Short setups use a dedicated bearish momentum/quality scorer (the shared engine is long-biased) and inverted levels (stop above entry, targets below).

  • index_filter: "NIFTY50", "NIFTYBANK", "NIFTYNEXT50" — constituents bundled in core/data/india_indices.py (refresh on NSE rebalance).

  • india_backtest: maps the symbol to Yahoo (.NS/.BO) and runs all 6 strategies as a robustness check on whether the name respects technical setups.

How it works: scans the most-liquid NSE/BSE stocks, scores momentum (compute_stock_score) and setup tradability (compute_trade_quality), builds levels via compute_trade_setup, then layers on a conviction blend, a directional gate (long-only; downtrends filtered out), and a generated rationale. ATR and average volume are backfilled from tradingview_screener because tradingview_ta omits them — without this the trade-setup engine produced no levels at all (this gap also silently affected the upstream EGX setup path). Stops are floored (≥0.5% swing / ≥0.6% intraday) so signals aren't stopped out by noise. Educational analysis only — not investment advice.

The egx_* tools are Egypt-specific and do not apply to India.

Refreshing the symbol lists

python scripts/refresh_india_symbols.py    # NSE/BSE liquid universe (coinlist/*.txt)
python scripts/refresh_india_indices.py    # Nifty 50 / Bank Nifty / Next 50 constituents (official NSE CSVs)

refresh_india_indices.py writes core/data/india_indices.json, which overrides the bundled constituent lists. Run it after an NSE index rebalance.

Run the MCP server

tradingview-mcp            # stdio transport (default)
tradingview-mcp streamable-http --host 127.0.0.1 --port 8000

Available Tools

27 tools
advanced_candle_patternC

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: exchange, base_timeframe, pattern_length, min_size_increase, +1 more.

backtest_strategyA

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 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, initial_capital, +5 more.

bollinger_scanA

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

Args: exchange: Exchange — crypto: KUCOIN, BINANCE, BYBIT, MEXC; stocks: EGX, BIST, NASDAQ, NYSE, BURSA, HKEX, SSE, SZSE timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M bbw_threshold: Maximum BBW value to filter (default 0.04) limit: Number of rows to return (max 100)

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

coin_analysisB

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

Args: symbol: Symbol — crypto: "BTCUSDT", "ETHUSDT"; stocks: "COMI" (EGX), "THYAO" (BIST), "600519" (SSE), "300251" (SZSE) exchange: Exchange — crypto: KUCOIN, BINANCE, MEXC; stocks: EGX, BIST, NASDAQ, NYSE, BURSA, HKEX, SSE, SZSE timeframe: Time interval (5m, 15m, 1h, 4h, 1D, 1W, 1M)

Returns: Detailed analysis with all indicators and metrics

Inputs: symbol (required), exchange, timeframe.

combined_analysisC

POWER TOOL: TradingView technical analysis + Reddit sentiment + Financial news.

Args: symbol: Asset symbol ("AAPL", "BTCUSDT", "THYAO") exchange: Exchange (NASDAQ, NYSE, BINANCE, KUCOIN, MEXC, BIST, EGX) timeframe: Analysis timeframe (5m, 15m, 1h, 4h, 1D, 1W)

Inputs: symbol (required), exchange, timeframe.

compare_strategiesA

Run all 6 strategies (RSI, Bollinger, MACD, EMA Cross, Supertrend, Donchian) and return a ranked leaderboard.

Args: symbol: Yahoo Finance symbol (AAPL, BTC-USD, SPY…) period: '1mo', '3mo', '6mo', '1y', '2y' initial_capital: Starting capital in USD (default $10,000) interval: '1d' (daily) or '1h' (hourly)

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

consecutive_candles_scanA

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: exchange, timeframe, pattern_type, candle_count, +2 more.

egx_fibonacci_retracementA

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_analysisC

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, timeframe, limit.

egx_market_overviewB

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: timeframe, limit.

egx_sector_scanB

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: sector, timeframe, limit.

egx_sector_scannerB

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_sectors, top_n_stocks, min_stock_score.

egx_stock_screenerA

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: timeframe, min_score, index_filter, limit.

egx_trade_planB

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_newsA

Real-time financial news from RSS feeds (Reuters, CoinDesk, etc.)

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

Inputs: symbol, category, limit.

market_sentimentA

Real-time Reddit sentiment analysis for stocks and crypto.

Args: symbol: Asset symbol ("AAPL", "BTC", "ETH", "TSLA") category: Subreddit group to search ("crypto", "stocks", "all") limit: Number of posts to analyse

Inputs: symbol (required), category, limit.

market_snapshotA

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

Inputs: no named parameters.

multi_agent_analysisA

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) exchange: Exchange — crypto: KUCOIN, BINANCE, MEXC; stocks: EGX, BIST, NASDAQ, NYSE, SSE, SZSE 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_analysisC

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

Args: symbol: Symbol — crypto: "BTCUSDT"; stocks: "COMI" (EGX), "THYAO" (BIST), "600519" (SSE), "300251" (SZSE) exchange: Exchange — crypto: KUCOIN, BINANCE, MEXC; stocks: EGX, BIST, NASDAQ, NYSE, SSE, SZSE

Inputs: symbol (required), exchange.

rating_filterB

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)

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

smart_volume_scannerA

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)

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

top_gainersB

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 timeframe: One of 5m, 15m, 1h, 4h, 1D, 1W, 1M limit: Number of rows to return (max 50)

Inputs: exchange, timeframe, limit. Returns: result

top_losersA

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

Inputs: exchange, timeframe, limit. Returns: result

volume_breakout_scannerA

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)

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

volume_confirmation_analysisC

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_strategyA

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 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, initial_capital, +5 more.

yahoo_priceB

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

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…

    TDQS

    B3.3/5.0

    Scored across 27 tools

    Disambiguation4/5

    Most tools have clear, distinct purposes, but there is some overlap among the multiple scanners (e.g., bollinger_scan, smart_volume_scanner, volume_breakout_scanner) and EGX-specific tools (e.g., egx_sector_scan vs. egx_sector_scanner). An agent might occasionally misselect between similar tools, but descriptions help differentiate.

    Naming Consistency4/5

    All tool names use lowercase with underscores, maintaining a consistent style. However, there is inconsistency in whether names start with a verb (e.g., backtest_strategy, compare_strategies) or a noun/adjective (e.g., advanced_candle_pattern, coin_analysis). This minor deviation prevents a perfect score.

    Tool Count4/5

    27 tools is on the higher end but appropriate for the broad domain of trading analysis covering technicals, scanning, backtesting, sentiment, and exchange-specific tools. The scope justifies the count, though a few tools could be consolidated.

    Completeness4/5

    The tool set covers a wide range of analysis and scanning capabilities, including multiple strategies and EGX-specific tools. Minor gaps exist, such as the lack of a direct historical data retrieval tool (beyond yahoo_price) and no RSI divergence scanner, but core workflows are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time Indian stock market analysis, including live price tracking, technical indicators, and options Greeks calculations for NSE/BSE securities. It also enables news-based sentiment analysis, market scanning for NIFTY 50 stocks, and virtual portfolio management.
      -
    • F
      license
      A
      quality
      D
      maintenance
      Enables real-time and historical Indian stock market data retrieval, including prices, news, recommendations, and top gainers/losers.
      11
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables NSE stock market research with screening, quotes, peer comparison, watchlists, alerts, and strategies using natural language.
      -
    • A
      license
      B
      quality
      C
      maintenance
      Comprehensive MCP server for Indian stock market with 60 tools covering NSE/BSE, derivatives, mutual funds, technicals, and more, requiring no API keys. Enables users to access live market data, analyze indicators, and manage investments through natural language.
      4
      60
      1
      MIT