Skip to content
DalalOS

TOOL REFERENCE

Every tool your AI can call

DalalOS exposes 56 current, non-deprecated MCP capabilities. Most are read-only research tools; 2 account-scoped actions only add or remove symbols from your DalalOS watchlist.

For compatibility and debugging, this reference also keeps 2 deprecated aliases and the operational ping helper visible — 59 documented protocol names in total.

56
Current MCP capabilities
2
Account watchlist writes
Thousands
of NSE & BSE companies
0
Buy/sell calls or advice

START HERE

Connect, then ask a real question

Use the connector flow in Claude whenever it is available. It is the quickest path and authorizes securely through a sign-in popup; the configuration option is for clients that expect a config file or command.

RECOMMENDEDClaude connectors

Add a custom connector

  1. 1In Claude, open Settings → Connectors → Add custom connector.
  2. 2Paste this MCP URL: https://mcp.dalalos.in/mcp
  3. 3Choose Connect and complete the sign-in popup. No API key is required.

CONFIGURATION

Add the MCP config

For Claude Code and clients that use a configuration file or command, add DalalOS as a streamable HTTP server.

claude_desktop_config.json
{
  "mcpServers": {
    "dalal-os": {
      "url": "https://mcp.dalalos.in/mcp"
    }
  }
}
Verify the connection: ask “What is Reliance trading at, and where is it versus its 52-week range? Include the data source and freshness timestamp.” Need help? Read the connection guide.

WHAT CAN I ASK?

Start with the question, not the tool name

Check a company’s latest price, valuation and 52-week range

Try: “What is Reliance trading at, and where is it versus its 52-week range?”

Review revenue, margins, returns and debt across periods

Try: “Show TCS revenue, margins, ROCE and debt-to-equity for the last five years.”

Put comparable companies side by side

Try: “Compare Titan and Kalyan Jewellers on margins and debt-to-equity.”

Inspect shareholding and promoter-pledge history

Try: “Has promoter pledge in this company changed over the last year?”

Explore the market using transparent metric filters

Try: “Find IT-sector stocks with ROE over 20% and PE under 30.”

Check disclosed filings, dividends and result dates

Try: “Which companies are announcing results in the next two weeks?”

Search & discovery

search_stocks

Find a company by name, symbol, BSE code or ISIN

USE WHEN

Resolve a company from a name, ticker, BSE code or ISIN before asking anything else — usually the first tool your assistant calls.

PARAMETERS

search_stocks parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN. Typos are tolerated.
limitintegerNo10Max results, clamped 1–50.

RESPONSE DATA

  • A list of matches: isin, company_id, name, nse_symbol, bse_code, sector, industry, company_type.

NOTES

  • Resolution order: exact ISIN → exact NSE symbol → exact BSE code → fuzzy match → typo suggestion (reason_code: "typo_suggestion").

EXAMPLE PROMPTS

  • Find the ISIN for a stock called 'Infy' — I don't know the exact ticker.
Also available via REST: /searchOpen this tool’s reference

screen_stocks

Filter the entire market by valuation, quality and ownership metrics

USE WHEN

The screener: combine PE, ROE, debt, promoter holding, sector and 20+ other filters across thousands of NSE/BSE stocks.

PARAMETERS

screen_stocks parameters
NameTypeRequiredDefaultDescription
filtersobjectYes—Range filters (e.g. pe_min/pe_max, roe_min/roe_max) plus exact filters (sector, industry, company_type, index).
sort_bystringNomarket_capField to sort results by.
orderstringNodesc"asc" or "desc".
limitintegerNo25Max rows, clamped 1–100.

RESPONSE DATA

  • results — rows shaped like a quote+ratios row, each flagged if a value looks structurally off.
  • match_count, total_scanned, truncated (whether the scan was capped).

NOTES

  • Fraction-based metrics (ROE, ROA, ROCE, net margin, dividend/earnings/FCF yield) must be passed as fractions — 0.15, not 15. A bare percentage is rejected with a clear error rather than silently misfiltering.

EXAMPLE PROMPTS

  • Find IT-sector stocks with ROE over 20% and PE under 30.
Also available via REST: /screenOpen this tool’s reference

get_sector_overview

Sector or industry aggregates — median PE, PB, dividend yield

USE WHEN

Zoom out from one stock to a whole sector: median valuation and how many companies sit in it.

PARAMETERS

get_sector_overview parameters
NameTypeRequiredDefaultDescription
sectorstringNo—Omit to list every group at the chosen grain.
grainstringNosector"sector" | "igroup" | "isubgroup".

RESPONSE DATA

  • groups — name, count, total_market_cap, median_pe, mean_pe, median_pb, and (when precomputed) median_dividend_yield / median_return_1y.

EXAMPLE PROMPTS

  • What's the median PE and dividend yield across the banking sector right now?
Also available via REST: /sectorsOpen this tool’s reference

list_index_constituents

Every member stock of a named index

USE WHEN

All constituents of an index like NIFTY 50 or NIFTY BANK, ranked by market cap.

PARAMETERS

list_index_constituents parameters
NameTypeRequiredDefaultDescription
indexstringYes—Exact index name (case-insensitive).
limitintegerNo100Clamped 1–500.

RESPONSE DATA

  • constituents — isin, nse_symbol, name, sector, market_cap; sorted by market cap descending.

NOTES

  • An unrecognized index name comes back with a hint list of index names that do exist.

EXAMPLE PROMPTS

  • List every stock in the NIFTY IT index.
Also available via REST: /indices/{index}/constituentsOpen this tool’s reference

list_indices

Every index tracked, with member counts

USE WHEN

See what indices exist before asking for constituents or a heatmap.

PARAMETERS

No parameters.

RESPONSE DATA

  • indices — every distinct index name with its member count.

EXAMPLE PROMPTS

  • What indices do you track, and how many stocks are in each?
Also available via REST: /indicesOpen this tool’s reference

get_market_heatmap

Index constituents with multi-horizon returns

USE WHEN

