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

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