🇮🇳 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)

NSE/BSE MCP Server