See how every stock in an index has moved over 1 day to 1 year, side by side.

PARAMETERS

get_market_heatmap parameters
NameTypeRequiredDefaultDescription
indexstringYes—Exact index name.
limitintegerNo100Clamped 1–500.

RESPONSE DATA

  • constituents — market_cap, pe, pb, and precomputed returns (1d/1w/1m/3m/6m/1y) with return_flags for structural events.

NOTES

  • Deliberately sortable only by market cap — never by return — so this can't read as a "top movers" ranking.

EXAMPLE PROMPTS

  • Show me a heatmap of NIFTY 50 with 1-month and 1-year returns.
Also available via REST: /indices/{index}/heatmapOpen this tool’s reference

list_preset_screens

The 4 fixed, nightly-precomputed screens

USE WHEN

Ready-made screens like "low PE" or "high dividend yield, large cap" that refresh overnight — instant, no live computation.

PARAMETERS

No parameters.

RESPONSE DATA

  • presets — name, description, computed_at, stale.

EXAMPLE PROMPTS

  • What preset screens are available?
Also available via REST: /presetsOpen this tool’s reference

run_preset_screen

Run one of the fixed preset screens

USE WHEN

The latest results for a named preset (e.g. "low_leverage_high_roe") — precomputed overnight, never live.

PARAMETERS

run_preset_screen parameters
NameTypeRequiredDefaultDescription
namestringYes—Must match a name returned by list_preset_screens.

RESPONSE DATA

  • The stored screen_stocks-shaped result for that preset, verbatim.

NOTES

  • An uncomputed preset returns success with reason_code "no_data" rather than an error.

EXAMPLE PROMPTS

  • Show me the results of the high-dividend-yield, large-cap preset screen.
Also available via REST: /presets/{name}Open this tool’s reference

Quotes & prices

get_stock_quote

Latest end-of-day price, valuation ratios and 52-week range

USE WHEN

The one-stop quote: price, change, PE/PB, 52-week high/low and dividend info for a single stock.

PARAMETERS

get_stock_quote parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.

RESPONSE DATA

  • price, change, pct_change, day OHLC, prev_close, volume, turnover, market_cap.
  • pe, pb, week52_high/low (plus unadjusted variants).
  • recent_dividends, upcoming_dividends, dividend_yield.
  • valuation_flags / valuation_notes when a ratio looks structurally off (e.g. negative net worth nulls PE/PB).

NOTES

  • Prices are end-of-day (NSE bhavcopy) — never a real-time feed.

EXAMPLE PROMPTS

  • What's Reliance trading at, and where does that sit versus its 52-week range?
Also available via REST: /stocks/{q}/quoteOpen this tool’s reference

get_batch_quotes

Quotes for up to 20 stocks in one call

USE WHEN

The same data as get_stock_quote, for a whole watchlist at once — one bad ticker never fails the rest.

PARAMETERS

get_batch_quotes parameters
NameTypeRequiredDefaultDescription
symbolslist[string]Yes—Up to 20 symbols, ISINs or codes.

RESPONSE DATA

  • A per-symbol array: query, status, quote, cached_at, error, reason_code.

EXAMPLE PROMPTS

  • Give me quotes for RELIANCE, TCS, HDFCBANK, INFY and ICICIBANK.
Also available via REST: /quotesOpen this tool’s reference

get_price_history

Daily, weekly or monthly OHLCV bars

USE WHEN

Raw price history for charting or your own return calculations — split/bonus-adjusted on request.

PARAMETERS

get_price_history parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
daysintegerNo90Lookback window, clamped 1–1825.
adjustedbooleanNofalseRescale pre-event bars for splits/bonuses.
intervalstringNodaily"daily" | "weekly" | "monthly".

RESPONSE DATA

  • bars — date, open, high, low, close, prev_close, volume, turnover, num_trades, deliv_pct.
  • count, adjustments_applied.

NOTES

  • Auto-coarsens to weekly bars if a daily request would return more than 750 rows (resampled_reason).

EXAMPLE PROMPTS

  • Give me two years of weekly price history for TCS.
Also available via REST: /stocks/{q}/price-historyOpen this tool’s reference

get_returns

Mechanically-computed returns, volatility and drawdown

USE WHEN

1W/1M/3M/6M/1Y/YTD returns, CAGR, volatility and max drawdown — computed from the price series, not opinion.

PARAMETERS

get_returns parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.

RESPONSE DATA

  • returns (1W/1M/3M/6M/1Y/YTD/max), cagr, annualized_volatility, max_drawdown, high_52w, low_52w.

NOTES

  • A window spanning a major corporate action (e.g. a demerger) is nulled rather than reported as a distorted figure.

EXAMPLE PROMPTS

  • What's the 1-year and 3-year return for this stock, and its max drawdown?
Also available via REST: /stocks/{q}/returnsOpen this tool’s reference

get_technical_indicators

Mechanically-computed technical indicators

USE WHEN

Read moving averages, RSI, MACD, Bollinger Bands, volatility and beta from the cached price series.

PARAMETERS

get_technical_indicators parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.

RESPONSE DATA

  • latest indicators (moving averages, RSI, MACD, Bollinger Bands, volatility, beta) and their time series.
  • circuit_band_pct, circuit_band_as_of, circuit_hit_days — raw/unadjusted-close circuit-filter fields with distinct null reasons.
  • insufficient_history — list of indicators skipped because the cached price series was too short.

NOTES

  • Indicators are calculations over cached end-of-day prices, not trading signals or recommendations.

EXAMPLE PROMPTS

  • Show the technical indicators for TCS and include the calculation window.
Also available via REST: /stocks/{q}/technical-indicatorsOpen this tool’s reference

Financials & ratios

get_financials

Quarterly or annual P&L, balance sheet and computed ratios

USE WHEN

Revenue, margins, ROE/ROCE and debt ratios pulled from SEBI BSE-XBRL filings — adapted automatically for banks, NBFCs and insurers.

PARAMETERS

