← Back to directory
N

NSE India MCP Server

Community
Unofficial National Stock Exchange of India (NSE) data MCP server with 30 tools for equities, indices, commodities, and more.
GitHub source repository ↗
★ 288 Stars Category · Other Popular Source revision e3d3e5eba815
44FMRS · D
Reliability
5/20
Security and permissions
7/20
Maintenance
10/20
Documentation
10/20
Setup experience
12/20

This is a feature-rich unofficial NSE data MCP server with many tools. Setup is simple via npx. Suitable for quick integration into AI assistants, but be aware of unofficial status and data reliability risks.

Read the FMRS scoring method →

stock-nse-india is an MCP server for the unofficial NSE India API, allowing AI assistants to access real-time and historical data of the National Stock Exchange of India through a standardized tool interface. It offers a wide range of tools covering equity details, historical data, intraday data, technical indicators, index information, option chains, market status, reports, and commodity data. The server communicates via stdio and can be quickly launched via npx. The project also provides REST and GraphQL APIs, but the MCP server focuses on core data access.

Tools

getAllStockSymbols
Get all NSE stock symbols.
getEquityDetails
Get detailed information for a specific equity (company name, industry, listing date, etc.).
getEquityHistoricalData
Get historical price data for an equity.
getEquityIntradayData
Get intraday trading data for an equity.
getEquityOptionChain
Get option chain data for an equity.
getEquityCorporateInfo
Get corporate information for an equity.
getEquityTradeInfo
Get trade statistics (order book) for an equity.
getEquityChartHistoricalData
Get charting OHLC historical data.
getEquitySymbolInfo
Resolve charting symbol/token (scripcode).
getEquityStockIndices
Get all market indices.
getIndexIntradayData
Get intraday data for an index.
getIndexOptionChain
Get option chain data for an index.
getIndexOptionChainContractInfo
Get option chain contract information (expiry dates and strike prices) for an index.
getCommodityOptionChain
Get option chain data for commodities.
getGainersAndLosersByIndex
Get top gainers and losers for an index.
getMostActiveEquities
Get most actively traded equities.
getMarketStatus
Get market status (open/closed).
getAllIndices
Get data for all indices.
getPreOpenData
Get pre-open data.
getMarketTurnover
Get total market turnover.
getCirculars
Get NSE circulars.
getDailyReport
Get daily reports for capital/derivatives/debt markets.
getOptionChainContractInfo
Get option chain contract information (generic).

Setup

  1. Ensure Node.js 18+ is installed.
  2. Install the package globally (optional but recommended): npm install -g stock-nse-india.
  3. Add the following JSON to your MCP client (e.g., Claude Desktop or Cursor) configuration:
{
  "mcpServers": {
    "npx-stock-nse-india": {
      "command": "npx",
      "args": ["stock-nse-india", "mcp"],
      "env": {"NODE_ENV": "production"}
    }
  }
}
  1. Restart the client to load the server.
claude_desktop_config.json
{
  "mcpServers": {
    "npx-stock-nse-india": {
      "command": "npx",
      "args": [
        "stock-nse-india",
        "mcp"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Fit and risk

Best for

  • Stock market enthusiasts
  • Developers building financial tools
  • AI applications needing quick access to NSE data

Not for

  • Users requiring official endorsement or licensed NSE data
  • Users needing low-latency trading data
  • Production environments with high stability requirements where unofficial APIs are risky

Required permissions

  • Network access to scrape data from NSE website
  • May read environment variables (e.g., NODE_ENV)
  • Communicates via stdio; no special system permissions needed

Risks and side effects

  • Unofficial API that NSE can change at any time causing breakage
  • Data may be unvalidated and subject to delays or errors
  • Reliance on public endpoints which may be rate-limited or IP-blocked
  • Toolset could change without notice by maintainers

Troubleshooting

  1. Ensure Node.js version >= 18
  2. Check network connectivity to nseindia.com
  3. If using npx, verify the package is correctly published and cached
  4. Inspect server startup logs for errors

Use cases

Get real-time stock quotes and details
Analyze historical price trends
Query index performance and market status
Retrieve option chains and contract information
Build stock market analysis tools or AI assistants

Supported clients

Claude DesktopFull support
CursorFull support