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/mcpfull 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 scripsFind 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 quoteCurrent 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 indexCurrent 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 indicesSnapshot 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 moversToday'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 historyPrice 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 announcementsLatest 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 statusWhether 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 stocksSide-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 listDalal'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 noteDalal'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 baseFull-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 recordHow 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.
result
nothing run yet.
pick a tool, tweak the json, hit run (or ⌘↵).