Skip to main content
Glama
India Market MCP

India Market MCP

by icharshal

India Market MCP

Comprehensive MCP server for the Indian stock market — 60 tools covering NSE/BSE, F&O, Mutual Funds, Technicals, ETFs, Commodities, Currencies, Screeners, and more.

Built by combining the best features from 5 open-source Indian market MCP servers. No API keys required.

Features

Module

Tools

What It Covers

Stocks

11

Live quotes, history, financials, peers, corporate actions, peers

Derivatives

15

Option chain, Greeks, max pain, PCR, OI analysis, strategies, margin

Indices

3

All NSE indices, constituents, sector performance

Mutual Funds

8

47,000+ AMFI schemes, NAV history, comparison, SIP/XIRR calculators

Market

11

FII/DII, IPOs, market breadth, block/bulk deals, dividends, holidays

Technicals

3

SMA, EMA, RSI, MACD, Bollinger Bands, support/resistance, candlestick

Additional

9

ETFs, commodities, currencies, sovereign gold bonds, stock screener

Related MCP server: Indian Market MCP

Install

cd india-market-mcp
pip install -e .

Usage

With Claude Desktop / opencode (stdio)

Add to your MCP config:

{
  "mcpServers": {
    "india-market": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "D:\\Default Project\\nse-mcp-servers\\india-market-mcp"
    }
  }
}

With opencode (CLI)

opencode mcp add india-market -- python -m src.server

Development / Testing

mcp dev src/server.py

Tool List

Stocks

  • get_stock_quote — Live quote with price, volume, P/E, 52-week range

  • search_stocks — Search NSE by name or symbol

  • get_stock_history — Historical OHLCV data (1d/1wk/1mo intervals)

  • get_top_gainers_losers — NSE top movers with % change

  • get_52_week_high_low — Stocks near 52-week extremes

  • get_corporate_actions — Dividends, splits, bonuses

  • get_stock_financials — Revenue, profit, margins, balance sheet

  • get_stock_peers — Compare against sector peers

  • get_market_cap_ranking — Rank stocks by market cap

  • get_stock_returns — 1M, 3M, 6M, 1Y, 3Y, 5Y returns

  • get_delivery_volume — Delivery vs intraday volume analysis

Derivatives

  • get_option_chain — Full option chain for any F&O symbol

  • get_expiry_dates — Available expiry dates

  • get_spot_price — Current underlying price

  • calculate_greeks — Black-Scholes Greeks calculator

  • calculate_iv — Implied volatility from market price

  • get_max_pain — Max pain strike price

  • get_pcr — Put-Call Ratio by OI and volume

  • get_oi_analysis — Open interest build-up / unwinding

  • get_top_oi_gainers — Largest OI change strikes

  • build_strategy — Iron condor, straddle, strangle, butterfly, spread

  • calculate_margin — Expected margin for F&O positions

  • get_option_premium — Theoretical premium from Black-Scholes

  • get_atm_straddle_premium — ATM straddle premium and IV

  • get_itm_otm_options — Classify strikes as ITM/ATM/OTM

  • calculate_position_size — Kelly Criterion / risk-based sizing

Indices

  • get_all_indices — All NSE indices with live values

  • get_index_constituents — All stocks in an index with prices

  • get_sector_performance — Sectoral indices ranked by performance

Mutual Funds

  • search_mutual_funds — Search 47,000+ AMFI schemes

  • get_mf_nav — Latest NAV

  • get_mf_history — Full NAV history

  • get_mf_details — Fund house, category, AUM, expense ratio

  • compare_mf — Side-by-side comparison of 2–4 funds

  • analyze_mf — Risk metrics, alpha, Sharpe, Sortino

  • calculate_sip — SIP future value calculator

  • calculate_xirr — XIRR from irregular cashflows

Market

  • get_market_status — Is NSE open/closed/pre-market

  • get_fii_dii_data — Foreign & domestic institutional flows

  • get_advances_declines — Market breadth

  • get_upcoming_ipos — Current & upcoming IPOs

  • get_past_ipos — Recently listed IPO performance

  • get_market_announcements — NSE announcements & circulars

  • get_top_market_news — Market news headlines

  • get_block_deals — Block deal activity

  • get_bulk_deals — Bulk deal activity

  • get_dividend_calendar — Upcoming ex-dividend dates

  • get_market_holidays — NSE trading holidays

Technicals

  • get_technical_indicators — SMA, EMA, RSI, MACD, Bollinger Bands

  • get_support_resistance — Pivot point S/R levels

  • detect_candlestick_patterns — Doji, hammer, engulfing, etc.

