Skip to main content
Glama

Tapetide - Indian Stock Market MCP

Server Details

48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
Tapetide-hq/nse-bse-indian-stock-market-data-mcp
GitHub Stars
151
Server Listing
Tapetide - Indian Stock Market MCP
ChatGPT
–
Claude
–

TDQS

A3.6/5.0

Scored across 64 tools

Disambiguation3/5

The server covers a genuinely broad domain and most descriptions carefully cross-reference alternatives, but there is substantial overlap: many tools are explicit aliases (get_stock_news/get_corporate_actions vs get_stock_events, get_live_quote vs get_stock_quote, scan_movers vs get_trending_stocks), and several market-snapshot tools share territory (get_market_pulse, get_market_data, get_trending_stocks, market_heatmap). The lengthy warnings help an agent choose, but with 64 tools the boundaries are not crisp enough for a 4 or 5.

Naming Consistency3/5

Almost everything is lowercase snake_case, which keeps it readable, but the convention is mixed: many tools use get_/add_/remove_/screen_/search_ verbs while others are bare nouns (market_heatmap, market_valuations, read_me, read_document). Aliases additionally use different names for the same underlying operation, so there is no single predictable pattern.

Tool Count2/5

At 64 tools this is far beyond the 3-15 well-scoped range and clearly heavy for an agent to navigate. Some of that count is avoidable duplication through aliases and near-duplicate market-feed tools, which inflates the surface without adding capability.

Completeness5/5

The surface is exceptionally complete for Indian equity research: quotes, OHLCV history, financial statements, corporate actions, ownership/shareholding, pledge data, mutual funds, IPOs, options analytics, index history and membership, screening, documents, historical identifier resolution, and user portfolio/watchlist management. Any remaining gaps (e.g. index-only option chains) are explicitly disclosed rather than hidden dead ends.

Available Tools

64 tools
add_portfolio_stocksAdd Stocks to PortfolioA
Destructive
Inspect

Add one or more stocks to the user's portfolio, merging duplicates by weighted-average price. Accepts a single add, a bulk list, or holdings the user pasted from a broker CSV/table (parse it into the holdings array yourself). Example: "Add RELIANCE 10 shares at ₹1,350" → holdings:[{symbol:"RELIANCE",quantity:10,avg_price:1350}]. STRIP exchange suffixes before calling — -EQ, -BE, -SM, -ST, -BZ, -BL, -RE, -IV, -RR, .NS, .BO — and pass plain NSE symbols (APS-SM → APS; SME stocks are supported). When the user has stated symbol, quantity and price, add them directly. When you PARSED or inferred the holdings (broker CSV, a pasted table, a screenshot), show the parsed rows for confirmation first, and ask rather than guess a missing or ambiguous field. Use search_stocks if a symbol does not resolve. Call read_me for the full broker-CSV procedure.

Inputs: holdings (required).

add_to_watchlistAdd Stocks to WatchlistA
Idempotent
Inspect

Add one or more stocks to the user's watchlist. Idempotent — adding a stock that's already followed is a no-op.

Use cases: • User says "Watch RELIANCE" → single add • User says "Add all Nifty IT stocks to my watchlist" → you look up the symbols, then add them • User says "Track TCS, INFY, WIPRO" → bulk add

Inputs: symbols (required).

get_adjustment_factorsPrice Adjustment FactorsA
Read-onlyIdempotent
Inspect

Get the split/bonus adjustment-factor timeline for a stock, so a raw (unadjusted) price series can be reconstructed from the adjusted one. Returns per-event factor and cumulative factor with ex-dates, plus the reconstruction formula in meta. USE THIS when a price move looks impossibly large and you need to know whether it was a corporate action rather than a real return, or when the user asks for raw/unadjusted prices, or asks how to adjust for splits and bonuses. CRITICAL: the response also carries unquantified_events — rights issues and demergers that are KNOWN but have NO reliable numeric factor (a rights adjustment needs the subscription price; a demerger is not a single number). Never invent a factor for those; tell the user those ex-dates should be excluded or treated with caution. NOTE: data has split/bonus factors; rights factors are on REST corporate-adjustments. PRICE-return, not total-return.

Inputs: symbol, ticker, identifier.

get_batch_financialsBatch Financial StatementsA
Read-onlyIdempotent
Inspect

One financial statement section for up to 10 companies in one call, for comparing them: the same numbers and available_from dates as get_financials, latest periods per company. Results are in input order, one per symbol; a symbol that fails gets found:false and the reason. Charged as one call per company found.

Inputs: periods, section, symbols.

get_batch_quotesBatch Stock QuotesA
Read-onlyIdempotent
Inspect

Quotes for up to 20 stocks in one call, each with price_basis and last_trade_date as in get_stock_quote. NSE prices can lag the exchange by up to ~15 minutes.

Inputs: symbols.

get_company_profileCompany ProfileA
Read-onlyIdempotent
Inspect

Get detailed company overview — sector, about, pros/cons, fundamentals (PE, PB, market cap, ROE, ROCE, debt/equity), growth metrics, and current quote. Default response is ~3KB.

