# DalalOS

DalalOS is the Indian stock market data layer for AI-powered stock research. It is a hosted Model Context Protocol (MCP) server connecting AI assistants and agents — such as Claude, Cursor and ChatGPT-style tools — to Indian (NSE/BSE) stock-market data over streamable HTTP. DalalOS exposes 59 current, non-deprecated MCP capabilities covering end-of-day quotes and prices, financials and ratios, company profiles and reports, peer comparison, shareholding and pledge data, filings, corporate actions and events, screening, indices, market context, watchlists and sector overviews across thousands of NSE/BSE companies. Market figures are read from cache; filing tools can queue processing and use on-demand quota. 2 explicit account-scoped actions only add or remove symbols from the caller's DalalOS watchlist. The public reference also retains 1 deprecated compatibility alias and the operational ping helper, for 61 documented protocol-visible names in total. Data comes from official and public sources: NSE archives (end-of-day), BSE official interfaces and SEBI-mandated BSE-XBRL filings, plus named official public-sector sources for supported macro/reference domains. DalalOS returns sourced facts and mechanical measures rather than investment verdicts — it is a research and analysis layer, not investment advice.

## Connect

MCP endpoint: https://mcp.dalalos.in/mcp

Choose OAuth when your client supports a browser sign-in connector. This is the recommended path for ChatGPT and Cursor. Use an API key only when a client cannot complete OAuth or explicitly requires a Bearer header. Never share or commit an API key.

### ChatGPT (published plugin, easiest)

Open https://chatgpt.com/plugins/plugin_asdk_app_6aded6de90f081918717da5227322e16, select Install plugin, and sign in to DalalOS. The plugin is open to any ChatGPT account in India. Outside India, use the manual setup below.

### ChatGPT web, manual setup (verified)

1. Open Plugins in ChatGPT and select Create Plugin.
2. Choose Server URL and enter https://mcp.dalalos.in/mcp.
3. Select OAuth, create the plugin, and complete the DalalOS sign-in window.
4. Start a new ordinary chat, select the plugin, and ask a research question.

ChatGPT does not use an mcpServers JSON file for this flow. Test with: “Use DalalOS to fetch the latest available quote and company profile for Reliance Industries. Tell me which DalalOS tools you called, the source of the data, and its freshness date. Do not use web search.” A successful response names the tools called and returns source and freshness metadata.

### OAuth-capable MCP clients

```json
{
  "mcpServers": {
    "dalal-os": {
      "url": "https://mcp.dalalos.in/mcp"
    }
  }
}
```

The JSON above is a generic example only. Use each client's documented configuration schema; it is not the ChatGPT setup format.

### API-key MCP clients (fallback)

```json
{
  "mcpServers": {
    "dalal-os": {
      "url": "https://mcp.dalalos.in/mcp",
      "headers": {
        "Authorization": "Bearer <your-isk_live_-key>"
      }
    }
  }
}
```

Claude Code one-liner (OAuth-capable clients may complete authorization after registration):

```bash
claude mcp add --transport http dalal-os https://mcp.dalalos.in/mcp
```

REST API example (create an API key first):

```bash
curl -sS \
  -H "Authorization: Bearer <your-isk_live_-key>" \
  "https://mcp.dalalos.in/v1/stocks/RELIANCE/profile"
```

After connecting, ask the client for a quote, financial statement, peer comparison or screen. Ask it to include the source and freshness timestamp. Prices are end-of-day, and market-data responses are sourced facts or mechanically-computed measures — never a buy/sell call, target price or investment recommendation.

## Key pages

