skip to content

model context protocol · dalal-bse

mcp.

the same tape, as tools your ai can call.

dalal runs an mcp server called dalal-bse. it exposes the bse data behind this terminal and dalal's published research as thirteen read-only tools — quotes, indices, movers, history, filings, pick lists, research notes, the knowledge base and the track record — every answer tagged with its source and freshness. plug it into claude code, claude desktop or any mcp client. ask dalal, the chat in the corner, uses the very same server.

connect

two transports, one server.

streamable http (stateless), served by this app at POST /api/mcp. with the app running:

claude mcp add --transport http dalal http://localhost:3000/api/mcp

full reference — every tool’s schema, the resource and the prompt — lives in docs/MCP.md.

tools

thirteen ways to ask the exchange and the research.

  • search_scripsearch bse scrips

    Find BSE-listed companies by name, symbol, scrip code or ISIN and return their 6-digit BSE codes. Use this first when you only have a partial or ambiguous company name, or when another tool said a name was ambiguous or unknown. Does not return prices; follow up with get_quote or compare_scrips.

    • query: string
    • limit?: integer
  • get_quoteget stock quote

    Current quote for ONE BSE-listed stock: last traded price, change and % change vs previous close, open/high/low, volume, turnover, market cap, P/E and 52-week range. Accepts a 6-digit BSE code, a BSE symbol, or a distinctive company name. For two to five stocks side by side use compare_scrips; for indices such as the Sensex use get_index; for past prices use get_price_history.

    • code?: string
    • symbol?: string
  • get_indexget bse index

    Current level of ONE BSE index with change, % change and day range. Defaults to the SENSEX. Supported ids: SENSEX, BSE100, BSE200, BSE500, BANKEX, MIDCAP, SMLCAP (MIDCAP = BSE MidCap, SMLCAP = BSE SmallCap, BANKEX = banking). Use list_indices to see all of them at once; use get_price_history with the index id (e.g. "SENSEX") for its history.

    • index?: string
  • list_indiceslist bse indices

    Snapshot of every supported BSE index (SENSEX, BSE 100/200/500, BANKEX, MidCap, SmallCap) with level and % change. Use for a broad market overview; use get_index for one index in more detail.

    no arguments

  • get_top_moverstop movers

    Today's biggest BSE movers: kind "gainers" (largest % rise), "losers" (largest % fall) or "active" (highest traded volume/value). Returns symbol, code, price, change and volume for each. Use for "what is moving today" questions.

    • kind: string
    • limit?: integer
  • get_price_historyprice history

    Price history of a BSE stock or index over a range (1D intraday, 1W, 1M, 6M, 1Y, 5Y) with summary stats: start and end price, return %, high and low with dates. Accepts a stock (BSE scrip code ("500325"), BSE symbol ("RELIANCE", any case) or a distinctive company name ("reliance industries")) or an index id (SENSEX, BSE100, BSE200, BSE500, BANKEX, MIDCAP, SMLCAP). Structured content carries a down-sampled close series of at most 60 points. Use for performance/return/trend questions; use get_quote for the current price only.

    • code?: string
    • symbol?: string
    • range?: string
  • get_announcementscorporate announcements

    Latest corporate announcements filed on BSE (results, board meetings, dividends, acquisitions, disclosures), newest first, with filing links. Pass a stock to get only its filings; omit it for the exchange-wide feed. Use for news/"what did the company announce" questions; it does not return prices.

    • code?: string
    • symbol?: string
    • limit?: integer
  • get_market_statusmarket status

    Whether the BSE equity market is open right now (pre-open, open, closed or holiday) and when it next opens or closes, in IST. Use it to judge whether prices are live intraday values or the last close.

    no arguments

  • compare_scripscompare stocks

    Side-by-side quotes for 2 to 5 BSE stocks: price, % change today, day range, volume, market cap, P/E and 52-week range in one table. Use whenever the user asks to compare stocks or wants quotes for several at once (one call instead of several get_quote calls).

    • codes: string[]
  • get_pick_listresearch pick list

    Dalal's latest published research ideas for one horizon: daily (days to two weeks), monthly (one to three months), six_month, or long_term (three years and up). Each pick has its rank, conviction (low/medium/high), whether it suits beginners, the reference close it was listed at, the reasons and the risks as sourced claims, and links to the filings or articles behind them. An empty list is a real answer ("no ideas cleared the bar"). Research, not advice.

    • horizon?: string
    • date?: string
  • get_research_noteresearch note

    Dalal's latest published research note on one BSE stock: stance (positive / neutral / negative), conviction, when it was written and until when it is valid, the thesis, catalysts, risks and what would change the view, each as claims with the filings or articles behind them (publisher, date, link, quote), and key metrics computed from exchange data with their dates. Says plainly when there is no note yet. Research, not advice.

    • code?: string
    • symbol?: string
  • search_knowledgesearch the knowledge base

    Full-text search of Dalal's knowledge base: BSE filings and results, news from publisher feeds, and web pages Dalal's research has ingested. Returns the most relevant recent documents with publisher, publication date, link and a verbatim passage. Optionally restrict to one stock (`code`) or to kinds (filing, result, news, web). Check dates: older stories are included when they match.

    • query: string
    • code?: string
    • kinds?: string[]
    • limit?: integer
  • get_track_recordresearch track record

    How every pick Dalal has published has done against the SENSEX, per horizon: number of picks, how many beat the SENSEX, mean and median excess return, best and worst, at the checkpoint that fits the horizon (daily → 1 week, monthly → 1 month, six_month → 6 months, long_term → 1 year). Every published pick counts, losers included; small samples are flagged.

    • horizon?: string

playground

poke a tool, see what a model sees.

Find BSE-listed companies by name, symbol, scrip code or ISIN and return their 6-digit BSE codes. Use this first when you only have a partial or ambiguous company name, or when another tool said a name was ambiguous or unknown. Does not return prices; follow up with get_quote or compare_scrips.

result

nothing run yet.

pick a tool, tweak the json, hit run (or ⌘↵).