Optional 'include' sections:

  • "technicals": RSI, SMA, EMA, MACD, Bollinger Bands, ATR, ADX (~20 indicators)

  • "ratings": Analyst buy/hold/sell consensus with counts and percentages

  • "peers": Comparable-company table — the stock's published peer cohort with price, day change, market cap, P/E, P/B, dividend yield, ROE, ROCE, ROA, OPM, debt/equity, TTM sales and net profit, and promoter holding, plus a per-column median across the cohort. The stock itself is included and flagged is_self, so it can be ranked against its own peers on any column. A null metric means the figure is not published for that company — never treat it as 0.

  • "industry_peers": every traded company in the stock's basic industry, largest first, with 3y revenue/profit growth and 1y return; 50 per call, then peers_cursor = industry_peers.next_cursor.

  • "auditors": statutory auditor, FRN, tenure; auditor by year, change years, appointment/exit filings

Also last_split/last_bonus (ratio, ex-date, price_confirmed); split_bonus_unavailable if not read.

Inputs: symbol, ticker, include, identifier, +1 more.

get_corporate_actionsCorporate Actions (alias)B
Read-onlyIdempotent
Inspect

Alias for get_stock_events with type:"corporate_actions". Dividends, splits, bonuses, AGMs for one stock. Example: {"symbol":"ITC"}.

Inputs: limit, symbol, ticker, identifier.

get_credit_ratingsCredit RatingsA
Read-onlyIdempotent
Inspect

Get credit-rating actions for a company — agency, rating, action (upgrade/downgrade/reaffirm), and outlook over time. A rating change is a forward-looking signal on credit/solvency risk. Use for risk assessment and debt-investor research.

Inputs: symbol, ticker, identifier.

get_document_summaryDocument SummaryA
Read-onlyIdempotent
Inspect

Investor digest of ONE parsed filing: summary, highlights, risks, guidance, key metrics, plus links to the PDF and full Markdown. Pass doc_id from list_company_documents, or doc_type for the newest of that type. For the text itself use read_document or download links.markdown_url.

Inputs: doc_id, symbol, ticker, doc_type, +1 more.

get_earnings_call_summaryEarnings Call SummaryA
Read-onlyIdempotent
Inspect

Get AI-generated investor digests of a company's recent earnings (concall) transcripts and investor presentations — a structured summary plus key highlights, risks, management guidance, and headline metrics, grounded in the company's own filings. Use for qualitative fundamental research beyond the numbers.

Inputs: limit, symbol, ticker, identifier.

get_fii_dii_detailFII/DII Institutional FlowsA
Read-onlyIdempotent
Inspect

Get detailed FII/DII institutional flow data:

  • Daily cash market flows for last 30 trading days (buy/sell/net in crores)

  • F&O participant positioning (FII/DII/Pro/Client long/short OI)

  • Weekly, monthly, yearly aggregates

  • Buy/sell streaks and 5d/30d/1yr cumulative net flows

  • Optional: cumulative flow chart data with interval param

Essential for understanding institutional money flow in Indian markets.

Inputs: chart_interval.

get_fii_dii_flowsFII/DII Flows (alias for get_fii_dii_detail)A
Read-onlyIdempotent
Inspect

Alias for get_fii_dii_detail. Get detailed FII/DII institutional flow data — daily cash market flows, F&O positioning, weekly/monthly/yearly aggregates, buy/sell streaks.

Inputs: chart_interval.

get_financialsFinancial StatementsA
Read-onlyIdempotent
Inspect

Get financial statements for one company. Sections: quarterly (quarterly P&L), profit_loss (annual P&L), balance_sheet, cash_flow, ratios (all annual). Default: the latest periods with growth rates (quarterly ~13 quarters); omit section for all sections trimmed to 5 periods each (periods widens, e.g. {"symbol":"TCS","section":"quarterly","periods":12}). Each section carries periods (oldest first), data {row: {period: value}}, pct_changes, row_order and availability with each period's point-in-time available_from. LONG HISTORY: pass section with from, to, as_of or basis for a period table (broad from FY2015, sparse before), up to 60 periods per call, newest first; when meta.next_to is set, call again with to = that date for older periods. That table's eps_basis: as_reported, restated or null. as_of returns only what was public then (backtests); values may include later restatements. One symbol per call; to compare companies use get_batch_financials. ETFs, index funds and bonds have no statements.

Inputs: to, from, as_of, basis, +6 more.

get_forecastsAnalyst ForecastsA
Read-onlyIdempotent
Inspect

Get analyst forecasts — EPS, revenue, EBITDA, net income, ROA, ROE, and price estimates. Both quarterly and annual periods with actuals vs estimates comparison, and each estimate's analyst range in bands (low/high). EPS actuals are restated for splits and bonuses; meta.eps_adjustments lists what was rescaled. Useful for understanding market expectations and earnings surprises.

Inputs: symbol, ticker, identifier.

get_fpi_sectorsFPI Sector-wise FlowsA
Read-onlyIdempotent
Inspect

Get FPI (Foreign Portfolio Investor) sector-wise investment data. Returns AUM share per sector, fortnight change, 1-year cumulative flow, and sparkline data. Sorted three ways: by AUM, by fortnight change, and by 1Y flow. Useful for understanding which sectors foreign investors are buying/selling.

Inputs: no named parameters.

get_identifiers_asofIdentifiers Held By a Stock As-Of a DateA
Read-onlyIdempotent
Inspect

The REVERSE of resolve_identifier_asof: given a company's symbol and a date, return which symbol and ISIN that company held at that time. USE THIS to label historical output correctly — e.g. reporting a 2019 backtest position under the ticker it actually traded as then, rather than its current name. Also useful for explaining a rename to a user who is confused why a symbol they remember no longer resolves. Pass the symbol the company trades as today (resolve_identifier_asof maps an old ticker to it). Coverage bounds are stated in the response — outside them the answer is out_of_coverage, not 'no identifiers'.

