25
Read-only MCP tools
6
Tool categories
~5,000
NSE & BSE companies
0
Buy/sell calls or advice
Search & discovery
| Tool | What it tells you | Try asking |
|---|---|---|
search_stocks | Resolve a company from a name, ticker, BSE code or ISIN before asking anything else — usually the first tool your assistant calls. | “Find the ISIN for a stock called 'Infy' — I don't know the exact ticker.” |
screen_stocks | The screener: combine PE, ROE, debt, promoter holding, sector and 20+ other filters across roughly 5,000 NSE/BSE stocks. | “Find IT-sector stocks with ROE over 20% and PE under 30.” |
get_sector_overview | Zoom out from one stock to a whole sector: median valuation and how many companies sit in it. | “What's the median PE and dividend yield across the banking sector right now?” |
list_index_constituents | All constituents of an index like NIFTY 50 or NIFTY BANK, ranked by market cap. | “List every stock in the NIFTY IT index.” |
list_indices | See what indices exist before asking for constituents or a heatmap. | “What indices do you track, and how many stocks are in each?” |
get_market_heatmap | See how every stock in an index has moved over 1 day to 1 year, side by side. | “Show me a heatmap of NIFTY 50 with 1-month and 1-year returns.” |
list_preset_screens | Ready-made screens like "low PE" or "high dividend yield, large cap" that refresh overnight — instant, no live computation. | “What preset screens are available?” |
run_preset_screen | The latest results for a named preset (e.g. "low_leverage_high_roe") — precomputed overnight, never live. | “Show me the results of the high-dividend-yield, large-cap preset screen.” |
Quotes & prices
| Tool | What it tells you | Try asking |
|---|---|---|
get_stock_quote | The one-stop quote: price, change, PE/PB, 52-week high/low and dividend info for a single stock. | “What's Reliance trading at, and where does that sit versus its 52-week range?” |
get_batch_quotes | The same data as get_stock_quote, for a whole watchlist at once — one bad ticker never fails the rest. | “Give me quotes for RELIANCE, TCS, HDFCBANK, INFY and ICICIBANK.” |
get_price_history | Raw price history for charting or your own return calculations — split/bonus-adjusted on request. | “Give me two years of weekly price history for TCS.” |
get_returns | 1W/1M/3M/6M/1Y/YTD returns, CAGR, volatility and max drawdown — computed from the price series, not opinion. | “What's the 1-year and 3-year return for this stock, and its max drawdown?” |
get_delivery_trends | How much of the traded volume is actually delivered (held), not just churned intraday. | “Has delivery percentage in this stock been rising over the last 3 months?” |
Financials & ratios
| Tool | What it tells you | Try asking |
|---|---|---|
get_financials | Revenue, margins, ROE/ROCE and debt ratios pulled from SEBI BSE-XBRL filings — adapted automatically for banks, NBFCs and insurers. | “Show me TCS revenue, margins, ROCE and debt-to-equity for the last 5 years.” |
get_financial_trends | See the direction of travel — margin expansion or contraction, revenue and free-cash-flow growth. | “Is this company's net margin expanding or contracting quarter over quarter?” |
get_company_profile | A single roll-up of who a company is, what it trades at, and its latest fundamentals — a good first look. | “Give me a quick profile of Asian Paints — sector, current valuation, and latest margins.” |
Peer comparison
| Tool | What it tells you | Try asking |
|---|---|---|
get_peer_comparison | Compare a company against its actual industry peers — sized and grouped automatically, not a hand-picked watchlist. | “Compare HDFC Bank against its peers on PE, PB and ROE.” |
Ownership & risk
| Tool | What it tells you | Try asking |
|---|---|---|
get_shareholding | Track how ownership has shifted quarter to quarter — a promoter stake trending up or down often matters as much as the price. | “How has promoter and FII holding in Adani Power changed over the last two years?” |
get_pledge_trend | One of the most-watched risk signals on its own — how much of the promoter's stake is pledged against loans, and whether that's rising. | “Is promoter pledge in this company rising or falling?” |
Corporate actions & events
| Tool | What it tells you | Try asking |
|---|---|---|
get_dividends | Every cash dividend a company has paid, plus trailing yield and payout ratio against the latest price. | “What dividends has Infosys paid over the last 5 years, and what's the trailing yield?” |
get_corporate_actions | Every disclosed corporate action in one timeline, not just dividends — useful for understanding a jump in the price series. | “Has this company done a stock split, bonus issue or buyback in the last 5 years?” |
get_stock_events | The BSE announcement feed for a company — headlines and categories, so you know what's been disclosed recently. | “What has this company announced to the exchange in the last month?” |
get_upcoming_results | See which companies have results due in the next couple of weeks, market-wide or filtered by sector. | “Which companies are announcing results in the next two weeks?” |
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) of the tools above.
03
Get sourced answers
Every response carries its source and a freshness timestamp.
Connect in one line
Use the server key dalal-os and the streamable HTTP endpoint below.
claude_desktop_config.json
{
"mcpServers": {
"dalal-os": {
"url": "https://mcp.dalalos.in/mcp"
}
}
}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.
Signed in already? Your dashboard tool reference has the full parameter and response spec for every tool above.
FAQ
Common questions
How many tools does DalalOS expose?
25 read-only MCP tools spanning quotes, financials, peer comparison, ownership, corporate actions and market-wide screening — plus a couple of operational tools for health checks.
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?
Sign in to your DalalOS dashboard for the full technical reference — every parameter, default, and output field for all 25 tools. This page is the plain-English tour.
Does any tool give a buy, sell or target-price signal?
No. Every tool returns raw data or mechanically-computed ratios only — no verdicts, recommendations or target prices. You and your AI draw the conclusions.
Connect your AI to Indian stock market data
Sign in to DalalOS and connect your AI in one line of config. Free to start.
KEEP EXPLORING