🇮🇳 NSE/BSE MCP Server

A Model Context Protocol (MCP) server for Indian stock market data — covering the National Stock Exchange (NSE) and Bombay Stock Exchange (BSE).

Plug this into Claude Desktop and ask questions like:

• "What is the current price and P/E of RELIANCE?"
• "Compare HDFCBANK, ICICIBANK, and SBIN on valuation metrics"
• "Show me RAIN Industries' 1-year historical data"
• "What is the NIFTY50 trading at today?"
• "Get the dividend history for ITC"
• "Who are the top institutional shareholders of TCS?"

No API key required. Powered by yfinance.

---

🛠️ Tools

Tool	Description
nse_bse_get_quote	Live price quote with valuation metrics (P/E, P/B, EPS, market cap)
nse_bse_get_historical	Historical OHLCV data with configurable period and interval
nse_bse_get_fundamentals	Deep fundamental analysis — revenue, margins, ROE, analyst targets
nse_bse_get_financials	Annual income statement, balance sheet & cash flow (last 4 years)
nse_bse_compare_stocks	Side-by-side comparison table for multiple stocks
nse_bse_get_index	Quote and performance for NIFTY50, SENSEX, and 13 other indices
nse_bse_list_indices	List all supported Indian market indices
nse_bse_get_dividends	Full dividend payout history
nse_bse_get_shareholders	Top institutional holders and ownership breakdown

---

🚀 Installation

Prerequisites

• Python 3.10+
• Claude Desktop (for local use)

Steps

# 1. Clone the repo
git clone https://github.com/vanshikaaa01/nse-bse-mcp.git
cd nse-bse-mcp

# 2. Install dependencies
pip install -r requirements.txt

Configure Claude Desktop

Find your Claude Desktop config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add this to your config (use full paths):

Windows:

{
  "mcpServers": {
    "nse-bse": {
      "command": "C:\\Python312\\python.exe",
      "args": ["C:\\full\\path\\to\\nse-bse-mcp\\server.py"]
    }
  }
}

macOS/Linux:

{
  "mcpServers": {
    "nse-bse": {
      "command": "python3",
      "args": ["/full/path/to/nse-bse-mcp/server.py"]
    }
  }
}

Then fully restart Claude Desktop (right-click tray icon → Quit, then reopen).

---

💡 Usage Examples

Get a live stock quote

"What is the current quote for RAIN Industries on NSE?"

Historical data

"Get me 1 year of daily OHLCV data for HDFCBANK on NSE"

Peer comparison

"Compare RELIANCE, ONGC, and BPCL on P/E, P/B, and ROE"

Index tracking

"What is NIFTYBANK at today? Show me the past month's performance"

Fundamental research

"Give me a full fundamental breakdown of Hindustan Zinc"

---

📊 Supported Indices

Index	Description
NIFTY50	NSE's flagship large-cap index
SENSEX	BSE's 30-stock benchmark
NIFTYBANK	Banking sector index
NIFTYMIDCAP	Midcap 50 index
NIFTYIT	IT sector index
NIFTYPHARMA	Pharma sector index
NIFTYFMCG	FMCG sector index
NIFTYAUTO	Automobile sector index
NIFTYREALTY	Real estate index
NIFTYMETAL	Metals sector index
NIFTYENERGY	Energy sector index
NIFTY100	Top 100 stocks
NIFTY200	Top 200 stocks
NIFTYNEXT50	Next 50 after Nifty50
INDIAVIX	India Volatility Index

---

📝 Notes

• Exchange suffixes: .NS for NSE, .BO for BSE (handled automatically)
• Data is delayed by ~15 minutes during market hours
• Financial data (income statement, balance sheet) is annual and may lag by 1–2 quarters
• For real-time tick data, a broker API (Zerodha Kite, AngelOne, etc.) is recommended

---

⚠️ Disclaimer

This tool is for educational and research purposes only. Data is sourced from Yahoo Finance and may contain errors or delays. This is not financial advice. Always verify data from official NSE/BSE sources before making investment decisions.

---

📄 License

MIT License — free to use, modify, and distribute.

---

🤝 Contributing

PRs welcome! Areas for contribution:

• Add support for F&O (futures & options) data
• Add options chain tool
• Add mutual fund NAV tracking
• Add screener integration (Screener.in)
• Add corporate actions (bonus, splits, rights)