Inputs: date, symbol, ticker, stock_id, +1 more.

get_index_historyIndex Level HistoryA
Read-onlyIdempotent
Inspect

Get the historical LEVEL series (OHLC + PE/PB/dividend yield) for a single NSE INDEX — Nifty 50, Nifty Bank, Nifty IT, Nifty Oil & Gas, India VIX, and ~140 more. Official NSE index data. Use for 'what did Nifty IT close at on ', 'Nifty Bank level history', 'India VIX over the last month', or index valuation trend. This is the INDEX counterpart of get_price_history (which handles individual stocks only). To rank or compare MULTIPLE indices by return, use get_index_performance instead. Over the size limit the newest bars are kept (data.page); while meta.window.has_more, pass meta.window.next_cursor as end_date. count/from/change_pct cover the whole window, ending at end_date when given.

Inputs: code, days, slug, index, +10 more.

get_index_membership_asofIndex Membership As-Of a DateA
Read-onlyIdempotent
Inspect

Was a stock a constituent of an index on a specific historical date? Returns a FOUR-STATE answer, never a bare yes/no: present (proven in range), uncertain (inside an unobserved bracket around a join/leave — plausible but NOT proven), absent (proven not a member, within coverage), or out_of_coverage (outside the observed window — we cannot answer). USE THIS for any 'was X in the Nifty 50/500 on ' question, and for point-in-time universe construction or survivorship-bias-aware backtests. Do NOT infer historical membership from today's constituent list — that is exactly the survivorship bias this tool exists to avoid. REPORT UNCERTAINTY HONESTLY: treat uncertain and out_of_coverage as NOT tradeable signal and say so; never silently collapse either into absent. The response states its own meta.coverage window plus meta.freshness.lag_days — trust answers only up to coverage.answerable_through.

Inputs: date, index, symbol, ticker, +1 more.

get_index_performanceIndex Performance RankingA
Read-onlyIdempotent
Inspect

Rank NSE indices by RETURN over recent completed weeks or months, using official NSE index closing levels. Returns per-period % plus cumulative % for each index, sorted best-to-worst. Covers ~140 indices: all sectoral (IT, Bank, Auto, Pharma, FMCG, Metal, Realty, Energy, Oil & Gas, PSU Bank, Private Bank, Media, Healthcare, Consumer Durables, Power, Insurance, Telecom, Chemicals, Cement, Capital Goods, NBFC, Retail and more), plus broad market/size, thematic and strategy/factor indices. USE THIS for 'rank sectoral indices by 3-week return', 'which sector performed best last month', 'top gaining sectors', or weekly close-to-close index returns — do NOT compute a sector return from its constituents, which is only an approximation. Only COMPLETED periods are counted; the in-progress week/month is excluded.

Inputs: limit, order, periods, category, +2 more.

get_india_vixIndia VIX (Volatility Index)A
Read-onlyIdempotent
Inspect

Get the India VIX — the market's expected near-term volatility (the 'fear gauge'). Returns the latest value, daily change, and recent history. Rising VIX = rising fear/uncertainty; falling VIX = calm. Use for market-timing and risk context.

Inputs: no named parameters.

get_ipoIPO DetailB
Read-onlyIdempotent
Inspect

One IPO by name or slug: timetable to refund, demat credit and listing; lots and amounts per category; shares reserved incl. anchor and market maker; anchor book with lock-in dates; latest bids per category (times, shares, INR crore, time); latest grey market premium (unofficial) with sauda; KPIs, financials, objects, peers. Application counts are not available.

Inputs: query (required).

get_lender_metricsBank and NBFC MetricsA
Read-onlyIdempotent
Inspect

Bank and NBFC metrics for one stock with quarterly history and an available_from (filing) date per value: gross/net NPA (INR crore and %), CET1, AT1 and Tier 1 %, provisions, operating expenses, interest, deposits, advances / loans, borrowings, and a computed NIM (computed: true). Banks from 2022; NBFCs from 2021 (no NPA or capital ratios in their filings). quality marks doubtful values, e.g. reported_value_is_total_crar when a bank filed total CRAR as CET1. CRAR and CASA are not available. Read meta.field_notes. Pass as_of for point-in-time values. If meta.has_more, call again with cursor.

Inputs: to, from, as_of, basis, +6 more.

get_live_quoteLive Quote (alias)A
Read-onlyIdempotent
Inspect

Alias for get_stock_quote (same fields, incl. price_basis and last_trade_date). NSE prices can lag the exchange by up to ~15 minutes. Example: {"symbol":"RELIANCE"}.

Inputs: symbol, ticker, symbols, identifier.

get_market_dataMarket Data FeedsA
Read-onlyIdempotent
Inspect