get_financials parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
period_typestringNoquarterly"quarterly" | "annual".
limitintegerNo8Number of periods, clamped 1–12.

RESPONSE DATA

  • periods — income, balance_sheet, ratios (margins, or asset-quality for banks/NBFCs), optional cash_flow (annual only, incl. free_cash_flow).
  • ttm — trailing-twelve-month figures.
  • growth — YoY and 3y/5y CAGR per metric, with base-effect and demerger caveats.

NOTES

  • Company-type aware: banks/NBFCs surface NII and GNPA/NNPA instead of a generic P&L; insurers surface premium income.

EXAMPLE PROMPTS

  • Show me TCS revenue, margins, ROCE and debt-to-equity for the last 5 years.
Also available via REST: /stocks/{q}/financialsOpen this tool’s reference

get_company_profile

One-call company snapshot: identity, market data and fundamentals

USE WHEN

A single roll-up of who a company is, what it trades at, and its latest fundamentals, in one call.

PARAMETERS

get_company_profile parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.

RESPONSE DATA

  • identity — sector, industry, indices, face value, listing date, company_type.
  • market — price, pe, pb, market_cap, week52 range (null if no quote cached).
  • fundamentals — latest-period and TTM headline figures and margins (null if none cached), fundamentals_available flag.

NOTES

  • Assembled purely from cache — no new upstream fetch — so it's fast and always consistent with the other tools.

EXAMPLE PROMPTS

  • Give me a quick profile of Asian Paints — sector, current valuation, and latest margins.
Also available via REST: /stocks/{q}/profileOpen this tool’s reference

get_brsr

Raw BRSR sustainability disclosures

USE WHEN

Read reported emissions, energy, water, waste, workforce and other BRSR figures from company filings.

PARAMETERS

get_brsr parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
yearsintegerNo3Lookback window, clamped 1–10.
include_rawbooleanNofalseInclude additional raw filing fields.

RESPONSE DATA

  • Reported BRSR metrics, filing period, source and extraction metadata.

NOTES

  • Raw disclosures only — no ESG score or rating is produced.
  • Coverage starts only from whenever the nightly refresh job began ingesting that company's BRSR filings, not from its first-ever filed BRSR.

EXAMPLE PROMPTS

  • Show the latest BRSR energy and emissions figures for Reliance.
Also available via REST: /stocks/{q}/brsrOpen this tool’s reference

get_company_operating_metrics

Source-grounded operating KPI history

USE WHEN

Read company-disclosed operating KPIs over time, preserving what was disclosed and what was not rather than filling gaps with inference.

PARAMETERS

get_company_operating_metrics parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.
metricslist[string]No—Optional metric-key filter.
from_datedateNo—Optional ISO start date.
to_datedateNo—Optional ISO end date.
latest_onlybooleanNofalseReturn only the latest observation per requested metric.
limitintegerNo100Maximum observations returned, subject to the server cap.

RESPONSE DATA

  • Reported operating-metric observations with metric key/value or text, unit, as-of/disclosure dates, source evidence and coverage status.

NOTES

  • Coverage distinguishes disclosed values from not-disclosed fields; DalalOS does not infer a current KPI from a related announcement.

EXAMPLE PROMPTS

  • Show the latest disclosed operating metrics for this company and their source context.
Open this tool’s reference

get_company_report

Canonical source-linked company research report

USE WHEN

Assemble one validated company report from sourced facts, mechanical calculations, evidence-referenced claims, recent events and explicit coverage gaps.

PARAMETERS

get_company_report parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.
daysintegerNo90Disclosure/reporting window, clamped 1–365.

RESPONSE DATA

  • company_report_v1 — company identity, source-linked facts/citations, mechanically-computed calculations, evidence-referenced claims, materiality-bucketed events and coverage gaps.

NOTES

  • Read-only and source-linked: every numeric claim references supporting evidence/calculation, and the validator rejects target-price or buy/sell language.
  • This is DalalOS's consolidated report contract; similarly named tools from another connected server are separate sources.

EXAMPLE PROMPTS

  • Build a source-linked company report for RELIANCE using the last 90 days of relevant disclosures.
Open this tool’s reference

get_valuation_history

Point-in-time P/E and price-to-sales history

USE WHEN

Read historical valuation points using only filings that were public on each trade date, so later results are not back-applied to earlier dates.

PARAMETERS

get_valuation_history parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.
daysintegerNo365Lookback window, clamped 1–1825.
intervalstringNodailydaily | weekly | monthly.

RESPONSE DATA

  • Points with date, close, P/E, price-to-sales and the financial-period/filed-at basis used for that date, plus count/truncation metadata.

NOTES

  • Daily output auto-coarsens to weekly if it would exceed 750 points.
  • Each valuation point uses the latest TTM filing that was public on that trade date; no look-ahead filing data is applied.

EXAMPLE PROMPTS

  • Show five years of monthly point-in-time valuation history for TCS.
Open this tool’s reference

Peer comparison

get_peer_comparison

Auto-selected peer group with valuation & profitability medians

USE WHEN

Compare a company against its actual industry peers — sized and grouped automatically, not a hand-picked watchlist.

PARAMETERS

get_peer_comparison parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
limitintegerNo8Max peers, capped at 15.

RESPONSE DATA

  • peers — market_cap, price, pe, pb, revenue_ttm, net_income_ttm, net_margin, roe/roa/roce, ev multiples, price-to-fcf, debt_to_equity, is_query.
  • peer_medians — pe, pb, net_margin, roe.
  • grain, grain_value, grain_widened, size_banded, peer_count.

NOTES

  • Peers are picked by SEBI industry classification (isubgroup, widening to igroup if fewer than 4 peers) within a 0.1x–10x market-cap band.

EXAMPLE PROMPTS

  • Compare HDFC Bank against its peers on PE, PB and ROE.
Also available via REST: /stocks/{q}/peersOpen this tool’s reference

get_relevant_peers

Purpose-specific, explainable peer selection

USE WHEN

