india-stock-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-stock-mcp Get quote for Reliance Industries"
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-stock-mcp
MCP server for Indian stock market data — NSE/BSE quotes, historical prices, fundamentals, mutual fund NAV, indices, corporate actions, F&O option chains, IPOs, and portfolio analysis.
Works with any MCP client: Claude Desktop, Claude Code, Cursor, etc. No API keys, no auth, all free data sources.
Tools (16)
Tool | What it does |
| Live price, volume, 52-week range for NSE/BSE stocks and indices |
| OHLCV history — daily / weekly / monthly |
| Find stock symbols by company name |
| P/E, EPS, ROE, margins, debt, growth rates |
| 2–5 stocks side by side |
| Any NSE index (P/E, P/B, advances/declines) + SENSEX |
| Is the market open? Session info per segment |
| Top NIFTY 50 movers ranked by % change |
| Dividends, splits, bonuses — per stock or market-wide |
| F&O chain around ATM: LTP, OI, OI change, IV, volume |
| Current / upcoming / recently listed IPOs |
| Search 15,000+ Indian mutual fund schemes |
| NAV history for a scheme |
| Fund house, category, current NAV |
| 2–4 funds: NAV + % return over any period |
| Holdings → current value, P&L, allocation breakdown |
Related MCP server: Indian Market MCP
Requirements
Node.js 22+
Setup
Via npm (recommended)
No clone, no build:
Claude Code
claude mcp add india-stock -- npx -y india-stock-mcpClaude Desktop — add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):
{
"mcpServers": {
"india-stock": {
"command": "npx",
"args": ["-y", "india-stock-mcp"]
}
}
}From source
git clone https://github.com/Akhilgovind02/india-stock-mcp.git
cd india-stock-mcp
npm install
npm run build
claude mcp add india-stock -- node /absolute/path/to/india-stock-mcp/dist/index.jsRestart Claude Desktop fully, then look for the tools icon in a new chat.
Example prompts
"Quote for RELIANCE and how far is it from its 52-week high?"
"Compare HDFC Bank vs ICICI Bank vs SBI fundamentals"
"Top 5 NIFTY 50 gainers today"
"NIFTY option chain — where's the max open interest?"
"Compare Parag Parikh Flexi Cap vs Quant Small Cap over 3 years"
"Analyze my portfolio: 10 RELIANCE @ 1200, 5 TCS @ 3000"
Development
npm run dev # run from TypeScript directly
npx tsx scripts/test-mcp.ts # end-to-end test of all 16 tools (live data)
npx tsx scripts/test-edge.ts # 24 edge-case assertions
npm run build # compile to dist/Sample test output
Real output from npx tsx scripts/test-mcp.ts (live data, market hours, June 2026 — trimmed):
TOOLS: get_quote, get_historical, search_symbol, search_funds, get_fund_nav,
get_fundamentals, compare_stocks, get_index, get_market_status, get_gainers_losers,
get_corporate_actions, get_options_chain, get_ipo_list, get_fund_details,
compare_funds, portfolio_summary
PASS get_quote: {"source":"Yahoo Finance","symbol":"RELIANCE.NS","name":"RELIANCE
INDUSTRIES LTD","price":1266,"changePct":0.23,"volume":6107188,...}
PASS get_index: {"source":"NSE","index":"NIFTY BANK","last":55915,"percentChange":1.34,
"yearHigh":61764.85,"pe":...}
PASS get_market_status: [{"market":"Capital Market","marketStatus":"Open",...}]
PASS get_gainers_losers: {"type":"gainers","universe":"NIFTY 50","data":[{"symbol":
"SHRIRAMFIN","changePct":3.17,...}]}
PASS get_corporate_actions: {"symbol":"RELIANCE","actions":[{"subject":"Dividend -
Rs 5.5 Per Share","exDate":"14-Aug-2025",...}]}
PASS get_options_chain: {"symbol":"NIFTY","underlyingValue":23331,"atmStrike":23350,
"availableExpiries":["16-Jun-2026",...],"data":[{"strikePrice":...,"CE":{"lastPrice":
130.95,"openInterest":144769,"impliedVolatility":12.26},...}]}
PASS get_ipo_list: {"type":"current","ipos":[{"companyName":"Utkal Speciality
Industries India Limited","status":"Active",...}]}
PASS compare_funds: {"comparison":[{"name":"Parag Parikh Flexi Cap Fund - Direct
Plan - Growth","latestNAV":88.484,...}]}
PASS portfolio_summary: {"summary":{"totalInvested":41000,"totalCurrentValue":38663,
"totalPnL":-2337,"totalPnLPct":-5.7,...}}
... all 16 tools PASSData sources
Source | Used for | Notes |
Yahoo Finance ( | Quotes, history, fundamentals, search | Primary source, may be delayed a few minutes |
NSE India ( | Market status, indices, corporate actions, IPOs, option chains | Some NSE endpoints (quote, autocomplete) are no longer publicly accessible — the server falls back to Yahoo automatically |
Mutual fund NAV and search | Free, occasionally flaky — requests retry once | |
Fund ratings / expense ratio | Often unreachable; falls back to mfapi.in |
Known limitations
get_gainers_losersranks a built-in NIFTY 50 constituent list (verified June 2026). NSE reconstitutes the index ~2×/year — updateNIFTY50_SYMBOLSinsrc/index.tswhen that happens.Quotes may be delayed (Yahoo free feed); not suitable for live trading decisions.
NSE may rate-limit or block heavy usage.
Disclaimer
Data comes from free public sources and may be delayed, incomplete, or wrong. This is not financial advice and not a substitute for a licensed broker or advisor. Do your own research before trading or investing.
License
Available Tools
16 toolscompare_fundsA
Compare 2–4 mutual funds side by side: latest NAV and % return over the chosen period.
Inputs: scheme_codes (required), days.
compare_stocksA
Compare 2–5 stocks side by side: price, P/E, EPS, market cap, margins, growth rates.
Inputs: symbols (required).
get_corporate_actionsA
Get dividends, stock splits, bonus issues, and rights issues. Pass a symbol for one stock, or omit it for recent market-wide corporate actions.
Inputs: to, from, symbol.
get_fundamentalsA
Get fundamental financial data: P/E ratio, EPS, ROE, revenue, profit margins, debt, and more.
Inputs: symbol (required).
get_fund_detailsA
Get mutual fund details: fund house, category, current NAV. Includes Morningstar rating, expense ratio, and AUM when the rich data source is available.
Inputs: scheme_code (required).
get_gainers_losersA
Get top gainers or losers among NIFTY 50 stocks, ranked by % change (live Yahoo quotes).
Inputs: type (required), count.
get_historicalA
Get OHLCV historical price data for a stock. Returns date, open, high, low, close, volume.
Inputs: to (required), from (required), symbol (required), interval.
get_indexA
Get live data for a market index: price, change, P/E, P/B, year high/low, advances/declines. Available: NIFTY 50, NIFTY BANK, NIFTY IT, NIFTY MIDCAP 100, NIFTY SMALLCAP 100, NIFTY AUTO, NIFTY PHARMA, SENSEX, and all other NSE indices.
Inputs: index (required).
get_ipo_listA
Get list of current, upcoming, or recently listed (past 3 months) IPOs on NSE.
Inputs: type.
get_market_statusA
Check if NSE market is currently open or closed, and get trading session info.
Inputs: no named parameters.
get_options_chainA
Get F&O options chain for a stock or index: calls and puts around the ATM strike with last price, OI, OI change, IV, and volume. Works for NIFTY, BANKNIFTY, and F&O stocks like RELIANCE.
Inputs: symbol (required), expiry, strike_range.
get_quoteA
Get live price, volume, 52-week range, and basic stats for an NSE/BSE stock. Examples: RELIANCE, TCS, HDFCBANK, NIFTY 50 (index), ^NSEI (Nifty index code).
Inputs: symbol (required).
portfolio_summaryA
Analyze a stock portfolio. Pass holdings with buy price and quantity, get current value, P&L, allocation breakdown, and gain/loss per holding. Max 20 holdings.
Inputs: holdings (required).
search_fundsA
Search Indian mutual funds by name. Returns scheme codes and names for use with other fund tools.
Inputs: query (required).
search_symbolA
Search for a stock symbol by company name. Returns matching symbols with exchange info.
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 16 tools
Each tool targets a distinct domain or action: compare functions for stocks vs funds are separate; get_* tools for different data types (fundamentals, historical, quote, etc.); search tools for symbols and funds; portfolio summary is unique. No overlap.
Most tools follow a verb_noun pattern (get_, compare_, search_) in lowercase snake_case. 'portfolio_summary' is the exception as it starts with a noun, but it remains descriptive and fits the overall style. The inconsistency is minor.
With 16 tools covering stocks, mutual funds, indices, IPOs, market status, options, and portfolio analysis, the count is slightly high but well-justified for the breadth. It feels comprehensive without being excessive.
The tool set covers core data retrieval and analysis for stocks and mutual funds, including fundamentals, historical prices, comparisons, and portfolio summary. Missing areas like technical analysis or trading are likely out of scope. Minor gaps exist (e.g., no direct tool for stock screener), but overall it's thorough.
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.
Hosted MCP server for Indian market quotes, option-chain Greeks and multi-broker telemetry.
Stock analysis MCP: 38 indicators, 7 optimizers, 8 backtests, US + India sectors.
MCP server for real-time China A-share stock quotes, indices and market data.
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.6830 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
- FlicenseAqualityDmaintenanceMCP server for Indian stock market data — search companies, analyze fundamentals, compare stocks, browse sectors and screens.11-