Is there an MCP server for NSE and BSE corporate actions and dividends?

What does get_dividends return?

get_dividends returns the cash dividend history for one company. Pass an NSE symbol, ISIN or BSE code, and years from 1 to 15. Each row has an ex-date, a type, the amount per share and a record date. The response adds annual_totals in fiscal-year buckets (April to March). Each bucket carries the total, the number of payouts, the closing price on or before that fiscal year end and a dividend_yield: the year’s total dividend divided by that closing price. The yield is null when price history does not reach back that far.

This is ITC (ITC) on 29 October 2026, with years set to 2. Two dividends fall in each fiscal year shown. The FY26 total of 14.5 equals the 6.5 interim plus the 8.0 final, so the final dividend with an ex-date of 27 May 2026 is counted in FY26. The FY25 total of 14.35 equals 7.85 plus 6.5 in the same way. The data was cached on 28 October 2026.

{
  "nse_symbol": "ITC",
  "current_price": 259.5,
  "trailing_12m_dividend": 14.5,
  "dividend_yield": 0.0559,
  "annual_totals": [
    { "fy": "FY26", "total": 14.5,  "count": 2, "fy_end_price_date": "2026-03-30", "fy_end_price": 287.7,  "dividend_yield": 0.0504 },
    { "fy": "FY25", "total": 14.35, "count": 2, "fy_end_price_date": "2025-03-28", "fy_end_price": 409.75, "dividend_yield": 0.035 }
  ],
  "dividends": [
    { "ex_date": "2026-05-27", "type": "final",   "amount": 8.0 },
    { "ex_date": "2026-02-04", "type": "interim", "amount": 6.5 },
    { "ex_date": "2025-05-28", "type": "final",   "amount": 7.85 },
    { "ex_date": "2025-02-12", "type": "interim", "amount": 6.5 }
  ],
  "cached_at": "2026-10-28T14:45:02+00:00",
  "source": "bse-corp-actions",
  "stale": false
}

What does get_corporate_actions return?

get_corporate_actions returns every disclosed corporate action for one company, newest first: dividends, splits, bonuses and other types. Set years from 1 to 20 and pass a types list to keep only some types. Each row has the ex-date, the event type, a sub-type, the ratio text or amount, a record date, a payment date and the exchange’s own purpose text.

This is TCS (TCS) with years set to 2. It returned 10 rows, all dividends. The latest is an interim dividend of ₹12 per share with an ex-date of 14 October 2026. On 16 January 2026 two rows share one ex-date: a special dividend of ₹46 and an interim dividend of ₹11. A second call with types set to split and bonus returned no rows for TCS in the same window, with the note “no corporate actions in window”.

{
  "nse_symbol": "TCS",
  "count": 10,
  "actions": [
    { "ex_date": "2026-10-14", "event_type": "dividend", "sub_type": "interim", "amount": 12.0, "raw_purpose": "Interim Dividend - Rs. - 12.0000" },
    { "ex_date": "2026-05-25", "event_type": "dividend", "sub_type": "final",   "amount": 31.0, "raw_purpose": "Final Dividend - Rs. - 31.0000" },
    { "ex_date": "2026-01-16", "event_type": "dividend", "sub_type": "special", "amount": 46.0, "raw_purpose": "Special Dividend - Rs. - 46.0000" },
    { "ex_date": "2026-01-16", "event_type": "dividend", "sub_type": "interim", "amount": 11.0, "raw_purpose": "Interim Dividend - Rs. - 11.0000" }
  ],
  "cached_at": "2026-10-28T14:48:02+00:00",
  "source": "bse-corp-actions"
}

// same call with types ["split", "bonus"]
{ "count": 0, "actions": [], "note": "no corporate actions in window" }

How do I see upcoming ex-dates across the whole market?

get_market_calendar takes a date_from and date_to in ISO format, up to 180 days apart, and an optional types list. It merges the results calendar with the corporate-action events and sorts them by date. Each event has a date, a type, the ISIN, the NSE symbol, the name and a detail string.

We asked for 29 October to 5 November 2026 with types dividend, split and bonus and a limit of 6. All six events returned were dated 29 October 2026, the day of the check, and the response says it was cut at the limit. We have not read the rest of that window, so we cannot say how many events fall on later dates. The row for Chandni Machines has no NSE symbol. The date field is the event date as the calendar reports it. Check the company’s own filing before you rely on it as an ex-date.

{
  "from": "2026-10-29",
  "to": "2026-11-05",
  "count": 6,
  "events": [
    { "date": "2026-10-29", "type": "dividend", "nse_symbol": "CRISIL",     "name": "Crisil Limited",                                    "detail": "Rs 17.00/share, Interim" },
    { "date": "2026-10-29", "type": "dividend", "nse_symbol": "CMPDI",      "name": "Central Mine Planning & Design Institute Limited",  "detail": "Rs 1.05/share, Interim" },
    { "date": "2026-10-29", "type": "dividend", "nse_symbol": "KSOLVES",    "name": "Ksolves India Limited",                             "detail": "Rs 1.00/share, Interim" },
    { "date": "2026-10-29", "type": "dividend", "nse_symbol": "KAJARIACER", "name": "Kajaria Ceramics Limited",                          "detail": "Rs 12.00/share, Interim" },
    { "date": "2026-10-29", "type": "dividend", "nse_symbol": "SHRIRAMFIN", "name": "Shriram Finance Limited",                           "detail": "Rs 6.50/share, Interim" },
    { "date": "2026-10-29", "type": "split",    "nse_symbol": null,         "name": "Chandni Machines Ltd",                              "detail": "Split 10:1" }
  ],
  "note": "Result truncated to 6 events (limit); widen types/date filters or raise limit.",
  "cached_at": "2026-10-28T14:48:02+00:00"
}

For results dates alone, get_upcoming_results looks forward only. On 29 October 2026, with days set to 7 and a limit of 5, it listed results due that day for Blue Star, DCW, Jasch Industries (BSE code 500220, no NSE symbol), Trent and HeidelbergCement India, sourced from BSE and cached on 28 October 2026 at 15:15 UTC. The site also has a market calendar page.

What is forward-looking and what is historical?

Is there a REST API for the same data?

Yes. The REST surface mirrors the MCP tools under /v1. The routes for this page are /v1/stocks/{q}/corporate-actions, /v1/stocks/{q}/dividends, /v1/calendar and /v1/results-calendar. They need an API key. See the REST API reference. We did not call the REST routes for this page. The figures above come from the MCP tools.

How do I ask for it?

The code is on GitHub: DalalOS-Indian-Stock-Research on GitHub. To set it up, connect your AI, or follow the guide for Claude or ChatGPT, Cursor and other clients. The server is at https://mcp.dalalos.in/mcp.

How we checked

On 29 October 2026 we called get_dividends for ITC, get_corporate_actions for TCS (twice) and get_market_calendar once on the live server. The get_upcoming_results figures come from a check on the same day. Data changes as companies file. This is research data, not investment advice, and DalalOS does not rank or rate stocks. Found an error? Email hello@dalalos.in.