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

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