DalalOS: Indian Stock Market Research (NSE/BSE)

DalalOS: Indian stock research MCP server (NSE/BSE)

DalalOS is a hosted, remote MCP server that gives Claude, ChatGPT, Cursor and other AI clients sourced, filing-grounded Indian stock-market data, with the source and freshness date on every response. It returns reported facts and mechanically-computed ratios, never a buy/sell call.

• MCP endpoint (streamable HTTP): https://mcp.dalalos.in/mcp
• Website: https://dalalos.in
• MCP Registry name: in.dalalos/mcp
• Free to start, no card: https://dalalos.in/pricing

Not investment advice. DalalOS provides market data and mechanically-computed measures from public filings and exchanges. It does not issue recommendations, target prices or trading signals, and it is not a SEBI-registered investment advisor. See boundaries.

Connect

DalalOS uses OAuth: add the URL, sign in once in the browser window your client opens, and you are on the free tier. No API key is needed for the clients below. The server URL is always:

https://mcp.dalalos.in/mcp

Claude (claude.ai and Claude Desktop)

Open Settings → Connectors → Add custom connector, paste the URL above, choose Connect, then complete the DalalOS sign-in window and start a new chat.

Claude Code

claude mcp add --transport http dalalos https://mcp.dalalos.in/mcp

Then run /mcp inside Claude Code to finish the browser sign-in.

ChatGPT

ChatGPT does not use a JSON config file for this. In ChatGPT open Plugins → Create Plugin, choose Server URL, enter https://mcp.dalalos.in/mcp, select OAuth, create the plugin and complete the DalalOS sign-in window. Then start a new chat and select the plugin.

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global), then choose OAuth when Cursor offers it:

{
  "mcpServers": {
    "dalalos": {
      "url": "https://mcp.dalalos.in/mcp"
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "dalalos": {
      "type": "http",
      "url": "https://mcp.dalalos.in/mcp"
    }
  }
}

Codex

codex mcp add dalalos --url https://mcp.dalalos.in/mcp
codex mcp login dalalos

Any other MCP client

Use the client's own schema for a remote streamable-HTTP server. The generic shape is:

{
  "mcpServers": {
    "dalalos": {
      "url": "https://mcp.dalalos.in/mcp"
    }
  }
}

Only if a client cannot complete OAuth and requires a Bearer header, create an API key in your DalalOS account and send Authorization: Bearer <your DalalOS API key>. Never commit or share a key. More client guides (Windsurf, Zed, Kiro, OpenCode): https://dalalos.in/connect.

Check it works

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 working connection names the DalalOS tools it called and returns source and freshness metadata.

Example prompts

• "What is Reliance trading at, and where is it versus its 52-week range? Include the data source and freshness timestamp."
• "Show TCS revenue, margins, ROCE and debt-to-equity for the last five years."
• "Compare Titan and Kalyan Jewellers on margins and debt-to-equity."
• "Find IT-sector stocks with ROE over 20% and PE under 30."
• "Screen for ROCE above 22% and either debt-to-equity under 0.5 or interest coverage above 8." (free-form screener query)
• "Which companies announce results in the next two weeks?"
• "What has Larsen & Toubro disclosed about its order book and order inflow? Show the filings behind each figure."
• "Summarise the latest board-meeting filing from Infosys and quote the lines from the PDF it is based on."
• "Has promoter pledge in this company changed over the last year, and are there recent insider-trading or pledge disclosures?"
• "Which sectors have foreign portfolio investors been net buying and selling in the latest fortnight?"

Prompt pattern for when recency matters: "Name the DalalOS tools used, show the source, the cached date and any stale or coverage warning. Do not substitute web search for a missing DalalOS value." More: examples/PROMPTS.md.

What is different

• First-party and filing-grounded. Financials come from SEBI-mandated BSE-XBRL filings; exchange filings are extracted into facts that keep their source page and verbatim quotes.
• Source and freshness on every response. Each result carries its provenance, a cached_at time and a stale flag. When freshness is the question there is a dedicated get_data_freshness tool.
• Honest gaps. Missing, not-applicable and stale data are surfaced as such, not replaced with an invented value. A valid zero and missing data are different things.
• No verdicts. Raw-as-reported figures or mechanically-computed ratios only: no buy/sell calls, target prices or "top picks".

Tools

DalalOS exposes 59 current MCP tools. Compatibility aliases and a ping helper are also visible on the server; the maintained reference is https://dalalos.in/tools and the machine-readable list is capabilities.json.

Read and write behaviour:

• Market-data tools read a maintained cache; nothing is scraped from an exchange during your tool call.
• Filing tools (get_stock_events, get_filing_extract, get_filing_extracts, get_announcement_bucket) can queue filing processing and use a small on-demand allowance, so they are not marked read-only.
• add_to_watchlist and remove_from_watchlist only change your own DalalOS watchlist. DalalOS is not a broker and cannot place orders.

Data sources

Quote-style data is end-of-day, not live ticks. Freshness differs by domain: prices refresh after an exchange session is published, filings arrive when the exchange publishes them, ownership follows its reporting cadence. Details: docs/DATA_SOURCES.md and https://dalalos.in/docs/data-sources-and-freshness.

Response envelope

Tool responses share one envelope: status, data, source, cached_at, stale, plus error and a reason_code when something is unavailable, not applicable or incomplete. Surface source and cached_at when you quote a figure.

Pricing

Free to start with a monthly credit allowance, no card and no waitlist. Paid plans (Plus and Pro) add higher limits, and Pro includes REST access. Current allowances and prices: https://dalalos.in/pricing.

Boundaries

• Not real-time: quote-style data is end-of-day, not a tick or order-book feed.
• Research, not execution: not a broker; no orders or trades.
• No investment advice: no buy/sell calls, target prices or recommendations.
• Account writes are limited to your own DalalOS watchlist.
• Not affiliated with or endorsed by NSE, BSE, SEBI, Anthropic, OpenAI, Cursor or any other client or data vendor.

About this repository

This is the public project, integration and discovery surface for DalalOS. It holds connection documentation, the registry manifest, the sanitized capability list and example prompts. It intentionally does not contain the DalalOS backend: no ingestion code, schemas, deployment details or credentials.

Privacy: https://dalalos.in/privacy. Terms: https://dalalos.in/terms. Questions: https://dalalos.in/contact.