nse-research-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NSE_RESEARCH_HOME | No | Override the default config directory (default: ~/.config/nse-research/) | |
| NSE_RESEARCH_CACHE | No | Override the default cache directory (default: ~/.cache/nse-research/) |
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 | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_stocksB | Find NSE symbols by company name or partial symbol (e.g. "tata motors", "hdfc", "INFY"). Returns symbol, name, ISIN, listing date, NSE industry and index membership (NIFTY 50/500 etc.). |
| screen_stocksA | Screen all NSE-listed stocks by fundamentals and price action (server-side, fast). Filters: market cap in ₹ crore, PE (ttm), PB, ROE %, dividend yield %, quarterly revenue growth %, EPS growth %, 52-week change %, price, 3-month average volume, Yahoo sector (one of: Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, Utilities) or industry. sort_by: market_cap | pe | dividend_yield | change_1d | change_52w | volume | price. limit ≤ 250. |
| get_company_profileA | Company overview for an NSE symbol: sector, industry (Yahoo and NSE classifications), market-cap bucket, index membership, business summary, employees, website, headline valuation. |
| get_stock_quoteA | Latest quote for an NSE symbol: price, change, day range, volume vs 3-month average, 52-week range and distance from it, 50/200-day averages, market cap, PE, PB, dividend yield. |
| get_price_historyA | Historical OHLCV plus computed stats. period: 1mo 3mo 6mo 1y 2y 5y 10y max (or 5d/1d for intraday
intervals). interval: 1d 1wk 1mo (intraday: 5m 15m 1h, max 60 days). Daily data also returns returns
over 1w/1m/3m/6m/1y, SMA20/50/200, RSI14, max drawdown and annualised volatility. |
| get_key_ratiosC | Valuation, profitability, growth, leverage, cash flow, per-share and ownership ratios for a stock. |
| get_financialsA | Financial statements in ₹ crore. statement: income | balance | cashflow | all. period: annual (last 4-5 fiscal years, FY ends 31 Mar) | quarterly (last 5 quarters). |
| get_shareholdingB | Promoter vs public shareholding trend from NSE filings (quarterly), plus Yahoo's insider/institution split. Rising promoter stake and falling pledge are usually read as positive. |
| get_corporate_actionsB | Dividends, bonus, splits, rights and buybacks with ex-dates and record dates (NSE), plus upcoming and recent board meetings (results dates etc.). |
| get_announcementsC | Latest corporate announcements filed with NSE (results, orders, resignations, investor presentations…) with subject, short text and PDF link. |
| get_analyst_viewB | Analyst consensus (buy/hold/sell), price targets with upside, recommendation trend over recent months, and past/upcoming earnings dates with EPS estimates and surprises. |
| compare_stocksA | Side-by-side key metrics for up to 15 NSE symbols: valuation (PE, PB, EV/EBITDA), ROE, margins, growth, leverage, dividend yield, 52-week performance and analyst consensus. |
| get_market_pulseA | One-call market snapshot: market status, key broad and sectoral indices with % change and index PE/PB, India VIX, sector leaders and laggards today, and the latest FII/DII cash flows. |
| get_index_performanceA | All NSE indices with last value, 1-day/30-day/1-year % change, PE, PB, dividend yield. group: all | broad | sectoral | thematic | strategy. |
| get_index_constituentsB | Constituent stocks of an NSE index with industry labels (from NSE's official lists). Supports NIFTY 50/NEXT 50/100/200/500, MIDCAP 50/100/150, SMALLCAP 100/250, MICROCAP 250 and sectoral indices (BANK, IT, AUTO, PHARMA, FMCG, METAL, REALTY, ENERGY, FINANCIAL SERVICES, HEALTHCARE, OIL & GAS…). |
| get_top_moversA | Today's top gainers or losers. index: NIFTY | BANKNIFTY | NIFTYNEXT50 | FNO (all F&O stocks) | ALL (all securities). direction: gainers | losers. |
| get_most_activeC | Most actively traded stocks today by traded value or volume (NSE). |
| get_52_week_breakoutsA | Stocks that hit a new 52-week high or low today (NSE). which: high | low. |
| get_fii_diiA | Latest day's FII/FPI and DII cash-market buy, sell and net flows in ₹ crore (NSE). |
| get_bulk_block_dealsB | Today's bulk deals, block deals and short-selling disclosures on NSE (who bought/sold what, at what price). |
| get_option_chainA | Option chain from NSE for an index (NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY) or an F&O stock. Returns spot, expiry list, put-call ratio (OI), max-pain strike, top OI strikes for calls (resistance) and puts (support), and a compact table of strikes around the money with OI, OI change, IV, LTP, volume. expiry format DD-Mon-YYYY (e.g. 29-Sep-2026); defaults to the nearest expiry. |
| get_market_holidaysA | NSE equity (capital market) trading holidays for the current year, upcoming ones first. |
| manage_watchlistA | Personal watchlist stored locally (~/.config/nse-research/watchlist.json). action: get (returns symbols with live quotes) | add | remove | clear. |
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 23 tools
Most tools are cleanly separated by data category: quotes, financials, indices, flows, options, etc. A few pairs like get_top_movers vs get_most_active or get_company_profile vs get_key_ratios could be momentarily confused, but the descriptions make the boundaries clear.
All tools follow a consistent snake_case action_object pattern: get_* for data retrieval, plus search_stocks, screen_stocks, compare_stocks, and manage_watchlist. Even get_52_week_breakouts fits predictably despite the numeric prefix.
At 23 tools, the set is on the heavy side, though each tool maps to a distinct NSE research need and no tool feels redundant. The breadth is coherent for a full research server, but the count is high enough that an agent may have to scan many options before selecting the right one.
The server covers the NSE research lifecycle well: discovery, screening, quotes and history, fundamentals, corporate actions, market breadth, index/options data, and watchlists. Minor gaps exist, such as limited historical bulk-deal data and no futures data, but core equity research workflows have no dead ends.