Health-check tool — confirms the MCP server is wired up correctly.

Get the company profile/overview for an NSE/BSE-listed Indian equity.

Accepts a bare symbol (e.g. "RELIANCE") and normalizes it to NSE by
default (appends .NS), or an explicit .NS/.BO suffix to pick the
exchange. This server covers Indian markets only -- a symbol that
resolves to real data on a non-Indian exchange is rejected rather than
silently returned.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Get the income statement for an NSE/BSE-listed Indian equity: revenue, gross profit, operating income, EBIT, EBITDA, net income, and EPS per fiscal period. Yahoo provides ~5 years annual / ~5-6 quarters, newest period first.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"
:param period: "annual" or "quarterly"

Get the balance sheet for an NSE/BSE-listed Indian equity: assets, liabilities, equity, debt, and working-capital line items per fiscal period. Yahoo provides ~5 years annual / ~5-6 quarters, newest period first.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"
:param period: "annual" or "quarterly"

Get the cash flow statement for an NSE/BSE-listed Indian equity: operating cash flow, capex, free cash flow, financing cash flow, and dividends paid per fiscal period. Yahoo provides ~5 years annual / ~5-6 quarters, newest period first.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"
:param period: "annual" or "quarterly"

Get the dividend and stock-split history for an NSE/BSE-listed Indian equity. An empty dividends list is a legitimate result for a company that has never paid one (common for growth companies) -- not an error; ticker validity is checked via .info separately.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Get OHLCV price history for an NSE/BSE-listed Indian equity. Intraday intervals aren't supported (out of scope for a fundamentals tool, and Yahoo restricts them to short windows anyway). Capped at 500 bars -- if a period/interval combination would return more, the oldest are dropped and truncated is set.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"
:param period: how far back: 1mo, 3mo, 6mo, 1y, 2y, 5y, or max
:param interval: bar size: 1d, 1wk, or 1mo

Calculate revenue, net income, EPS, and free-cash-flow CAGR for an NSE/BSE-listed Indian equity over its available annual history (Yahoo provides ~5 years, so this is at most a 4-year CAGR -- years_used reports the actual span, never implies a longer history than exists).

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Track gross/operating/net margin (as %) across an NSE/BSE-listed Indian equity's available annual history, oldest to newest, plus the first-vs-latest delta in percentage points. Deliberately doesn't label the trend "expanding"/"contracting" -- that interpretation is left to the caller.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Assess cash-flow quality for an NSE/BSE-listed Indian equity across its available annual history: cash conversion (CFO/net income and FCF/net income), and whether receivables or inventory grew meaningfully faster than revenue (a classic early signal worth investigating, not proof of a problem -- this tool flags, it doesn't score or accuse).

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Calculate valuation, profitability, liquidity, and efficiency ratios for the latest fiscal period of an NSE/BSE-listed Indian equity. Ratios Yahoo leaves null for Indian tickers (roce, roe, roa, current_ratio, interest_coverage, asset_turnover) are computed by hand from the income statement and balance sheet instead of read off .info.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Compare valuation and quality multiples for an NSE/BSE-listed Indian equity against explicit peer tickers (Yahoo has no peer-discovery endpoint for Indian equities, so peers must be supplied). Includes a transparent 0-100 "attractiveness score" per row, min-max normalized within this peer set only -- ROCE, revenue CAGR, EPS CAGR, and FCF yield count positively, debt/equity negatively, equal-weighted. Not an absolute scale -- rerun if the peer set changes. A peer that can't be resolved gets its error field set rather than failing the whole call.

:param symbol: the anchor ticker symbol
:param peer_symbols: peer ticker symbols to compare against (max 5; extras dropped)

Compare an NSE/BSE-listed Indian equity's current P/E to its own historical annual P/E (fiscal-year-end price / that year's diluted EPS) over its available history (Yahoo gives ~5 years -- years_used reports the real span, never implies a longer history). Years with negative/missing EPS are excluded. Relative to the company's OWN past only -- not an absolute cheap/expensive judgment or a peer comparison.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Instead of asking "what is the fair value", ask "what growth does the current price already assume": solves a two-stage DCF (5Y explicit growth + Gordon-growth terminal value) by bisection for the constant annual growth rate that makes the model's enterprise value match today's actual market cap + net debt. Compares that implied rate to the company's own historical revenue/FCF CAGR so you can judge whether the price requires stronger growth than the company has actually achieved. Not a forecast -- an implied-expectations check, with disclosed assumptions (wacc/terminal_growth are inputs you can override, not derived).

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"
:param wacc: discount rate assumption (default 0.12 = 12%)
:param terminal_growth: perpetuity growth assumption (default 0.04 = 4%); must be < wacc

