Search Moneycontrol for a stock or index and resolve its identifiers.

Use this FIRST to obtain a stock's sc_id (needed by moneycontrol_get_quote, moneycontrol_get_fundamentals, moneycontrol_get_technicals) or to discover an index name accepted by moneycontrol_get_index.

Args: params (SearchInput): - query (str): Name to search. - kind (str): 'stock' (default) or 'index'. - limit (int): Max results (1-25, default 10). - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: Matches. Each record has: { "sc_id": str, # Moneycontrol id, e.g. "RI" — pass to quote/fundamentals "name": str, # Display name "symbol": str, # Trading symbol, e.g. "RELIANCE" "isin": str, # ISIN if available "bse_code": str, # BSE numeric code if available "sector": str, "link": str # Moneycontrol page URL } Returns "No matches..." when nothing is found.

Get a live equity quote: price, change, OHLC, 52-week range, volume, market cap.

Args: params (QuoteInput): - symbol (str): sc_id (preferred) or company name. - exchange (str): 'nse' (default) or 'bse'. - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: Quote data with this shape (JSON mode): { "name": str, "symbol": str, "exchange": str, "sc_id": str, "price": str, "change": str, "percent_change": str, "prev_close": str, "open": str, "high": str, "volume": str, "week52_high": str, "week52_low": str, "market_cap_cr": str, "market_state": str, "last_updated": str } Returns "Error: ..." on failure (e.g. unknown symbol).

Get valuation ratios, per-share metrics, sector and trailing returns for a stock.

Covers P/E (standalone & consolidated), industry P/E, P/B, book value, cash EPS, face value, dividend yield, market cap, sector classification, and price returns over 1w / 1m / 3m / 1y / YTD plus 5-year CAGR.

Args: params (FundamentalsInput): - symbol (str): sc_id (preferred) or company name. - exchange (str): 'nse' (default) or 'bse'. - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: Fundamentals with this shape (JSON mode): { "name": str, "sc_id": str, "sector": str, "sub_sector": str, "pe": str, "pe_consolidated": str, "industry_pe": str, "pb": str, "book_value": str, "cash_eps": str, "face_value": str, "dividend_yield": str, "market_cap_cr": str, "returns": {"1w": str, "1m": str, "3m": str, "1y": str, "ytd": str, "cagr_5y": str} } Returns "Error: ..." on failure.

Get the current level and movement for a market index.

Built-in fast-path names: Nifty 50, Sensex, Nifty Bank, Nifty IT, Nifty Auto, Nifty Pharma, Nifty FMCG, Nifty Metal, Nifty Midcap 100, Nifty Smallcap 100, Nifty 500. Other index names are resolved automatically via Moneycontrol search.

Args: params (IndexInput): - index (str): Index name or raw pricefeed code. - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: Index data with this shape (JSON mode): { "name": str, "level": str, "change": str, "percent_change": str, "open": str, "high": str, "low": str, "prev_close": str, "advances": str, "declines": str, "year_high": str, "year_low": str, "ytd_percent": str } Returns "Error: ..." on failure.

Get FII (foreign) and DII (domestic) institutional net activity, in INR crore.

The cash market is the headline figure most analysts watch: positive FII cash = foreign buying. F&O segments (index/stock futures & options) are also available. A positive number = net buying; negative = net selling.

Args: params (FiiDiiInput): - days (int): Recent trading days to return (1-60, default 10). - segment (str): 'cash' (default), 'fno', or 'all'. - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: A list of daily rows (most recent first). Each row (JSON mode): { "date": str, "fii_cash": float, "dii_cash": float, "net_cash": float, # when segment is 'fno' or 'all': "fii_index_fut": float, "fii_index_opt": float, "fii_stock_fut": float, "fii_stock_opt": float, "nifty_close": str, "nifty_change_pct": str } All cash/F&O figures are net values in INR crore. Returns "Error: ..." on failure.

Get current Moneycontrol news headlines for a topic, stock, or category.

Pass a query for targeted news (a company name gives stock-specific news; a topic like 'rbi policy' or 'crude oil' gives that theme). With no query, a category supplies a sensible default search: markets, latest, business, economy, results, stocks, ipo, mutual-funds.

Args: params (NewsInput): - query (Optional[str]): Topic/stock/keyword. Overrides category. - category (str): Default category when query is omitted ('markets'). - limit (int): Max headlines (1-50, default 15). - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: A list of current articles. Each (JSON mode): {"title": str, "link": str} Returns "No news found..." when nothing matches.

Get pivot points and support/resistance levels for a stock.

Args: params (TechnicalsInput): - symbol (str): sc_id (preferred) or company name. - exchange (str): 'nse' (default) or 'bse'. - period (str): 'D' (daily, default), 'W', or 'M'. - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: OHLC for the period plus pivot tables. JSON mode returns the raw Moneycontrol structure including pivotLevels (Classic, Fibonacci, etc.). Returns "Error: ..." on failure.

Get historical OHLCV price bars for an NSE stock (daily/weekly/monthly or intraday).

Args: params (HistoryInput): - symbol (str): NSE trading symbol (e.g. 'RELIANCE', 'HDFCBANK') or company name. - interval (str): 1m, 5m, 15m, 30m, 1h, daily (default), weekly, monthly. - count (int): Number of most-recent bars (1-500, default 30). - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: Bars ordered oldest → newest. Each bar (JSON mode): {"time": str, "open": float, "high": float, "low": float, "close": float, "volume": float} JSON mode wraps them as {"symbol", "ticker", "interval", "count", "bars": [...]}. Returns "Error: ..." on failure (e.g. no data at that resolution).