Choose a smaller evidence-backed peer set for operating, financial or valuation comparison instead of relying only on broad industry membership.

PARAMETERS

get_relevant_peers parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.
purposestringNooperatingoperating | financial | valuation.
event_contextstringNo—Optional public event/context text used only as declared comparison context.
limitintegerNo8Peer count, clamped 1–15.

RESPONSE DATA

  • Selected peers with company/market fields, comparison metrics, business-tag evidence and explainable inclusion/override context for the chosen purpose.

NOTES

  • Insufficient reviewed evidence returns fewer peers rather than silently broadening a thin peer group into a claimed operating peer set.
  • Use get_peer_comparison for the broader automatic sector/industry comparison table.

EXAMPLE PROMPTS

  • Find the most relevant operating peers for this company and explain why each peer belongs.
Open this tool’s reference

Ownership & risk

get_shareholding

Promoter, FII, DII and public holding over time

USE WHEN

Track how promoter, FII, DII and public ownership has shifted quarter to quarter — the raw holding percentages as disclosed.

PARAMETERS

get_shareholding parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
limitintegerNo8Number of quarters, clamped ≤12.

RESPONSE DATA

  • periods — period_end, promoter_pct, fii_pct, dii_pct, public_category_total_pct, and a pledge/lock-in detail breakdown when filed.

NOTES

  • Filed quarterly — this updates roughly every 90 days.

EXAMPLE PROMPTS

  • How has promoter and FII holding in Adani Power changed over the last two years?
Also available via REST: /stocks/{q}/shareholdingOpen this tool’s reference

get_pledge_trend

Promoter share-pledge percentage over time

USE WHEN

How much of the promoter's stake is pledged against loans, quarter by quarter, and whether that share is rising or falling — reported as filed.

PARAMETERS

get_pledge_trend parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
limitintegerNo12Number of quarters, clamped ≤16.

RESPONSE DATA

  • periods — period_end, promoter_pct, pledged_pct, pledged_shares, locked_in_pct, voting_rights_pct.
  • latest_pledged_pct, pledge_change_vs_prev.

EXAMPLE PROMPTS

  • Is promoter pledge in this company rising or falling?
Also available via REST: /stocks/{q}/pledge-trendOpen this tool’s reference

get_company_exposures

Reviewed company exposures to macro factors

USE WHEN

Read the company's reviewed, source-grounded exposure pathways to factors such as commodities, currencies or rates — evidence only, not a causal forecast.

PARAMETERS

get_company_exposures parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.

RESPONSE DATA

  • Reviewed exposures with factor key/label/dimension, directness, direction, lag, mechanism, sensitivity, mitigants/scope and source evidence where recorded.

NOTES

  • This is the plain evidence listing. Use get_company_macro_exposures when you also need eligibility against supported official macro windows.
  • No reviewed exposure returns an empty success result; DalalOS does not infer an exposure from sector membership or price movement.

EXAMPLE PROMPTS

  • What reviewed macro-factor exposures are documented for this company?
Open this tool’s reference

Corporate actions & events

get_dividends

Dividend history, trailing yield and payout ratio

USE WHEN

Every cash dividend a company has paid, plus trailing yield and payout ratio against the latest price.

PARAMETERS

get_dividends parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
yearsintegerNo5Lookback window, clamped.

RESPONSE DATA

  • dividends — ex_date, type, amount, record_date, payment_date.
  • annual_totals, trailing_12m_dividend, dividend_yield, payout_ratio.

NOTES

  • A dividend declared only as % of face value (not ₹) is marked amount_unavailable rather than guessed.

EXAMPLE PROMPTS

  • What dividends has Infosys paid over the last 5 years, and what's the trailing yield?
Also available via REST: /stocks/{q}/dividendsOpen this tool’s reference

get_corporate_actions

Full corporate-action timeline: splits, bonuses, buybacks, mergers

USE WHEN

Every disclosed corporate action in one timeline, not just dividends — useful for understanding a jump in the price series.

PARAMETERS

get_corporate_actions parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
yearsintegerNo5Lookback window, clamped.
typeslist[string]No—Filter to specific event types (e.g. "split", "bonus").

RESPONSE DATA

  • actions — ex_date, event_type, sub_type, ratio_text, amount, record_date, payment_date, raw_purpose.

EXAMPLE PROMPTS

  • Has this company done a stock split, bonus issue or buyback in the last 5 years?
Also available via REST: /stocks/{q}/corporate-actionsOpen this tool’s reference

get_stock_events

Recent regulatory announcements and filings

USE WHEN

The BSE announcement feed for a company — headlines and categories, so you know what's been disclosed recently.

PARAMETERS

get_stock_events parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
daysintegerNo30Clamped 1–365.
categorystringNo—Filter to one announcement category.

RESPONSE DATA

  • events — filed_at, category, sub_category, subject, headline, attachment_url, critical.

NOTES

  • Metadata only — attachment PDFs are linked, not parsed. Quarterly results are excluded here; use get_financials instead.

EXAMPLE PROMPTS

  • What has this company announced to the exchange in the last month?
Also available via REST: /stocks/{q}/eventsOpen this tool’s reference

get_upcoming_results

Board-meeting / results calendar across the market

USE WHEN

See which companies have results due in the next couple of weeks, market-wide or filtered by sector.

PARAMETERS

get_upcoming_results parameters
NameTypeRequiredDefaultDescription
daysintegerNo14Look-ahead window, clamped 1–90.
sectorstringNo—Filter to one sector.
limitintegerNo50Clamped 1–200.

RESPONSE DATA

  • results — meeting_date, bse_code, isin, nse_symbol, name, sector.

EXAMPLE PROMPTS

  • Which companies are announcing results in the next two weeks?
Also available via REST: /results-calendarOpen this tool’s reference

get_filing_extract

Grounded facts extracted from a filing

USE WHEN

Read source-grounded facts from a selected filing after finding it in the company events feed.

PARAMETERS