- https://dalalos.in/ — Home: what DalalOS is and how to connect it to AI tools.
- https://dalalos.in/connect — Human-readable connection guide for OAuth, API-key MCP and REST paths.
- https://dalalos.in/tools — Complete documented MCP reference, including current capabilities, compatibility aliases and operational ping.
- https://dalalos.in/llms-full.txt — The same overview plus the complete MCP tool reference (parameters, outputs, example prompts) as one plain-text file.
- https://dalalos.in/screener — Screen NSE/BSE stocks on raw data and mechanically-computed ratios.
- https://dalalos.in/heatmap — Sector-grouped market heatmap of NSE/BSE index constituents.
- https://dalalos.in/calendar — Indian stock market events, including results, IPOs and corporate actions.
- https://dalalos.in/fii-dii — Daily net Foreign and Domestic Institutional Investor flow.
- https://dalalos.in/fii-dii/monthly — Month-by-month FII and DII buy, sell and net totals summed from the daily NSE series.
- https://dalalos.in/fii-dii/full-form — FII, DII and FPI full forms and how net flow is calculated.
- https://dalalos.in/fii-dii/fpi-sector-investment — NSDL fortnightly sector-wise FPI net investment and assets under custody.
- https://dalalos.in/fno-ban-list — NSE F&O securities-in-ban list for the latest published date.
- https://dalalos.in/ipos — Upcoming, open and recently listed IPO tracker.
- https://dalalos.in/discover — NSE/BSE corporate disclosures grouped into thematic buckets.
- https://dalalos.in/docs/indian-stock-market-mcp-server — MCP server overview and data coverage.
- https://dalalos.in/docs/data-sources-and-freshness — Canonical source, provenance, cache-age and staleness reference.
- https://dalalos.in/docs/claude — How to connect DalalOS to Claude.
- https://dalalos.in/docs/chatgpt — How to add the DalalOS plugin to ChatGPT, and how to add it by hand.
- https://dalalos.in/docs/cursor-and-other-ai-tools — How to connect Cursor and other MCP clients, with OAuth or an API key.
- https://dalalos.in/docs/rest-api — REST API authentication, envelope and read-only endpoint reference.
- https://dalalos.in/docs/screener — How the stock screener's query language works: ratio names, operators, units, missing values.
- https://dalalos.in/docs/screener/ratios — Every screener ratio with its definition, unit, Screener.in name and DalalOS id.
- https://dalalos.in/use-cases/claude-indian-stock-research — Using Claude with DalalOS.
- https://dalalos.in/use-cases/chatgpt-indian-stock-analysis — Using ChatGPT-style agents with DalalOS.
- https://dalalos.in/use-cases/ai-agent-for-indian-stock-research — Building an AI agent for Indian stock research.
- https://dalalos.in/use-cases/compare-indian-stocks-with-ai — Comparing Indian stocks with AI.
- https://dalalos.in/use-cases/order-book-order-inflow-data-mcp — Which MCP gives order book and order inflow data for Indian listed companies: the tool, a live LT example and how limited the coverage is (published by DalalOS; checked 27 Oct 2026).
- https://dalalos.in/use-cases/read-bse-nse-company-filings-mcp — An MCP server that reads BSE filings of NSE/BSE-listed companies: guidance, commentary and results with the page and quote behind each fact (published by DalalOS; checked 27 Oct 2026).
- https://dalalos.in/use-cases/indian-stock-data-mcp-no-buy-sell-calls — An Indian stock data MCP that returns raw data as reported or fixed-formula ratios, with no buy or sell calls, ratings or target prices (published by DalalOS; checked 27 Oct 2026).
- https://dalalos.in/use-cases/quarterly-results-data-mcp-india — Which MCP server gets quarterly results of Indian listed companies: get_financials, get_upcoming_results and the filing lag, with a live Q2 FY27 example (published by DalalOS; checked 29 Oct 2026).
- https://dalalos.in/use-cases/fii-dii-flow-data-mcp-india — Which MCP server has FII and DII flow data for India: daily cash flow, fortnightly sector FPI investment, F&O participant open interest and quarterly holdings, with the dated limits of each (published by DalalOS; checked 29 Oct 2026).
- https://dalalos.in/use-cases/indian-stock-screener-mcp — An Indian stock screener available through an MCP server: screen_stocks, screen_by_query and preset screens, with live example screens (published by DalalOS; checked 29 Oct 2026).
- https://dalalos.in/use-cases/shareholding-pattern-promoter-pledge-mcp — An MCP server for shareholding pattern and promoter pledge data of Indian companies: get_shareholding and get_pledge_trend, with the latest quarter available (published by DalalOS; checked 29 Oct 2026).
- https://dalalos.in/use-cases/corporate-actions-dividends-mcp-india — An MCP server for NSE and BSE corporate actions and dividends: get_corporate_actions, get_dividends and the market calendar (published by DalalOS; checked 29 Oct 2026).
- https://dalalos.in/use-cases/indian-stock-ratios-mcp — Which MCP server has Indian stock ratios such as P/E, ROCE and debt to equity, with units, formulas and which ratios do not apply to banks (published by DalalOS; checked 29 Oct 2026).
- https://dalalos.in/use-cases/macro-data-mcp-india-mospi-fbil — Indian macro data for AI assistants: MOSPI CPI, WPI, IIP and GDP, PPAC crude basket and FBIL rupee reference rates, with what is stale and what is not covered (published by DalalOS; checked 29 Oct 2026).
- https://dalalos.in/use-cases/nse-fno-open-interest-data-mcp — Which MCP gives NSE F&O open interest and derivatives positioning data: get_derivatives_positioning, get_fo_participant_activity and the F&O ban list (published by DalalOS; checked 29 Oct 2026).
- https://dalalos.in/use-cases/indian-ipo-data-mcp — An MCP server for Indian IPO data: get_ipos with price band, dates, subscription and listing fields, and what is not yet disclosed (published by DalalOS; checked 29 Oct 2026).
- https://dalalos.in/use-cases/compare-indian-stock-with-peers-mcp — Which MCP server compares an Indian stock against its peers: get_peer_comparison and get_relevant_peers with peer medians and data-quality flags (published by DalalOS; checked 29 Oct 2026).
- https://dalalos.in/guides/ai-stock-research-india — Guide to AI-assisted stock research in India.
- https://dalalos.in/guides/indian-stock-market-data-for-ai-agents — Guide to Indian stock market data for AI agents.
- https://dalalos.in/guides/fundamental-analysis-indian-stocks-with-ai — Worked example of fundamental analysis of Indian stocks with an MCP-connected AI.
- https://dalalos.in/guides/claude-skill-vs-mcp-connector-indian-stocks — Claude skill vs MCP connector: DalalOS is a connector, not a skill.
- https://dalalos.in/compare/indian-stock-api-vs-mcp — Indian stock data API vs MCP server.
- https://dalalos.in/compare/zerodha-mcp-vs-dalalos-mcp — Zerodha-style MCP vs DalalOS.
- https://dalalos.in/compare/dhan-mcp-vs-dalalos-mcp — Dhan-style MCP vs DalalOS.
- https://dalalos.in/compare/indian-stock-market-mcp-servers — Types of Indian stock market MCP server and a checklist for evaluating them.
- https://dalalos.in/compare/best-indian-stock-mcp-servers — Nine Indian stock MCP servers compared on sign-in, orders, tools, price and data source: DalalOS, Trendlyne, MarketPing, NSE's own servers, Indian Market MCP, NSE-MCP, Zerodha Kite, Groww and Dhan, plus a row on Screener.in, which runs no MCP server (published by DalalOS; vendor facts dated 27 and 29 Oct 2026).

## What DalalOS is not

- Not investment advice, a recommendation service, a target-price engine or a trading-signal feed.
- Not a real-time market feed: prices and quotes are end-of-day.
- Not a broker or order-routing service; watchlist actions save symbols and filing tools can queue processing.
- Not affiliated with NSE, BSE, SEBI, Anthropic/Claude, OpenAI/ChatGPT, Cursor or another vendor.

## Contact

- Email: hello@dalalos.in