India Market MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@India Market MCP Show me the live Nifty 50 index value"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.serverDevelopment / Testing
mcp dev src/server.pyTool List
Stocks
get_stock_quote— Live quote with price, volume, P/E, 52-week rangesearch_stocks— Search NSE by name or symbolget_stock_history— Historical OHLCV data (1d/1wk/1mo intervals)get_top_gainers_losers— NSE top movers with % changeget_52_week_high_low— Stocks near 52-week extremesget_corporate_actions— Dividends, splits, bonusesget_stock_financials— Revenue, profit, margins, balance sheetget_stock_peers— Compare against sector peersget_market_cap_ranking— Rank stocks by market capget_stock_returns— 1M, 3M, 6M, 1Y, 3Y, 5Y returnsget_delivery_volume— Delivery vs intraday volume analysis
Derivatives
get_option_chain— Full option chain for any F&O symbolget_expiry_dates— Available expiry datesget_spot_price— Current underlying pricecalculate_greeks— Black-Scholes Greeks calculatorcalculate_iv— Implied volatility from market priceget_max_pain— Max pain strike priceget_pcr— Put-Call Ratio by OI and volumeget_oi_analysis— Open interest build-up / unwindingget_top_oi_gainers— Largest OI change strikesbuild_strategy— Iron condor, straddle, strangle, butterfly, spreadcalculate_margin— Expected margin for F&O positionsget_option_premium— Theoretical premium from Black-Scholesget_atm_straddle_premium— ATM straddle premium and IVget_itm_otm_options— Classify strikes as ITM/ATM/OTMcalculate_position_size— Kelly Criterion / risk-based sizing
Indices
get_all_indices— All NSE indices with live valuesget_index_constituents— All stocks in an index with pricesget_sector_performance— Sectoral indices ranked by performance
Mutual Funds
search_mutual_funds— Search 47,000+ AMFI schemesget_mf_nav— Latest NAVget_mf_history— Full NAV historyget_mf_details— Fund house, category, AUM, expense ratiocompare_mf— Side-by-side comparison of 2–4 fundsanalyze_mf— Risk metrics, alpha, Sharpe, Sortinocalculate_sip— SIP future value calculatorcalculate_xirr— XIRR from irregular cashflows
Market
get_market_status— Is NSE open/closed/pre-marketget_fii_dii_data— Foreign & domestic institutional flowsget_advances_declines— Market breadthget_upcoming_ipos— Current & upcoming IPOsget_past_ipos— Recently listed IPO performanceget_market_announcements— NSE announcements & circularsget_top_market_news— Market news headlinesget_block_deals— Block deal activityget_bulk_deals— Bulk deal activityget_dividend_calendar— Upcoming ex-dividend datesget_market_holidays— NSE trading holidays
Technicals
get_technical_indicators— SMA, EMA, RSI, MACD, Bollinger Bandsget_support_resistance— Pivot point S/R levelsdetect_candlestick_patterns— Doji, hammer, engulfing, etc.
Additional
get_all_etfs— NSE ETFs with live pricesget_etf_quote— Detailed ETF quoteget_commodity_price— Gold, Silver, Crude, Natural Gasget_all_commodity_prices— All commodities at onceget_currency_rate— USD/INR, EUR/INR, GBP/INR, JPY/INRget_all_currency_rates— All major pairsget_sgb_prices— Sovereign Gold Bond live pricesget_stock_screener— Multi-criteria stock screeningget_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 toolsanalyze_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_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
Scored across 60 tools
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.
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.
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.
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
Related MCP Connectors
Hosted MCP server for Indian NSE/BSE stock research: 59 tools for quotes, financials and ratios, peers, shareholding and pledge, filings with extracted facts, screens, F&O and FII/DII context. Source and freshness on every answer; no buy/sell calls.
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
MCP server for Financial Modeling Prep API with 250+ financial data tools
Research-only MCP server: your AI as a quant research desk. 90 tools, no trades, no brokers.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn 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.2MIT
- AlicenseBqualityDmaintenanceA comprehensive MCP server for the Indian stock market, providing 68 tools for stocks, derivatives, mutual funds, commodities, and more without any API keys.6822 PyPI6MIT
- AlicenseNot gradedqualityDmaintenanceMCP 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
- AlicenseNot gradedqualityDmaintenancePublic 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.1MIT