get_filing_extract parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
news_idstringYes—Filing/news identifier returned by get_stock_events.

RESPONSE DATA

  • Extracted facts with source quotes, page references, filing metadata and guard status.
  • On a cache miss: status ("pending"/"failed"/"not_queued"), queued flag, and attachment_url so the raw filing is still reachable.

NOTES

  • Call get_stock_events first to find a news_id.
  • A cache miss usually enqueues on-demand extraction (status "pending", retry in ~1–2 min) rather than failing outright.
  • reason_code on a non-pending miss: "not_queued" (with sub-reasons "results_available_via_financials" or "no_document_to_extract") or "failed" (with error_reason), plus "on_demand_quota_exceeded" if the caller is rate-limited.

EXAMPLE PROMPTS

  • Extract the reported facts from this company's latest investor presentation filing.
Also available via REST: /stocks/{q}/filings/{news_id}/extractOpen this tool’s reference

list_announcement_buckets

Disclosure categories available for discovery

USE WHEN

List the controlled announcement buckets before exploring market-wide disclosures.

PARAMETERS

No parameters.

RESPONSE DATA

  • buckets — a fixed, server-defined list of {id, label} pairs, plus a total count.

NOTES

  • This registry is not cache-derived — it's always fresh, unlike the announcements returned by get_announcement_bucket.

EXAMPLE PROMPTS

  • What announcement categories can I explore?
Also available via REST: /bucketsOpen this tool’s reference

get_announcement_bucket

Market-wide disclosures by category

USE WHEN

Browse recent exchange announcements grouped by a known disclosure bucket.

PARAMETERS

get_announcement_bucket parameters
NameTypeRequiredDefaultDescription
bucketstringYes—Bucket id returned by list_announcement_buckets.
daysintegerNo7Lookback window, clamped 1–90.

RESPONSE DATA

  • events — company identifiers, filed_at, headline, category, source attachment, and news_id (usable with get_filing_extract).
  • truncated, total_scanned — rows are capped at 200.

NOTES

  • An unrecognized bucket id returns bad_request with the list of valid ids.

EXAMPLE PROMPTS

  • Show recent major order-win announcements across the market.
Also available via REST: /buckets/{bucket}Open this tool’s reference

get_market_calendar

Market-wide event calendar

USE WHEN

Bring results, dividends, splits, bonuses, demergers and other market events into one date range.

PARAMETERS

get_market_calendar parameters
NameTypeRequiredDefaultDescription
date_fromdateYes—ISO start date.
date_todateYes—ISO end date, on or after date_from; window capped at 180 days.
typeslist[string]No—Subset of results, dividend, split, bonus, demerger, ipo, consolidation, rights, buyback, spinoff, merger, distribution, other. Unknown type is rejected.
limitintegerNo500Clamped 1–2000.

RESPONSE DATA

  • events — date, type, isin, nse_symbol, name, detail; merged from the results calendar and corporate-action disclosures, sorted chronologically.

NOTES

  • The "ipo" type is currently a stub with no data source — it always returns zero rows with an explanatory note, not an error.

EXAMPLE PROMPTS

  • What Indian stock-market events are scheduled for next week?
Also available via REST: /calendarOpen this tool’s reference

get_ipos

Upcoming and recently listed IPO facts

USE WHEN

Read IPO status, dates, price bands, issue details and listing facts where available.

PARAMETERS

get_ipos parameters
NameTypeRequiredDefaultDescription
statusstringNo—"upcoming" | "open" | "listed"; omitted returns all three. Unknown value is rejected.
limitintegerNo100Clamped 1–500.

