RELATED 01
Stock SDK
Market data for China A-shares, Hong Kong and US stocks, funds, futures and options over MCP
2.0kGitHub stars
1.9k/wknpm downloads
73popularity score
stock-nse-india
Market data from the National Stock Exchange of India: quotes, history, option chains and reports
By Hi! ImCodeMan TypeScript Local · stdio Finance and paymentsData and analytics
55 popularity score ★ 293 ↓ 546/wk
Connect your client
Local (npm)
Add in one click
Opens the app, which asks before it adds the server.
Or add it by command or config
Claude CodeTerminal
claude mcp add stock-nse-india -- npx -y stock-nse-india mcpClaude Desktopclaude_desktop_config.json
{
"mcpServers": {
"stock-nse-india": {
"command": "npx",
"args": [
"-y",
"stock-nse-india",
"mcp"
]
}
}
}Cursor~/.cursor/mcp.json
{
"mcpServers": {
"stock-nse-india": {
"command": "npx",
"args": [
"-y",
"stock-nse-india",
"mcp"
]
}
}
}VS Code.vscode/mcp.json
{
"servers": {
"stock-nse-india": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"stock-nse-india",
"mcp"
]
}
}
}Codex~/.codex/config.toml
[mcp_servers.stock-nse-india]
command = "npx"
args = ["-y", "stock-nse-india", "mcp"]Gemini CLITerminal
gemini mcp add --scope user stock-nse-india npx -- -y stock-nse-india mcpSettings 1
NODE_ENV |
Optional: Set to production in the README's example config; not needed for the server to run. |
|---|
What it does
stock-nse-india is an unofficial Node.js package that pulls equity, index, derivatives and market-wide data from the public website of the National Stock Exchange of India (NSE). Besides its library, REST/GraphQL API server and command line tool, the package ships a stdio MCP server, started with the `mcp` subcommand of its `nseindia` program.
Through the server an assistant can look up the list of listed symbols, a stock's price, trade and corporate details, intraday and historical prices, index data, option chains for indices, equities and commodities, market status, turnover and pre-open data, NSE circulars and merged daily reports, trading and clearing holidays, top gainers and losers and the most active stocks. One tool computes technical indicators (SMA, EMA, RSI, Bollinger Bands) on the fly, by default over 200 days of history with a 14-day RSI and a 20-day band; two others read OHLC candles from NSE's charting service, at 5-minute intraday intervals unless asked for daily bars or another interval.
The README counts 30 tools, but the tool file at version 1.4.0 (src/mcp/mcp-tools.ts) registers 32: the two charting tools, get_equity_chart_historical_data and get_equity_chart_symbol_info, are not in that count. Every tool only reads; nothing places orders or touches a trading account.
What it needs
| Runtime | Node.js 18+ |
|---|
Node.js with npx. The README asks for Node.js 18 or later, but package.json at version 1.4.0 declares "engines": node >=20, so Node.js 20+ is the safe choice. Network access to nseindia.com and charting.nseindia.com. No NSE account or API key is needed.
Limits
Unofficial: it reads NSE's public website rather than a supported API, so tools can break when NSE changes its pages or blocks the requests. Covers NSE India only (no BSE or other exchanges) and only reads data; it cannot trade. The README's own config runs `npx stock-nse-india mcp` without `-y`; the command here adds it so npx does not wait for an install prompt. At startup the `mcp` command (src/cli/index.ts) prints status lines with console.log to standard output before the protocol starts, which a strict client may report as invalid messages.
Who it suits
Suits developers, traders and analysts who want an assistant to look up Indian stock, index and option-chain data, or run quick indicator checks, without an account or key. It runs locally and only reads public data. Pick something else if you need an exchange-supported or licensed data feed with uptime guarantees, data from markets outside NSE, or a server that can place orders through a broker.
Tools 32
get_all_stock_symbols- List every equity symbol listed on NSE
get_equity_details- Price and basic details for one stock
get_equity_trade_info- Trade information such as volume and delivery for one stock
get_equity_corporate_info- Corporate details and announcements for one stock
get_equity_intraday_data- Intraday price data for one stock
get_equity_historical_data- Daily price history for one stock over a date range
get_equity_series- Series in which a stock trades
get_equity_stock_indices- Constituents and data of an equity index
get_index_intraday_data- Intraday data for an index
get_index_option_chain- Option chain for an index
get_index_option_chain_contract_info- Expiry dates and strikes available for an index's options
get_equity_option_chain- Option chain for a stock
get_commodity_option_chain- Option chain for a commodity
get_glossary- NSE glossary of market terms
get_trading_holidays- Exchange trading holidays
get_clearing_holidays- Exchange clearing holidays
get_market_status- Whether each market segment is open or closed
get_market_turnover- Market turnover figures
get_all_indices- Current values of all NSE indices
get_index_names- Names of NSE indices
get_circulars- NSE circulars
get_latest_circulars- Most recent NSE circulars
get_equity_master- Master list of equities by category
get_pre_open_market_data- Pre-open session data
get_merged_daily_reports_capital- Daily reports for the capital market
get_merged_daily_reports_derivatives- Daily reports for the derivatives market
get_merged_daily_reports_debt- Daily reports for the debt market
get_equity_technical_indicators- SMA, EMA, RSI and Bollinger Bands computed for one stock
get_gainers_and_losers_by_index- Top gainers and losers within an index
get_most_active_equities- Most actively traded stocks
get_equity_chart_historical_data- OHLC candles from NSE's charting service, intraday or daily
get_equity_chart_symbol_info- Look up the charting token a symbol needs for candle data