Additional

  • get_all_etfs — NSE ETFs with live prices

  • get_etf_quote — Detailed ETF quote

  • get_commodity_price — Gold, Silver, Crude, Natural Gas

  • get_all_commodity_prices — All commodities at once

  • get_currency_rate — USD/INR, EUR/INR, GBP/INR, JPY/INR

  • get_all_currency_rates — All major pairs

  • get_sgb_prices — Sovereign Gold Bond live prices

  • get_stock_screener — Multi-criteria stock screening

  • get_sector_stocks — All stocks in a sector

Data Sources

  • NSE India — Live market data, option chains, IPOs, FII/DII, announcements

  • Yahoo Finance — International data, technical indicators, commodities, currencies

  • AMFI — 47,000+ mutual fund schemes and NAV history

Caching

Results are cached to disk (.cache/india-market-mcp/) with TTLs ranging from 30s (live data) to 1h (static data). Cache size limit: 500MB.

Rate Limiting

NSE API calls are rate-limited to 1 request every 350ms with automatic retry on 401/403 responses and session re-initialization.

License

MIT

Available Tools

60 tools
analyze_mutual_fundB

Deep mutual fund analysis — returns, Sharpe ratio, max drawdown.

Inputs: scheme_code (required).

build_strategyC

Build an options strategy with real market prices. Strategy: iron_condor, bull_call_spread, etc.

Inputs: expiry (required), symbol (required), strategy (required), strikes.

calculate_greeksB

Calculate option Greeks (Delta, Gamma, Theta, Vega, Rho) using Black-Scholes. T = time in years to expiry.

Inputs: K (required), S (required), T (required), r, +2 more.

calculate_ivC

Calculate Implied Volatility from market price using Newton-Raphson.

Inputs: K (required), S (required), T (required), market_price (required), +2 more.

calculate_max_painC

Calculate Max Pain strike price for an option chain.

Inputs: symbol (required), expiry.

calculate_option_priceC

Calculate theoretical option price using Black-Scholes model.

Inputs: K (required), S (required), T (required), r, +2 more.

calculate_sip_returnsC

Calculate SIP maturity value and total investment.

Inputs: years (required), monthly_amount (required), annual_return_pct (required).

calculate_xirrC

Calculate XIRR for irregular cash flows. Cashflows: [{"date": "YYYY-MM-DD", "amount": 5000}]

Inputs: cashflows (required).

compare_mutual_fundsB

Compare 2-4 mutual funds side by side.

Inputs: scheme_codes (required).

detect_candlestick_patternsC

Detect candlestick patterns — Doji, Hammer, Engulfing, etc.

Inputs: symbol (required).

estimate_marginC

Estimate SPAN + Exposure margin for option strategies.

Inputs: strategy (required), lots.

get_52week_highA

Get stocks at 52-week high on NSE.

Inputs: no named parameters.

get_52week_lowB

Get stocks at 52-week low on NSE.

Inputs: no named parameters.

get_advances_declinesA

Get market breadth — advances vs declines.

Inputs: no named parameters.

get_all_commodity_pricesA

Get prices for major commodities — Gold, Silver, Crude Oil, Natural Gas.

Inputs: no named parameters.

get_all_currency_ratesA

Get all major INR exchange rates.

Inputs: no named parameters.

get_all_etfsA

Get all NSE ETFs with current prices.

Inputs: no named parameters.

get_all_indicesA

Get all NSE indices with current values.

Inputs: no named parameters.

get_block_dealsA

Get recent block deals on NSE (trades >= 10 crore).

Inputs: no named parameters.

get_board_meetingsC

Get upcoming board meeting dates for corporate actions.

Inputs: no named parameters.

get_bulk_dealsA

Get recent bulk deals on NSE.

Inputs: no named parameters.

get_commodity_priceB

Get commodity price (Gold: GC=F, Silver: SI=F, Crude: CL=F).

Inputs: commodity.

get_company_financialsB

Get company financials — income statement, balance sheet, key ratios.

Inputs: symbol (required).

get_corporate_actionsC

Get corporate actions (dividends, splits, bonuses) for a stock.

Inputs: symbol (required).

get_currency_rateB

Get currency exchange rate (USDINR=X, EURINR=X, GBPINR=X).

Inputs: pair.

get_equity_scheme_performanceA

Get equity mutual fund performance (1Y, 3Y, 5Y returns).

Inputs: no named parameters.

get_etf_quoteC

Get detailed ETF quote.

Inputs: symbol (required).

get_expiry_datesC

Get available expiry dates for an F&O symbol.

Inputs: symbol (required).

get_fii_dii_dataA

Get FII (Foreign Institutional Investors) and DII (Domestic Institutional Investors) buy/sell data.

Inputs: no named parameters.

get_futures_dataB

Get futures data — lot size, expiry, OI, price.

Inputs: symbol (required).

get_index_constituentsC

Get all stocks in an index with live prices.

Inputs: index.

get_market_holidaysA

Get NSE market holidays for the current year.