Get one of today's market-wide data feeds. Pass dataset to choose:

  • deals — bulk & block deals for the last 7 days (symbol, name, client, buy/sell, qty, price, value), newest and largest first.

  • fno_ban — F&O ban list: stocks at or above 80% of MWPL, with mwpl_pct and status (in_ban from the exchange's published ban list, else near_ban).

  • deliveries — latest session's highest delivery-% stocks (>=50%, traded value >= Rs 1 Cr), indicating genuine buying over speculation.

  • ipo — current and upcoming IPOs: dates, price band, issue size, and subscription by category.

  • mtf — Margin Trading Facility: most-funded stocks with funded qty/value in Rs crore and change vs the previous session (market-wide book not available).

  • slbm — Stock Lending & Borrowing: lent stocks with lending yield and traded qty. High yield = strong short-selling demand.

  • signals — technical signals from the latest session: 52-week highs/lows, RSI extremes, MACD, volume spikes, 200-day trend. For index PE/PB valuation history use market_valuations; for an index's constituent heatmap use market_heatmap; for a single stock's own deal history use get_stock_deals.

Inputs: feed, type, dataset, category, +1 more.

get_market_newsMarket NewsA
Read-onlyIdempotent
Inspect

Get latest market-wide news across all categories. Returns sentiment-tagged articles (positive/negative/neutral) with category, source URL, and related stock symbols.

Categories include: companies, global, markets, ipo, government-policy-and-regulation, debt-markets, equity-markets, investment-ideas, technology, real-estate, infrastructure.

Use this for broad market news. For stock-specific news, use get_stock_events with type "news" instead.

Inputs: limit, category, sentiment.

get_market_pulseMarket PulseA
Read-onlyIdempotent
Inspect

Today's snapshot: FII/DII net flows (crores), Nifty 50 PE/PB/DY, India VIX, global indices (S&P 500, Dow, Nasdaq...), gold/silver/crude closes, USD/INR. Quick daily overview. For the technical signal scanner (52-week highs/lows, RSI extremes, MACD, volume spikes) use get_market_data with dataset: "signals"; for top gainers/losers/most-active use get_trending_stocks.

Inputs: no named parameters.

get_mutual_fundMutual FundA
Read-onlyIdempotent
Inspect

Indian mutual fund scheme by scheme code, ISIN or name (also old names, typos). A sure match returns the plan (fund, house, category, plan/option, ISINs, latest NAV), trailing and calendar-year returns from its NAVs, current expense ratio and its changes, the fund's profile (objective, benchmark, riskometer, exit load, minimums, managers), a fund-level snapshot (AUM, returns vs benchmark), risk or tracking figures where available, volatility, Sharpe and Sortino computed from NAVs, its latest portfolio month and other plans. Else ranked scheme codes, flagged when uncertain. A house's name adds its company, status and AUM history. Active and closed schemes; returns are in percent, 3y+ annualised.

Inputs: query (required).

get_mutual_fund_nav_historyMutual Fund NAV HistoryA
Read-onlyIdempotent
Inspect

Daily NAV history of one mutual fund plan by scheme code (INR per unit, from as early as 1986). Long ranges return period-end NAVs (weekly, monthly or quarterly) so the series fits; interval forces one (newest 300 points at most).

Inputs: scheme_code (required), to, from, interval.

get_mutual_fund_portfolioMutual Fund PortfolioA
Read-onlyIdempotent
Inspect

A fund's month-end portfolio: every line, largest value (INR crore) first, as compact rows (weight, ISIN, symbol, standard and printed industry or rating, rating agency, cash kind, yield/coupon/maturity) paged by offset; net assets; a summary (asset classes, cash, top 10, industries, market-cap split); debt YTM, durations, average maturity. Start year varies by house. By scheme_code, or a fund's name: its linked portfolio (link says confirmed or inferred). Else name words match statements, each at its newest in 13 months; several list house and portfolio_code. compare: bought and sold since a month. stock: funds holding a stock, with scheme codes.

Inputs: top, fund, house, month, +6 more.

get_observation_statusPer-Day Observation StatusA
Read-onlyIdempotent
Inspect

For every CALENDAR day in a lookback window, get why a price is or is not present: traded, weekend, holiday, pre_listing, delisted, or no_print. USE THIS when a price series has gaps and the user needs to know whether a missing day was a market holiday, a suspension, a pre-listing date, or genuinely missing data — and ESPECIALLY before computing returns over a gappy series. A missing price is NOT a zero return: no_print means a listed trading day with no print and should be treated as not-a-return (carry forward or mask), never as 0%. HONESTY LIMITS in the response's classification_limits: no_print deliberately does NOT distinguish an illiquid no-trade from a suspension from missing data (no per-day suspension feed exists, so a specific reason would be fabricated), and pre_listing can only be asserted where a listing date is known — its absence is not evidence the stock was trading.

Inputs: days, symbol, ticker, identifier.

get_option_chainIndex Option Chain (IV, Greeks, OI by strike)A
Read-onlyIdempotent
Inspect

Get the INDEX OPTION CHAIN with implied volatility, Greeks, bid/ask and open interest by strike. Use for any option-chain, IV, Greeks, open-interest, PCR or max-pain question — 'show me the NIFTY option chain', 'what is the ATM IV', 'where is max pain', 'put-call ratio', 'OI by strike'. Covers NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY ONLY — we do not collect a chain for individual stocks, so for a stock-option question say the chain covers index options only rather than implying we have no options data at all; get_option_iv_history DOES cover ~556 underlyings including stocks. IMPORTANT: this is an END-OF-DAY STAMPED snapshot, not a streaming live tick. Read snapshot_ts and state it (e.g. 'as of the 7 Aug close') — never imply an intraday real-time quote. iv_pct and atm_iv_pct are PERCENT (10.87 means 10.87%); atm_iv_change is percentage POINTS vs the prior session. NULLS ARE UNAVAILABLE, NEVER ZERO: a leg flagged iv_unsolved has null IV and Greeks (reason in iv_status), illiquid means no OI/volume so its premium is indicative only, and pcr_undefined means the put/call ratio cannot be computed. Render these as '—'; never state a 0% IV, a 0 delta or a PCR of 0. Also read atm_offset (strike steps from ATM) and available_expiries. Present the chain as data: report the numbers and what they describe. Do NOT recommend a strike, a strategy, or a direction to trade.

Inputs: expiry, symbol, ticker, strikes, +1 more.

get_option_iv_historyOption IV History (ATM IV, IV rank, PCR series)A
Read-onlyIdempotent
Inspect

Get the HISTORICAL option-analytics time series for an underlying — ATM implied volatility, IV rank, IV percentile, realised vol, put-call ratio (OI and volume), max pain and 25-delta skew, one point per session. Use for 'is IV high right now', 'IV rank of RELIANCE', 'has volatility been rising', or any volatility-regime / IV-vs-realised comparison. Covers ~556 underlyings INCLUDING individual stocks (unlike get_option_chain, which is index-only). UNITS: every IV field is a PERCENT (10.55 means 10.55% annualised) — never multiply by 100 again. iv_rank_pct and iv_percentile_pct are percents too, not 0-1 scores, and they are DIFFERENT measures: rank is position in the trailing high-low band, percentile is the share of sessions below the current reading. Read bar_interval — ranges of 2y+ are rolled up WEEKLY, so counting points as trading days will be wrong; one call returns at most the 400 most recent bars, so quote the from_date/to_date returned rather than assuming full history. The response also states its own coverage and flags spot_is_proxy — respect both. Report the numbers and what they describe. Do NOT recommend a trade, a strike, or a volatility position.

Inputs: range, symbol, ticker, identifier.

get_options_analyticsOptions & Derivatives AnalyticsA
Read-onlyIdempotent
Inspect

Get derivatives analytics for a stock — implied volatility (ATM IV, IV rank, IV percentile), realized volatility, put-call ratio (OI and volume), max pain strike, 25-delta skew, and call/put open interest, broken down per expiry. Use for options strategy, volatility analysis, and gauging derivatives-market positioning.

Inputs: symbol, ticker, identifier.

get_price_historyPrice History (OHLCV)A
Read-onlyIdempotent
Inspect

OHLCV price history, one row per bar: date, open, high, low, close, raw_close, volume, delivery_pct, delivered_qty (volume x delivery_pct / 100, within volume/20,000 shares). Daily or weekly bars; default 365 days (max 2000). For price analysis and technicals. IMPORTANT: check meta.window before treating the series as complete. days is CAPPED at 2000 (meta.window.truncated), and a window over the ~25k-char result limit keeps the newest bars (meta.truncated). Either way meta.window.has_more: true means older bars exist: pass meta.window.next_cursor as end_date, and page until meta.window.has_more is false.

Inputs: days, symbol, ticker, end_date, +2 more.

get_promoter_pledgePromoter Share PledgeA
Read-onlyIdempotent
Inspect

Promoter share-pledge history for a stock: % of promoter holding pledged by quarter (from Jun 2017, each with available_from), plus pledge creation/release events from 2015, paged. High or rising pledges are a governance red flag. pct_total_shares_pledged is ALL pledged shares (any holder), not promoter-only; see field_notes.

Inputs: to, from, limit, offset, +4 more.

get_results_declaredResults DeclaredA
Read-onlyIdempotent
Inspect

Companies that filed quarterly results in a time window, newest first. One row per company and quarter: filed_at (latest results filing, IST), declared_at (first original filing held, or null), revision, and revenue and net profit in INR crore as filed (basis consolidated when filed, else standalone; revenue is interest earned for banks, can be null). Answers "who reported today"; with symbols (up to 500) it checks a whole list in one call, so call get_financials only for the stocks that changed. If meta.has_more, repeat with since = meta.since and until = meta.next_until. NSE and BSE filings from August 2026 on.

Inputs: limit, since, until, symbols.

get_screener_ratiosScreener Ratio LookupA
Read-onlyIdempotent
Inspect

Search or list available financial ratios for the screen_stocks tool. Pass a keyword to search (e.g., 'cash flow', 'debt', 'promoter') or omit for the full catalog of 325 ratios. Returns the exact ratio names that screen_stocks queries accept.

Inputs: q.

get_shareholdingShareholding PatternA
Read-onlyIdempotent
Inspect

Get shareholding pattern — promoter, FII, DII, public holdings over time. Track institutional buying/selling trends quarter over quarter. Useful for understanding ownership changes. detail=institutions: DII split (mutual funds, insurers, banks, pension funds, AIFs...) and FPI holder counts by quarter. CAUTION: a move of more than 5 points in any bucket in a single quarter may be a filing reclassification rather than trading. When you see one, report the public/other buckets for the same quarters alongside it and do not describe the move as accumulation or exit without a second source.

Inputs: type, cursor, detail, symbol, +2 more.

get_stock_dealsBulk, Block & Insider DealsA
Read-onlyIdempotent
Inspect

Get large-trade history for a stock — bulk deals, block deals, insider (designated-person) trades, and SAST (substantial acquisition) disclosures, with the counterparty name, buy/sell side, quantity, price, and value, newest first. Insider/SAST rows are filings (record: filing, with disclosure date, category, holdings) or older summary rows for months without filings (record: summary; see meta.coverage_note). Answers 'who has been buying or selling X?'. Optionally filter by deal type. price is as traded; price_adjusted is the same price on the split/bonus-adjusted basis of the daily closes, so compare a pre-split/bonus deal with the close using price_adjusted. While meta.has_more, pass meta.next_cursor as cursor.

Inputs: type, limit, cursor, symbol, +2 more.

get_stock_eventsStock EventsA
Read-onlyIdempotent
Inspect

Get stock events — news, corporate actions, or company filings.

Types:

  • "news": Sentiment-tagged news (positive/negative/neutral), category, source URL

  • "corporate_actions": Dividends, splits, bonuses, AGMs, rights issues with ex-date and LTP

  • "filings": Results, presentations, concall transcripts/audio, annual reports, credit ratings, announcements. Rows carry doc_type and the exact filing date, latest quarter included.

Paging: max 50 per call; while meta.has_more, pass offset=meta.next_offset. from/to (filings only) bound the date; meta.total is for the filtered set.

Inputs: to, from, type, limit, +4 more.

get_stock_index_membershipsIndex Memberships of a StockA
Read-onlyIdempotent
Inspect

Every tracked index a stock has been in, one row per membership spell with its start, end and the dates bounding each join and exit. Each index's record has its own start (the earliest is meta.coverage_from), so an empty list means no tracked index since its record began, not never; joined_before_coverage: joined before the record. For one index on one date use get_index_membership_asof. With date, empty means not a member only when meta.date_status is in_coverage; partial_coverage answers only meta.covered_indices.

Inputs: date, cursor, symbol, ticker, +2 more.

get_stock_newsStock News (alias)A
Read-onlyIdempotent
Inspect

Alias for get_stock_events with type:"news". Sentiment-tagged news for one stock. Example: {"symbol":"TCS"}.

Inputs: limit, offset, symbol, ticker, +1 more.

get_stock_ownershipStock OwnershipA
Read-onlyIdempotent
Inspect

Get ownership data for a stock — yearly dividend totals and mutual fund holdings. dividends is one row per year: {Year, Div (dividend per share in ₹ for that year), yield (%), exch}. There is NO ex-date and NO interim/final split here; for dated individual dividends use get_stock_events with type "corporate_actions". dividends is an empty string or null when none is on file. mf_holdings is a list of positional arrays, one per scheme: [scheme_id, scheme_name, amc_id, scheme_isin, shares_held, pct_of_scheme_aum, share_change_mom, pct_of_aum_change_mom (percentage points), an unlabelled change figure (do not interpret), months, slug]. shares_held, pct_of_scheme_aum and months are '|'-joined monthly series, newest first, aligned by position (e.g. months "2026-09|2026-08|…"). Empty string or null when no holdings are on file.

Inputs: symbol, ticker, identifier.

get_stock_quoteStock QuoteA
Read-onlyIdempotent
Inspect

Latest stock quote: LTP, change, change %, volume, market cap, PE, 52-week high/low. price_basis is live (traded today or in the last session), last_trade (an older session's price) or null (unknown). last_trade_date is the session the price traded in. NSE prices can lag the exchange by up to ~15 minutes. For multiple stocks, use get_batch_quotes instead.

Inputs: symbol, ticker, symbols, identifier.

get_tapetide_scoreTapetide Score (one stock)A
Read-onlyIdempotent
Inspect

Get the Tapetide Score for ONE stock: a deterministic, non-LLM 0-100 composite from the latest complete scoring run, with the six pillar sub-scores and their weights, the percentile within that run (base: percentile_universe), confidence, coverage, and governance caps and red flags. There is no band field: band = Strong 66+, Good 55-65, Average 45-54, Weak 37-44, Poor <37 (as in screen_tapetide_scores). USE THIS for 'what is Tapetide's score for X', 'why is X rated Y', or as the rating input to a write-up. HOW TO READ IT: (1) the band matters more than the number: the distribution is narrow and a 1-3 point gap is noise; (2) a null pillar means the data is unavailable, NOT a zero: never average over it or call the company weak on it; (3) status: "insufficient_data" means no publishable score: say so, never substitute a number; (4) governance.caps_applied / red_flags mean an overlay limited the score, worth saying; (5) there is deliberately NO category label: describe the pillar numbers in your own words. Decision-support only. The Tapetide Score is data analysis, not investment advice. Tapetide is not a SEBI-registered research analyst or investment adviser. Bands are intentionally coarse; small point differences may not be meaningful.

Inputs: symbol, ticker, symbols, identifier.

get_user_portfolioUser Portfolio HoldingsA
Read-onlyIdempotent
Inspect

Get the authenticated user's current stock portfolio with live prices. Returns each holding's symbol, company name, quantity, average buy price, current market price, P&L (absolute + %), invested value, portfolio weight %, sector, industry, market cap, PE ratio, dividend yield, and company classification (large/mid/small cap), plus portfolio-level totals.

Returns an empty list when the user has not added any holdings. Holdings can be added with add_portfolio_stocks, including from a pasted broker CSV export.

Inputs: no named parameters.

get_watchlistUser WatchlistA
Read-onlyIdempotent
Inspect

Get the user's stock watchlist — the stocks they are following, newest first. Returns symbol, company name, sector, industry and the live quote (price, change, change %, previous close; null when unpriced) for each stock, plus a gainers/losers/unchanged tally of the whole list in movers. Paged: up to 50 stocks per call; when has_more is true, call again with offset: next_offset to get the rest (do this before acting on "all" of a long watchlist).

Inputs: limit, offset.

list_company_documentsList Company DocumentsA
Read-onlyIdempotent
Inspect

Index of a company's filings parsed to text (concall transcripts, annual reports, presentations, IPO documents): doc_id, type, period, date, num_pages, flags, and per-document links (raw PDF, full Markdown, summary Markdown). No prose. The doc_id is the input get_document_summary and read_document take; the links let the user open or download the document. Newest first.

Inputs: limit, since, symbol, ticker, +2 more.

market_heatmapStock HeatmapA
Read-onlyIdempotent
Inspect

Get a stock heatmap for an index — all constituent stocks with market cap, PE, PB, price changes (1d/1w/1m/3m/6m/1y/5y), volume, and sector.

Available indices: see the index parameter (Nifty broad, size and sector indices plus Sensex).

Inputs: index.

market_valuationsMarket ValuationsA
Read-onlyIdempotent
Inspect

Get index valuation metrics (PE, PB, Dividend Yield) over time. Default: Nifty 50, weekly data, 5 years. Useful for assessing whether the market is overvalued or undervalued relative to historical averages.

index_code accepts EITHER a slug (recommended, like market_heatmap) or a raw numeric code: nifty-50 (13), nifty-500 (19), nifty-bank (25), nifty-midcap-50 (51), nifty-it (27), nifty-next-50 (53).

Inputs: years, index_code.

read_documentRead Document TextA
Read-onlyIdempotent
Inspect

Markdown text of a parsed filing by doc_id and page range, with markers to cite. Max 12 pages / 24000 chars per call (max_chars up to 60000); the result states pages_returned, next_pages, and links to the full Markdown and PDF. Annual reports run 100-400 pages: read the sections you need, or download links.markdown_url to search the whole file.

Inputs: doc_id (required), pages, symbol, ticker, +2 more.

read_meTapetide MCP GuideA
Read-onlyIdempotent
Inspect

Returns the complete guide to this server — all tools organised by category, the SEBI disclaimer requirement, and usage patterns for common research tasks.

Inputs: no named parameters.

remove_from_watchlistRemove Stocks from WatchlistA
DestructiveIdempotent
Inspect

Remove one or more stocks from the user's watchlist.

Use cases: • User says "Stop watching INFY" → single remove • User says "Clear my watchlist" → remove all (get watchlist first, paging with next_offset until has_more is false, then remove all symbols)

Inputs: symbols (required).

remove_portfolio_stocksRemove Stocks from PortfolioA
DestructiveIdempotent
Inspect

Remove one or more stocks from the user's portfolio entirely.

Use cases: • User says "Remove INFY from my portfolio" → single delete • User says "Remove all IT stocks" → you identify the symbols from get_user_portfolio, then delete them • User says "Clear my portfolio" → remove all symbols

IMPORTANT: Always confirm with the user before removing stocks. This action cannot be undone. For partial sells (reducing quantity), use update_portfolio_stock instead.

Inputs: symbols (required).

resolve_identifier_asofResolve a Symbol/ISIN As-Of a DateA
Read-onlyIdempotent
Inspect

Resolve a historical symbol or ISIN to the company that held it ON a given date. USE THIS when working with old data whose ticker may since have been renamed, reused, or reassigned — e.g. a 2018 holdings file, an old research note, or a backtest that must not treat one company as two securities (or worse, merge two different companies because a ticker was recycled after a delisting). Returns present | uncertain | not_found | out_of_coverage with certainty ranges; each match names the company by its latest known symbol and isin, which the other stock tools take. uncertain means the date falls in an open bracket around a rename/ISIN change — quarantine it rather than asserting the mapping. The response states its own coverage window; a date outside it returns out_of_coverage and must not be reported as 'no such symbol'.

Inputs: date, kind, query, value, +1 more.

run_preset_screenFind the right screening toolA
Read-onlyIdempotent
Inspect

Not a standalone tool. For ready-made movers use get_trending_stocks; for custom fundamental screens use screen_stocks; for technical screens use screen_stocks_technical.

Inputs: preset.

scan_moversMarket Movers (alias)A
Read-onlyIdempotent
Inspect

Alias for get_trending_stocks. Top gainers, losers, and most-active stocks today.

Inputs: no named parameters.

screen_mutual_fundsScreen Mutual FundsA
Read-onlyIdempotent
Inspect

Rank, filter or compare Indian mutual funds: one row per fund with category, benchmark, 1/3/5y returns vs benchmark, base expense ratio (and all-in), average AUM, first NAV date. Filter and sort by those, or compare up to 10 scheme_codes. One category adds its quartiles. Past returns, not advice.

Inputs: plan, sort, limit, order, +7 more.

screen_stocksStock Screener (Fundamental)A
Read-onlyIdempotent
Inspect

Screen Indian stocks by fundamental criteria using 325 financial ratios (valuation, profitability, growth, balance sheet, cash flow, shareholding, with 3Y/5Y/10Y history). For technical screens (RSI, MACD, moving averages), use screen_stocks_technical instead.

QUERY SYNTAX: {Ratio Name} {operator} {value}[%] Operators: >, <, =, >=, <= Connectors: AND, OR (each on its own line) Cross-field comparison is allowed: Current price > DMA 200 Max length 1500 characters. Ratio names must be EXACT (case-insensitive); an invalid query is an error naming the bad token.

COMMON RATIO NAMES: Market Capitalization, Current price, Price to Earning, Price to book value, Dividend yield, Return on equity, Return on capital employed, OPM, EPS, Net profit, Sales, Sales growth 3Years, Profit growth 3Years, Debt to equity, Current ratio, Promoter holding, FII holding, Pledged percentage, DMA 50, DMA 200, RSI, Piotroski score, Altman Z Score, Number of equity shares. Call get_screener_ratios (searchable, full 325-ratio catalog) for anything not listed — do not guess a name.

EXAMPLE: "Market Capitalization > 5000 AND\nPrice to Earning < 15 AND\nReturn on capital employed > 22"

Note: "last year" in a ratio name means the most recent annual result. To identify an unknown stock from partial financials, call read_me for the disambiguation procedure.

Inputs: page, sort, limit, order, +2 more.

screen_stocks_technicalStock Screener (Technical)A
Read-onlyIdempotent
Inspect

Screen Indian stocks by technical indicators (RSI, MACD, moving averages, crossovers, volume, momentum) on real-time data. For fundamental screening (PE, ROCE, Sales, Growth), use screen_stocks instead.

Each filter is { left: field, operation, right: number | field }. Operations: "greater", "less", "equal", "in_range" (right is [min,max]), "crosses_above", "crosses_below" (crossover today).

FIELDS: close, open, high, low, volume, change, change_abs, market_cap_basic | SMA5/10/20/50/100/200, EMA5/10/20/50/100/200 | RSI, RSI[1], MACD.macd, MACD.signal, Stoch.K, Stoch.D, CCI20, ADX, AO, Mom, ATR | BB.upper, BB.lower | Pivot.M.Classic.R1/R2/S1/S2 | Recommend.All (-1..1), Recommend.MA, Recommend.Other | Perf.W, Perf.1M, Perf.3M, Perf.6M, Perf.Y, Perf.YTD | average_volume_10d_calc, average_volume_30d_calc, relative_volume_10d_calc | price_earnings_ttm, price_book_fq, dividend_yield_recent

⚠️ market_cap_basic is absolute ₹, NOT Cr (1 Cr = 10,000,000), so 5000 Cr = 50000000000.

EXAMPLE — oversold large-caps: [{"left":"RSI","operation":"less","right":30},{"left":"market_cap_basic","operation":"greater","right":50000000000}]

Inputs: limit, columns, filters, sort_by, +1 more.

screen_tapetide_scoresScreen & Rank by Tapetide ScoreA
Read-onlyIdempotent
Inspect

List and rank stocks by the Tapetide Score, filtered by size bucket, band, score window, sector, minimum data-confidence and symbol/name search. Rows come back in the server's final order with score, band, pillars, sector, size, market cap and a next-page cursor. USE THIS for 'which large caps score highest', 'show me Strong-band pharma stocks', or any rank/filter-by-Tapetide-Score question — same data and ordering as the tapetide.com ranking page. IMPORTANT, or you will describe the results wrongly: (1) present rows by BAND, never as an ordinal '#1, #2, #3' leaderboard — nothing has ever scored above 77 and neighbouring scores are not meaningfully different; (2) the DEFAULT view is large+mid cap at confidence >= 75, a filtered slice and not the whole market, so state the active filters (meta.counts) alongside any ranking; (3) sizes:["all"] adds small/micro caps — flag their liquidity risk (market cap is a size proxy, not liquidity); (4) quote meta.snapshot.score_date and reuse next_cursor to stay on that run. These are stocks matching the given Tapetide Score criteria, NOT investment recommendations. Decision-support only. The Tapetide Score is data analysis, not investment advice. Tapetide is not a SEBI-registered research analyst or investment adviser. Bands are intentionally coarse; small point differences may not be meaningful.

Inputs: q, sort, bands, limit, +7 more.

search_stocksSearch Indian StocksA
Read-onlyIdempotent
Inspect

Search ~8,000 Indian stocks by name, symbol, BSE code, or ISIN. Also matches common/brand names and post-rename aliases (e.g. 'Zomato'→ETERNAL, 'Infosys'→INFY). Listed companies rank first, then by match (exact symbol/code > prefix > word > contains), larger companies first within each; queries of 4+ characters tolerate typos. Each result's symbol is what the per-stock tools take as input.

Inputs: limit, query, sector, industry.

update_portfolio_stockUpdate Portfolio StockA
Destructive
Inspect

Update the quantity and/or average price of an existing stock in the user's portfolio.

Use cases: • User says "I bought 10 more RELIANCE at ₹1,400" → you must calculate the new total qty and weighted avg price, then call this tool • User says "Change my TCS quantity to 50" → direct update • User says "I sold 5 shares of INFY" → reduce quantity (calculate new qty = old - 5)

IMPORTANT workflow for additional purchases:

  1. First call get_user_portfolio to get current quantity and avg_price

  2. Calculate: new_qty = old_qty + additional_qty

  3. Calculate: new_avg = (old_qty × old_avg + additional_qty × purchase_price) / new_qty

  4. Call this tool with the NEW total quantity and NEW weighted average price

For partial sells:

  1. new_qty = old_qty - sold_qty (avg_price stays the same)

  2. If new_qty = 0, use remove_portfolio_stocks instead

Both quantity and avg_price are required — always provide the final values.

Inputs: symbol (required), quantity (required), avg_price (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to search, screen and analyze all 8,200+ NSE and BSE listed stocks, covering live quotes, financials, technical indicators, FII/DII flows, option chains, filings, IPOs and portfolio tracking through 55 tools.
      -
    • A
      license
      B
      quality
      D
      maintenance
      India-first financial data engine for MCP clients. Live NSE/BSE quotes, Nifty/Sensex indices, mutual fund NAV, earnings calendar, FII/DII activity, and daily market brief. 39 tools, no API key needed, free.
      95
      91 PyPI
      20
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Exposes live Indian stock market data from the National Stock Exchange (NSE) via 17 tools covering bulk/block deals, institutional flows, market data, corporate events, and short selling.
      17
      1
      Apache 2.0
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.