Forward DCF: given growth/discount-rate assumptions, estimate intrinsic value per share and the margin of safety vs the current price. Same two-stage model as reverse_dcf (5Y explicit growth + Gordon-growth terminal value), run in the direct rather than solved-for direction. If growth isn't supplied, defaults to the company's own historical revenue CAGR -- a stated assumption, not a prediction; consider cross-checking with reverse_dcf to see what growth the current price already implies.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"
:param growth: annual FCF growth assumption, e.g. 0.10 for 10%; defaults to historical revenue CAGR
:param wacc: discount rate assumption (default 0.12 = 12%)
:param terminal_growth: perpetuity growth assumption (default 0.04 = 4%); must be < wacc

Score an NSE/BSE-listed Indian equity 0-100 across five equal-weighted (20% each) pillars -- Profitability (ROCE/ROE/net margin vs disclosed thresholds), Growth (revenue/EPS CAGR vs disclosed thresholds), Balance Sheet (current ratio + debt/equity), Cash Flow (FCF and CFO conversion vs net income), Valuation (historical P/E percentile, inverted so cheaper-than-own-history scores higher). A documented, transparent heuristic composed from calculate_financial_ratios, calculate_growth_metrics, analyze_cash_flow_quality, and historical_valuation -- not a market-validated predictive model.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Flag earnings-quality concerns for an NSE/BSE-listed Indian equity: profit rising while operating cash flow falls, receivables/inventory growing faster than revenue, heavy reliance on non-operating "other income", and whether cash flow has actually backed reported profit. Produces a 0-100 score (share of checks that came back clean) plus a flag list. These are observations worth investigating, not proof of a problem.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Scan an NSE/BSE-listed Indian equity's most recent fiscal year for structural red flags: a sudden (>5pp) margin swing, a debt spike (>30% YoY growth), goodwill/intangible assets growing much faster than total assets, and repeated exceptional/unusual items across the available history. Does NOT cover related-party transactions (no data in Yahoo Finance) or depreciation-pattern analysis (no reliable basis without industry context) -- scoped out rather than faked. Flags are observations to investigate, not accusations.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Show how an NSE/BSE-listed Indian equity deployed free cash flow each available fiscal year: dividends paid, buybacks, acquisitions, and net debt repayment (repayment minus new issuance -- positive means net paydown). Buybacks/acquisitions are null for company-years Yahoo has no matching cash-flow line item for (live-verified this varies: TCS.NS has buyback/acquisition rows, RELIANCE.NS doesn't) -- null means "not reported", not zero.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Assess capital-allocation and ownership-trend signals for an NSE/BSE-listed Indian equity: multi-year ROCE trend, share-count trend (rising = dilution, falling = net buybacks), dividend consistency, and the capital-allocation split (see analyze_capital_allocation). Deliberately excludes promoter shareholding -- Yahoo only has a US-style insiders/institutions split for Indian tickers, not the SEBI promoter/FII/DII/public breakdown, and presenting one as the other would be misleading.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Run the complete fundamental-analysis pipeline for one NSE/BSE-listed Indian equity in a single call: profile, ratios, growth, margin trends, cash flow quality, earnings quality, red flags, capital allocation, management quality, historical valuation, and health score. Composes every other tool in this server rather than re-deriving anything -- the underlying Yahoo fetches are shared/cached across all of them, so this is far cheaper than it looks.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Compare profile, key ratios, growth, and health score for multiple NSE/BSE-listed Indian equities side by side. Neutral comparison, not a relative-attractiveness ranking (see peer_valuation for that). A symbol that can't be resolved gets its error field set rather than failing the whole call.