RESPONSE DATA

  • IPO name, issuer, status (derived at read time from today's IST date, never stale), price band, face value, lot size, issue size, dates, category-wise subscription x-times where disclosed, and a DRHP/prospectus link.
  • listing_gain_pct — mechanically computed as (listing_price − issue_price) / issue_price; null pre-listing.

NOTES

  • No Grey Market Premium (GMP) field is ever returned — GMP has no official exchange source, so it's deliberately excluded under the SEBI-RA raw-facts-only line.

EXAMPLE PROMPTS

  • Which Indian IPOs are upcoming or currently open?
Also available via REST: /iposOpen this tool’s reference

get_event_context

Historical context for one canonical filing event

USE WHEN

Read evidence-backed context around a previously extracted filing, including its disclosure thread and unresolved factual follow-ups where available.

PARAMETERS

get_event_context parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.
news_idstringYes—Filing/news identifier returned by disclosure/event tools.

RESPONSE DATA

  • Canonical event fields with source evidence, related prior/context events, event-family timeline and open factual questions where available.

NOTES

  • This reads already-canonicalized evidence; if a filing is not extracted yet, use get_filing_extract first.
  • It does not infer business causality or correlate the filing with price moves or external news.

EXAMPLE PROMPTS

  • Show the historical context for this filing news_id and the related disclosure timeline.
Open this tool’s reference

search_company_disclosures

Search page-preserving company filing text

USE WHEN

Search already indexed official filings for one company and return matched passages with their original PDF page references and coverage metadata.

PARAMETERS

search_company_disclosures parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.
search_textstringYes—Text terms to search across indexed filing pages.
from_datedateNo—Optional ISO start date.
to_datedateNo—Optional ISO end date.
document_typeslist[string]No—Optional document-type filters, up to 20 values.
limitintegerNo10Result count, clamped 1–20.

RESPONSE DATA

  • Matched filing passages with news_id, filed date/category/subject, document type, original source_page, attachment URL, match terms and coverage metadata.

NOTES

  • Search covers only already indexed filings whose page boundaries were preserved; older parsed filings without page indexes are reported in coverage rather than silently searched without citations.
  • No upstream fetch occurs on this search path.

EXAMPLE PROMPTS

  • Search this company's indexed filings for 'capacity expansion' and show the source pages.
Open this tool’s reference

Market context

get_bulk_block_deals

Bulk and block deal disclosures

USE WHEN

Inspect exchange-reported bulk and block deals with date, security, quantity and price details.

PARAMETERS

get_bulk_block_deals parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.
deal_typestringNo—"bulk" or "block"; omitted returns both.
daysintegerNo90Trailing lookback window, clamped 1–1825.
limitintegerNo100Max rows, newest first, clamped 1–500.

RESPONSE DATA

  • deals — trade_date, client_name, buy_sell ("BUY"/"SELL"), quantity, price, remarks (bulk only).
  • One row per counter-party + direction, not a matched buyer/seller pair — NSE doesn't publish that pairing.

NOTES

  • Only NSE's most-recently-published trading day is fetched upstream (no reachable historical bulk/block archive) — coverage starts from whenever the nightly refresh job began running, not further back.

EXAMPLE PROMPTS

  • Show bulk and block deals for the last two weeks.
Also available via REST: /stocks/{q}/bulk-block-dealsOpen this tool’s reference

get_derivatives_positioning

Per-stock or index F&O positioning

USE WHEN

Read futures/open-interest changes, call/put open interest, PCR and F&O-ban status for an underlying.

PARAMETERS

get_derivatives_positioning parameters
NameTypeRequiredDefaultDescription
querystringYes—Stock identifier or raw index name such as NIFTY or BANKNIFTY.

RESPONSE DATA

  • Underlying, futures OI/OI change, call/put OI, PCR, volume and ban-list status.

NOTES

  • PCR is a mechanically-computed ratio, not a signal or recommendation.

EXAMPLE PROMPTS

  • Show the latest derivatives positioning for NIFTY and RELIANCE.
Also available via REST: /stocks/{q}/derivatives-positioningOpen this tool’s reference

get_fo_participant_activity

Market-wide F&O participant activity

USE WHEN

Compare daily FII, DII, proprietary and client open interest and volume across the derivatives segment.

PARAMETERS

get_fo_participant_activity parameters
NameTypeRequiredDefaultDescription
daysintegerNo30Lookback window, clamped 1–366.

RESPONSE DATA

  • Daily participant-wise open interest, change and volume across the F&O segment.

EXAMPLE PROMPTS

  • Show FII and client F&O positioning for the last 30 days.
Also available via REST: /fo-participant-activityOpen this tool’s reference

get_fii_dii_flow

Deprecated alias — market-wide daily FII/DII cash flows

USE WHEN

Compatibility alias for get_market_fii_dii_flow; use the current name for new integrations.

PARAMETERS

get_fii_dii_flow parameters
NameTypeRequiredDefaultDescription
from_datedateNo—ISO start date.
to_datedateNo—ISO end date.
segmentstringNocashCash only. Use get_fo_participant_activity for F&O participant positioning.

RESPONSE DATA

  • Daily buy, sell and net flow values in Rs crore with per-row source provenance.

NOTES

  • Deprecated compatibility alias; prefer get_market_fii_dii_flow.
  • This is market-wide flow; it is distinct from per-company quarterly shareholding.
  • source varies by date range — "nse", "moneycontrol", or "mixed" — not a single fixed provider label.

EXAMPLE PROMPTS

  • Show market-wide FII and DII net cash flows for the last month.
Also available via REST: /fii-diiOpen this tool’s reference

get_index_valuation

Index valuation history

USE WHEN

Read NSE-sourced index-level PE, PB and dividend-yield time series, including sector indices.

PARAMETERS

get_index_valuation parameters
NameTypeRequiredDefaultDescription
indexstringYes—Index name.
from_datedateNo—ISO start date.
to_datedateNo—ISO end date.

RESPONSE DATA

  • Index valuation rows with date, PE, PB, dividend yield and source.

NOTES

  • An unrecognized index name returns reason_code "no_data" with an available_indices_hint rather than a bare error.

EXAMPLE PROMPTS

  • Show NIFTY IT valuation history over the last year.
Also available via REST: /index-valuations/{index}Open this tool’s reference

get_india_vix

India VIX history

USE WHEN

Read the NSE-sourced India VIX time series as a market-volatility fact.

PARAMETERS

get_india_vix parameters
NameTypeRequiredDefaultDescription
from_datedateNo—ISO start date.
to_datedateNo—ISO end date.

RESPONSE DATA

  • Date, open, high, low, close, points change and percentage change.

NOTES

  • This is DalalOS's own India VIX series — if another connected MCP server also exposes a VIX tool, treat them as separate, non-interchangeable series.

EXAMPLE PROMPTS

  • Show India VIX over the last 30 days.
Also available via REST: /india-vixOpen this tool’s reference

get_market_breadth

Whole-market advance/decline breadth

USE WHEN

Read daily advancing, declining and unchanged security counts across the market.

PARAMETERS

get_market_breadth parameters
NameTypeRequiredDefaultDescription
from_datedateNo—ISO start date.
to_datedateNo—ISO end date.

RESPONSE DATA

  • Daily advances, declines, unchanged counts and breadth fields.

NOTES

  • NSE publishes no bulk historical archive for this figure — an empty result for a genuinely old date is expected, not a bug.

EXAMPLE PROMPTS

  • Show market breadth for the last two weeks.
Also available via REST: /market-breadthOpen this tool’s reference

get_macro_indicators

Official India macroeconomic indicators

USE WHEN

Read official CPI, WPI, IIP, GDP and Indian basket crude-oil series for market context.

PARAMETERS

get_macro_indicators parameters
NameTypeRequiredDefaultDescription
datasetstringYes—"cpi" | "wpi" | "iip" | "gdp" | "crude_basket"; any other value is rejected.
from_periodstringNo—Starting period — "YYYY-MM" for cpi/wpi/iip/crude_basket, fiscal-year string e.g. "2024-25" for gdp.
to_periodstringNo—Ending period, same format as from_period.
series_containsstringNo—Substring filter on series_key (e.g. "Food", "Manufacturing"); a no-op for crude_basket, which has only one series.
limitintegerNo200Clamped 1–2000, newest period first.

RESPONSE DATA

  • Officially reported macro observations with period, series, value, unit and source.

EXAMPLE PROMPTS

  • Show India's CPI, GDP growth and crude-oil indicators for the latest available periods.
Also available via REST: /macro/indicatorsOpen this tool’s reference

get_fx_reference_rates

FBIL INR reference exchange rates

USE WHEN

Read daily official INR reference rates for supported currency pairs.

PARAMETERS

get_fx_reference_rates parameters
NameTypeRequiredDefaultDescription
currency_pairstringNo—Supported pair such as USD/INR.
from_datedateNo—ISO start date.
to_datedateNo—ISO end date.

RESPONSE DATA

  • Date, currency pair, reference rate and source.

NOTES

  • FBIL's upstream feed only serves a rolling ~2-day window with no bulk historical archive — a wide date range may legitimately return far fewer rows than requested.

EXAMPLE PROMPTS

  • Show the USD/INR reference rate for the last month.
Also available via REST: /macro/fx-ratesOpen this tool’s reference

get_sector_fii_flow

Daily FII/FPI transaction flow by sector

USE WHEN

Read available CDSL-sourced daily FII/FPI transaction activity aggregated by sector.

PARAMETERS

get_sector_fii_flow parameters
NameTypeRequiredDefaultDescription
from_datedateNo—ISO start date.
to_datedateNo—ISO end date.
sectorstringNo—Optional sector filter.

RESPONSE DATA

  • Sector-level daily transaction flow, totals, changes and coverage note.

NOTES

  • CDSL-only coverage is partial, not a complete view of all FII/FPI activity.

EXAMPLE PROMPTS

  • Which sectors saw the most reported FII activity this month?
Also available via REST: /fii-dii/sectorsOpen this tool’s reference

get_fii_activity

Deprecated alias — daily per-stock FII/FPI transaction flow

USE WHEN

Compatibility alias for get_stock_fii_flow; use the current name for new integrations.

PARAMETERS

get_fii_activity parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, symbol, code or ISIN.
daysintegerNo90Lookback window.

RESPONSE DATA

  • Per-day transaction activity, summaries and coverage note.

NOTES

  • Deprecated compatibility alias; prefer get_stock_fii_flow.
  • CDSL-only coverage is partial, not a complete view of all FII/FPI activity.

EXAMPLE PROMPTS

  • Show the reported FII activity for RELIANCE over the last 90 days.
Also available via REST: /stocks/{q}/fii-activityOpen this tool’s reference

get_company_macro_exposures

Company exposure evidence with eligible official macro context

USE WHEN

Combine reviewed company exposure pathways with supported official macro windows when the evidence and coverage policy allow eligible macro context.

PARAMETERS

get_company_macro_exposures parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.
factorslist[string]No—Optional factor-key filter; up to 12 factors.
as_of_datedateNo—Optional ISO date used to evaluate the supported macro window.

RESPONSE DATA

  • Reviewed company exposure evidence, eligible official context signals, and explicit coverage/eligibility status for requested factors.

NOTES

  • A macro signal is conditional context only — it never claims that a macro move caused or will cause earnings, price or investment outcomes.
  • Use get_company_exposures for the simpler reviewed exposure list without macro-window eligibility evaluation.

EXAMPLE PROMPTS

  • Show this company's reviewed crude-oil and USD/INR exposures with eligible official macro context.
Open this tool’s reference

get_fno_ban_list

Current NSE F&O securities-in-ban list

USE WHEN

Return the complete latest published F&O ban list in one market-wide call instead of checking one underlying at a time.

PARAMETERS

No parameters.

RESPONSE DATA

  • Latest available ban-date snapshot with every banned symbol/index in that snapshot and source/freshness context.

NOTES

  • Use get_derivatives_positioning when the question is about one underlying's positioning and its in_ban_list flag; this tool is the whole-list view.

EXAMPLE PROMPTS

  • Which securities are on the latest available NSE F&O ban list?
Open this tool’s reference

get_market_fii_dii_flow

Market-wide daily FII/DII cash flows

USE WHEN

Read daily market-wide FII/DII cash-market transaction totals and mechanically-computed net flows with per-date provenance.

PARAMETERS

get_market_fii_dii_flow parameters
NameTypeRequiredDefaultDescription
from_datedateNo—Optional ISO start date; omitted uses the trailing window.
to_datedateNo—Optional ISO end date; the window is capped at 366 days.
segmentstringNocashCash only. Use get_fo_participant_activity for F&O participant positioning.

RESPONSE DATA

  • Daily trade_date, FII/DII buy, sell and net values in Rs crore, plus the source for each row.

NOTES

  • This is market-wide cash flow, distinct from sector/stock FII transaction-flow tools and quarterly shareholding.
  • Historical and recent rows can have different provenance; the envelope reports the shared source or mixed while each row retains its own source.

EXAMPLE PROMPTS

  • Show market-wide FII and DII cash flows for the last month.
Open this tool’s reference

get_stock_fii_flow

Daily per-stock FII/FPI transaction flow

USE WHEN

Read available CDSL-sourced daily FII/FPI transaction activity for one listed company, with an explicit partial-coverage note.

PARAMETERS

get_stock_fii_flow parameters
NameTypeRequiredDefaultDescription
querystringYes—Company name, NSE symbol, BSE code or ISIN.
daysintegerNo90Lookback window, clamped 1–3650.

RESPONSE DATA

  • Per-day FII/FPI buy, sell and mechanically-computed net transaction values, plus period summary and coverage context.

NOTES

  • CDSL-only transaction coverage is partial and is not the same dataset as quarterly foreign holding percentage.
  • get_fii_activity is the deprecated compatibility alias for this tool.

EXAMPLE PROMPTS

  • Show reported FII transaction flow for RELIANCE over the last 90 days.
Open this tool’s reference

get_top_movers

Mechanically ranked index movers and most-active names

USE WHEN

Rank one index's constituents for a completed EOD session by day change, traded value or volume — a raw sort, not an investment ranking.

PARAMETERS

get_top_movers parameters
NameTypeRequiredDefaultDescription
indexstringNoNIFTY 500Index name returned by list_indices.
metricstringNopct_changepct_change | change | turnover | volume.
directionstringNodescdesc for largest/highest activity or asc for lowest/losers.
limitintegerNo20Maximum rows, clamped 1–100.

RESPONSE DATA

  • Ranked constituent rows for one completed EOD session with price/change/activity fields and the requested mechanical sort context.

NOTES

  • Distinct from get_market_heatmap: the heatmap is deliberately market-cap sorted and not return-sortable; this tool explicitly performs caller-chosen raw ranking.
  • A sorted mover list is descriptive market data, not a recommendation or signal.

EXAMPLE PROMPTS

  • Show the largest NIFTY 500 gainers by day percentage change, limited to 20 rows.
Open this tool’s reference

Watchlists

get_watchlist

Read your DalalOS watchlist

USE WHEN

Retrieve your saved stock symbols with best-effort company enrichment.

PARAMETERS

No parameters.

RESPONSE DATA

  • Symbols, added timestamps and optional name, sector and market-cap enrichment (best-effort; a delisted/renamed symbol still returns as a bare row rather than failing the call).

NOTES

  • Account-scoped and requires OAuth or API-key authentication; this is not a portfolio (no quantity or cost basis).
  • reason_code "unauthorized" if unauthenticated, "not_configured" if the deployment has no watchlist backend wired up.
  • Has a REST equivalent: GET /v1/account/watchlist, same credential (API key or OAuth) as this tool.

EXAMPLE PROMPTS

  • Show my DalalOS watchlist.
Open this tool’s reference

add_to_watchlist

Save stocks to your DalalOS watchlist

USE WHEN

Add one or more symbols to your account-scoped watchlist for later research.

PARAMETERS

add_to_watchlist parameters
NameTypeRequiredDefaultDescription
symbolslist[string]Yes—Non-empty list of NSE symbols, ISINs or BSE codes, capped at 200 items per call. Stored as typed — not resolved against the securities master until get_watchlist reads them back.

RESPONSE DATA

  • Updated watchlist result and added symbols.

NOTES

  • Account-scoped write action; it does not store quantity, cost basis or orders.
  • Re-adding a symbol already on the watchlist is a no-op, not an error.
  • reason_code "unauthorized" if unauthenticated, "not_configured" if the deployment has no watchlist backend wired up.
  • Has a REST equivalent: POST /v1/account/watchlist, same credential (API key or OAuth) as this tool.

EXAMPLE PROMPTS

  • Add RELIANCE, TCS and INFY to my DalalOS watchlist.
Open this tool’s reference

remove_from_watchlist

Remove a stock from your watchlist

USE WHEN

Remove one saved symbol from your DalalOS watchlist.

PARAMETERS

remove_from_watchlist parameters
NameTypeRequiredDefaultDescription
symbolstringYes—NSE symbol, ISIN or BSE code to remove.

RESPONSE DATA

  • Removal status and updated watchlist state.

NOTES

  • Account-scoped write action; it does not place trades.
  • reason_code "not_found" if the symbol isn't currently on the caller's watchlist; "unauthorized"/"not_configured" for auth/deployment issues.
  • Has a REST equivalent: DELETE /v1/account/watchlist/{symbol}, same credential (API key or OAuth) as this tool.

EXAMPLE PROMPTS

  • Remove INFY from my DalalOS watchlist.
Open this tool’s reference

System

ping

Health check

USE WHEN

Confirms the server is reachable — useful when wiring up a new MCP client.

PARAMETERS

No parameters.

RESPONSE DATA

  • message: "pong".

EXAMPLE PROMPTS

  • Ping the server.
Open this tool’s reference

get_data_freshness

Per-data-domain freshness and job status

USE WHEN

See exactly when each data domain (prices, financials, shareholding, ...) last refreshed, and whether it's stale.

PARAMETERS

No parameters.

RESPONSE DATA

  • Per-job status, age and staleness; an overall status.

EXAMPLE PROMPTS

  • How fresh is the underlying data right now?
Also available via REST: /freshnessOpen this tool’s reference

How it works

01

Connect once

Add the MCP server to your AI client with one line of config.

02

Ask in plain English

Your assistant maps the question to one or several tools.

03

Get sourced answers

Market-data responses carry source and freshness context.

More things you could ask

EXAMPLE PROMPTS

  • Screen for low-leverage, high-ROE stocks in the FMCG sector.
  • Compare Titan and Kalyan Jewellers on margins and debt-to-equity.
  • Has promoter pledge in this company gone up in the last year?
  • Which stocks in NIFTY 500 report results in the next 10 days?
  • Show delivery percentage trend for this stock over the last quarter.

Need help getting started? Read the guided documentation or open the connection guide.

FAQ

Common questions

How many tools does DalalOS expose?

DalalOS has 56 current, non-deprecated MCP capabilities. This reference also documents 2 deprecated compatibility aliases and the operational ping helper, for 59 documented protocol-visible names in total.

Are all DalalOS tools read-only?

Market-data and research capabilities are read-only. The 2 explicit write actions only add or remove symbols from the authenticated caller's own DalalOS watchlist; they do not place market orders or modify a brokerage portfolio.

Do I need to write code to use these tools?

No. Once your AI client is connected, you just ask in plain English — your assistant picks the right tool and parameters for you. Developers can also call tools directly through any MCP client.

Where can I see the exact parameters and response fields?

This page is the full public technical reference: every parameter, default, and output field for all 59 documented names, including compatibility aliases and operational ping.

Does any tool give a buy, sell or target-price signal?

No. Research capabilities return sourced facts or mechanically-computed measures, not verdicts, recommendations or target prices. The watchlist write actions only save or remove symbols from the caller's DalalOS account.

KEEP EXPLORING

Connect your AI to Indian stock market data

Sign in to DalalOS and connect your AI in one line of config. Free to start.

Get started free →