NSE-MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NSE_MCP_UA | No | Override the User-Agent sent to NSE and Yahoo Finance. Useful if NSE starts blocking the default UA. | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_bulk_dealsA | Fetch today's NSE bulk deals — trades where a single client buys or sells ≥0.5% of a company's listed shares in one session. Returns the buyer/seller, quantity, and weighted-average price. |
| get_block_dealsB | Fetch today's NSE block deals — large negotiated trades (minimum ₹10 crore) executed in the Block Deal Window. Shows counterparty, quantity, and trade price. |
| get_insider_tradingA | Fetch SEBI PIT (Prohibition of Insider Trading) disclosures — promoter and insider buy/sell transactions reported to the exchanges. Shows acquirer name, category, shares before/after, and mode of acquisition. |
| get_latest_bulk_dealsA | Convenience wrapper — returns today's bulk deals sorted by trade value, optionally filtered by direction. |
| get_top_bulk_buysA | Today's largest bulk-deal purchases ranked by total trade value (quantity × price). Useful for spotting institutional accumulation. |
| get_top_bulk_sellsA | Today's largest bulk-deal sales ranked by total trade value. Useful for spotting institutional distribution. |
| get_fii_dii_activityA | Daily FII (Foreign Institutional Investor) and DII (Domestic Institutional Investor) net buy/sell figures in the Indian cash market. Key macro signal for market direction. |
| get_nse_announcementsB | Corporate announcements filed with NSE — board meetings, results, dividends, mergers, regulatory updates, etc. Equivalent to 8-K filings on SEC EDGAR. |
| get_market_statusA | Current NSE market status — whether Capital Market, F&O, Currency Derivatives, and Commodity segments are open or closed, plus live index levels. |
| get_nifty_indicesA | Live data for all NSE indices (Nifty 50, Nifty Bank, Nifty IT, Nifty Midcap 150, etc.) — price, change, 52-week range, advances/declines. |
| get_top_gainersA | Top gaining NSE stocks by percentage change for the current session within a given index. |
| get_top_losersB | Top losing NSE stocks by percentage change for the current session within a given index. |
| get_most_activeA | Most actively traded NSE stocks by total traded value (₹) in the current session. |
| search_by_symbolA | Aggregate view for a single NSE stock — returns today's bulk deals, block deals, recent insider trades, and recent announcements in one call. |
| get_quoteA | Live stock quote from Yahoo Finance for any NSE-listed stock. Includes price, 52-week range, volume, market cap, P/E ratios, dividend yield, and next earnings date. Prices are in INR. |
| get_short_sellingA | NSE short-selling data — quantity of shares sold short and second-leg (covering) quantities, as reported by brokers under SEBI's short-selling framework. |
| get_corporate_actionsA | Upcoming and recent corporate actions — dividends, stock splits, bonus issues, rights issues, and buy-backs. Shows ex-date, record date, and payment date. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Tools are mostly distinct, covering different data types (quotes, indices, deals, insider trading, etc.). However, the multiple bulk-deal tools (get_bulk_deals, get_latest_bulk_deals, get_top_bulk_buys, get_top_bulk_sells) could cause confusion as they overlap in purpose but differ in sorting/filtering.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., get_quote, search_by_symbol, get_top_gainers). There is no mixing of conventions or ambiguous naming.
With 17 tools, the count is slightly above the typical well-scoped range, but each tool serves a clear purpose covering a breadth of NSE data. A few could be consolidated (e.g., the bulk-deal variants), but overall it's reasonable for the domain.
The tool set covers many essential NSE data points: quotes, indices, market status, top movers, bulk/block deals, insider trading, FII/DII activity, short selling, announcements, and corporate actions. Missing historical data and fundamental analysis, but the core real-time and regulatory data is well covered.