:param symbols: ticker symbols to compare (max 5; extras are dropped)

Screen an explicit list of NSE/BSE-listed Indian equities for undervaluation signals: cheap vs their own historical P/E, and/or a reverse-DCF "growth cushion" (the price implies less growth than the company has actually delivered). Yahoo has no NIFTY-500-style constituent-list endpoint, so this can't discover a universe on its own -- you supply the candidates (max 15). Ranked best-first by a transparent 0-100 score, min-max normalized across this candidate list only (not an absolute scale); candidates that couldn't be resolved are appended at the end rather than dropped silently.

:param symbols: candidate ticker symbols to screen (max 15; extras are dropped)
:param max_results: how many ranked candidates to return (failed ones don't count against this)

Screen an explicit list of NSE/BSE-listed Indian equities and rank by financial_health_score, using earnings-quality score and red-flag count as tiebreakers. Yahoo has no NIFTY-500-style constituent-list endpoint, so you supply the candidates (max 15). Candidates that couldn't be resolved are appended at the end rather than dropped silently.

:param symbols: candidate ticker symbols to screen (max 15; extras are dropped)
:param max_results: how many ranked candidates to return (failed ones don't count against this)

Compose analyze_company's output into a structured research-memo shape: business summary, profitability, growth, cash flow, management, valuation, health score, risks, and bull/bear case bullets. The bull/bear case is mechanically derived from the ok/warning flags and valuation label already computed elsewhere -- a synthesis of this server's own numbers, not fabricated external/qualitative research. No "Catalysts" section: that needs analyst/news data this server doesn't have -- omitted rather than invented.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Assess bankruptcy/distress risk for an NSE/BSE-listed Indian equity using Altman's Z''-score (the emerging-market/non-manufacturing variant -- comparable across manufacturers and services companies alike, uses book value of equity so, unlike most valuation-adjacent tools here, this one is NOT vulnerable to the currency-mismatch issue documented elsewhere). Zones: SAFE (>2.6), GREY (1.1-2.6), DISTRESS (<1.1). Does NOT include Ohlson's O-score -- see the output model's ohlson_note for why.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"

Get recent news headlines/summaries for an NSE/BSE-listed Indian equity.

Yahoo's news stream for a ticker is loosely sector/theme-tagged, not a
strict per-company filter -- expect some broader industry or
competitor coverage mixed in with company-specific stories, and
occasionally an outright unrelated item. Each article's
`mentions_company` flag is a rough, mechanical relevance signal (does
the company's name/ticker literally appear in the title/summary), not
a guarantee either way -- use it to weigh results, not to assume
everything returned is deeply relevant or that a False is noise.

An empty result is a legitimate outcome (no recent coverage indexed --
common for small/micro caps), not necessarily an error; the ticker is
still validated first, so an invalid symbol raises rather than
silently returning empty.

:param symbol: ticker symbol, e.g. "RELIANCE", "TCS.NS", or "TCS.BO"
:param limit: max number of articles to return (default 10)

Find the NSE/BSE ticker symbol for a company by name or partial name. Use this first whenever you know a company's name but not its exact Yahoo Finance ticker, before calling any other tool here.

Filters Yahoo's global search results down to Indian-listed equities
only -- a plain name search otherwise mixes in US ADRs, other
exchanges, and non-equity instruments (ETFs, futures).

Two things worth knowing: (1) a company that demerged can have
multiple current tickers for what feels like one name -- e.g.
"Tata Motors" correctly returns two separate post-split entities
(commercial vehicles and passenger vehicles); don't assume a single
match is right without checking `name`/`industry`. (2) a renamed
company won't be found under its old name at all -- e.g. "Zomato"
returns zero matches since the company renamed to "Eternal Limited";
an empty result doesn't necessarily mean the company isn't listed, so
try the company's current/formal name before concluding that.

:param query: company name or partial name, e.g. "Reliance", "Tata Consultancy Services"
:param limit: max number of matches to return (default 10)