NSE India MCP Server

Community

Unofficial National Stock Exchange of India (NSE) data MCP server with 30 tools for equities, indices, commodities, and more.

How to install ↓ Compare GitHub source repository ↗

Category: Other #187 of 230
Stars: ★ 289 Popular
Transport: stdio (local process)
Runtime: Node.js 18+
Credentials: No credential needed
License: MIT
Last commit: 4 months ago
Tools: 23

44FMRS · D

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.

Strongest · Setup experience 12/20 Weakest · Reliability 5/20

Reliability

5/20

Security and permissions

7/20

Maintenance

10/20

Documentation

10/20

Setup experience

12/20

Why each score

Reliability 5/20: The README documents a stdio MCP server with start/test scripts and 30 tools, but no source files, manifest, CI workflow, or committed tests covering key paths were supplied. The handshake and tool-list behavior cannot be confirmed. Heavy deduction is applied for missing execution evidence; the happy path is only plausible, not proven.
Security and permissions 7/20: From the README the service appears to make read-only requests to public NSE endpoints and no credentials are exposed, so no red-line issue is visible. However, without source it is impossible to verify the actual outbound scope, handling of any OpenAI key in the MCP client, or the absence of destructive operations; there is no explicit data-flow disclosure. The score reflects incomplete verification, not confirmed risk.
Maintenance 10/20: The repository is not archived and has an MIT license; the README indicates tests and CI badges. But no commit/release dates, dependency-update history, or security-response channel are present in the supplied material. Deducted for missing maintainability evidence; it looks active but is not fully verified.
Documentation 10/20: The README offers rich installation, MCP client configuration, and examples, plus API/CLI documentation. It lacks detailed per-tool parameter schemas, rate limits, troubleshooting guidance, and cost/data-usage notes; MCP_README.md is referenced but not supplied. Hence the docs are usable but incomplete.
Setup experience 12/20: Setup instructions are clear and include both npx and local-build JSON configs as well as Cursor IDE examples. However, the `npx stock-nse-india mcp` invocation and the generated build path cannot be verified from source, and no CI/test execution evidence was supplied. Setup is plausible and fairly simple but not fully trustworthy.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

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

Setup

Before you start

Runtime：Node.js 18+

NODE_ENV required Set to production in the recorded client config; specifies the runtime environment for the stdio MCP server.

Ensure Node.js 18+ is installed.
Install the package globally (optional but recommended): npm install -g stock-nse-india.
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"}
    }
  }
}

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"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "npx-stock-nse-india": {
      "command": "npx",
      "args": [
        "stock-nse-india",
        "mcp"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add npx-stock-nse-india -e NODE_ENV=production -- npx stock-nse-india mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

Configure the client with the npx config (npx stock-nse-india mcp), restart, and confirm tools such as getMarketStatus and getEquityDetails appear in the tool list; then ask "What is the current NSE market status?" to verify live data access.

Troubleshooting

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

Things to try

Once connected, you can ask your AI assistant things like:

What is the current price of TCS stock?
Get equity details for IRCTC.
Compare the historical performance of Reliance and TCS over the last month and analyze their trends.
What is the current NSE market status and today's top gainers and losers?

Tools 23

getAllStockSymbols read-only

Get all NSE stock symbols.

getEquityDetails read-only

Get detailed information for a specific equity (company name, industry, listing date, etc.).

getEquityHistoricalData read-only

Get historical price data for an equity.

getEquityIntradayData read-only

Get intraday trading data for an equity.

getEquityOptionChain read-only

Get option chain data for an equity.

getEquityCorporateInfo read-only

Get corporate information for an equity.

getEquityTradeInfo read-only

Get trade statistics (order book) for an equity.

getEquityChartHistoricalData read-only

Get charting OHLC historical data.

Show 15 more tools

getEquitySymbolInfo read-only

Resolve charting symbol/token (scripcode).

getEquityStockIndices read-only

Get all market indices.

getIndexIntradayData read-only

Get intraday data for an index.

getIndexOptionChain read-only

Get option chain data for an index.

getIndexOptionChainContractInfo read-only

Get option chain contract information (expiry dates and strike prices) for an index.

getCommodityOptionChain read-only

Get option chain data for commodities.

getGainersAndLosersByIndex read-only

Get top gainers and losers for an index.

getMostActiveEquities read-only

Get most actively traded equities.

getMarketStatus read-only

Get market status (open/closed).

getAllIndices read-only

Get data for all indices.

getPreOpenData read-only

Get pre-open data.

getMarketTurnover read-only

Get total market turnover.

getCirculars read-only

Get NSE circulars.

getDailyReport read-only

Get daily reports for capital/derivatives/debt markets.

getOptionChainContractInfo read-only

Get option chain contract information (generic).

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 Desktop

Cursor

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

Hevy MCP 77 · B

Manage your Hevy workout data from AI assistants via MCP.

★ 509 · Tools 26 Compare with this →

Firecrawl MCP Server 75 · B

Firecrawl's official MCP server for web search, scraping, and structured extraction for AI agents

★ 7.6k · Tools 11 Compare with this →

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 654 · Tools 11 Compare with this →

Compartment 75 · B

Encrypted, fully offline long-term memory for AI agents

★ 579 · Tools 14 Compare with this →

Compare with other MCP servers

Source revision e3d3e5eba815 Data synced 2026-10-12 Read the FMRS scoring method