Inputs: no named parameters.

get_market_newsC

Get latest Indian market news from Google News.

Inputs: count.

get_market_statusA

Check if NSE market is currently open, closed, or pre-market.

Inputs: no named parameters.

get_mf_historyC

Get full historical NAV for a mutual fund scheme.

Inputs: scheme_code (required).

get_mf_navC

Get latest NAV for a mutual fund scheme.

Inputs: scheme_code (required).

get_most_activeB

Get most traded stocks on NSE by volume.

Inputs: count.

get_nse_announcementsB

Get latest corporate announcements from NSE.

Inputs: no named parameters.

get_oi_dataC

Get open interest data across expiries for an F&O symbol.

Inputs: symbol (required).

get_option_chainB

Get full option chain for NSE F&O symbol. Expiry format: DD-Mon-YYYY

Inputs: symbol (required), expiry.

get_past_iposA

Get recently listed IPOs and their performance.

Inputs: no named parameters.

get_pcrC

Get Put-Call Ratio (OI-based and Volume-based) with interpretation.

Inputs: symbol (required).

get_peer_comparisonC

Compare a stock with its industry peers.

Inputs: symbol (required).

get_sector_performanceC

Get sectoral indices ranked by performance.

Inputs: no named parameters.

get_sovereign_gold_bondsA

Get all Sovereign Gold Bonds listed on NSE.

Inputs: no named parameters.

get_spot_priceB

Get current spot/underlying price for any F&O symbol.

Inputs: symbol (required).

get_stock_historyA

Get historical OHLCV data. Period: 1d,5d,1mo,3mo,6mo,1y,2y,5y,max

Inputs: symbol (required), period.

get_stock_quoteB

Get live stock quote with price, volume, 52-week range, P/E, market cap.

Inputs: symbol (required).

get_support_resistanceC

Get support and resistance levels using pivot points.

Inputs: symbol (required).

get_technical_indicatorsB

Get technical indicators — SMA, EMA, RSI, MACD, Bollinger Bands for a stock.

Inputs: symbol (required).

get_top_gainersC

Get top gaining stocks on NSE.

Inputs: count.

get_top_losersC

Get top losing stocks on NSE.

Inputs: count.

get_upcoming_iposA

Get upcoming and ongoing IPOs on NSE.

Inputs: no named parameters.

list_strategiesB

List all available option strategies by category.

Inputs: no named parameters.

market_overviewA

Get NIFTY & BANKNIFTY snapshot — spot, ATM IV, PCR, lot size.

Inputs: no named parameters.

position_sizingC

Calculate optimal position size based on capital and risk tolerance.

Inputs: capital (required), risk_pct, stop_loss, entry_price.

screen_by_fundamentalsC

Screen stocks by fundamental ratios — P/E, ROE, market cap.

Inputs: max_pe, min_pe, min_roe.

screen_stocksB

Screen stocks by price, volume, and sector filters.

Inputs: sector, max_price, min_price, min_volume.

search_mutual_fundsA

Search mutual funds by name across 47,000+ AMFI schemes.

Inputs: query (required).

search_stocksB

Search for stocks by name or symbol on NSE.

Inputs: query (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 60 tools

    Disambiguation5/5

    Each tool targets a distinct piece of data or calculation within Indian markets. There's no overlapping purpose; even similar tools like get_top_gainers and get_top_losers are clearly differentiated by their names and descriptions.

    Naming Consistency4/5

    Most tool names follow a clear verb_noun pattern in lowercase snake_case, but a few exceptions like 'market_overview' and 'position_sizing' break the pattern by starting with a noun. Overall, the style is consistent and predictable.

    Tool Count2/5

    With 60 tools, the count is too high for optimal coherence. While the domain is broad, many tools could be merged into parameterized versions (e.g., different top lists or calculation helpers). This number exceeds the 'well-scoped' guideline significantly.

    Completeness5/5

    The tool set covers an extremely wide range of Indian market data: stocks, indices, mutual funds, options, futures, commodities, currencies, IPOs, corporate actions, technical analysis, and market news. There are no obvious gaps for a read-only data server.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides comprehensive Indian stock market data from the NSE and BSE, including live quotes, historical trends, and fundamental analysis. Users can compare stock performance, track major indices, and access financial statements without the need for an API key.
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A comprehensive MCP server for the Indian stock market, providing 68 tools for stocks, derivatives, mutual funds, commodities, and more without any API keys.
      68
      22 PyPI
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server providing real-time Indian stock market data through 15 tools, including stock details, historical data, market overview, and news. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and other MCP clients using an API key from IndianAPI.in.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Public MCP server for Indian stock market analysis covering Nifty 500 stocks with 12 tools (quotes, technical indicators, patterns, screening) across daily, 15-minute, and 5-minute timeframes.
      1
      MIT