Which MCP server has shareholding pattern and promoter pledge data of Indian companies?

What does get_shareholding return?

get_shareholding returns the ownership time series for one company. Pass an NSE symbol, ISIN or BSE code. The limit argument sets how many recent quarters you get, up to 12.

• Headline split. Each quarter has promoter_pct, fii_pct, dii_pct and public_pct, as percentages of the company’s shares.
• Institutional breakdown. breakdown.institutions splits institutions into BSE’s own categories, such as Mutual Funds, Insurance Companies and Foreign Portfolio Investors Category I. The labels are BSE’s text as filed and can carry formatting artifacts.
• Named holders. breakdown.named_institutional_holders lists individual funds and insurers the filing names, with the percentage each holds.
• No verdicts. The tool returns reported percentages and nothing else. For daily FII and DII buying and selling, use get_market_fii_dii_flow.

What does a real answer look like?

This is Reliance Industries (RELIANCE) on 29 October 2026, with limit set to 2. The newest quarter is 30 September 2026. Promoter holding is 50.44% and FII holding is 16.67%. The quarter before it, ended 30 June 2026, shows 50.48% and 17.2%. The row was cached on 21 October 2026.

{
  "nse_symbol": "RELIANCE",
  "name": "Reliance Industries Limited",
  "periods": [
    {
      "period_end": "2026-09-30",
      "promoter_pct": 50.44,
      "fii_pct": 16.67,
      "dii_pct": 21.72,
      "public_pct": 49.56,
      "retail_and_other_pct": 11.17,
      "detail": { "pledged_pct": 0.0, "pledged_shares": 0, "num_shareholders": 5072457 },
      "breakdown": {
        "institutions": [
          { "category": "Mutual Funds", "pct": 10.31 },
          { "category": "Insurance Companies", "pct": 9.47 },
          { "category": "Foreign Portfolio Investors Category I", "pct": 15.98 }
        ],
        "named_institutional_holders": [
          { "name": "SBI Mutual Funds", "category": "Mutual Funds", "pct": 2.54 },
          { "name": "Life Insurance Corporation of India", "category": "Insurance Companies", "pct": 7.11 }
        ]
      }
    },
    {
      "period_end": "2026-06-30",
      "promoter_pct": 50.48,
      "fii_pct": 17.2,
      "dii_pct": 21.19,
      "public_pct": 49.52,
      "detail": { "pledged_pct": 0.0, "num_shareholders": 4651863 }
    }
  ],
  "cached_at": "2026-10-21T16:00:22+00:00",
  "source": "bse-shp",
  "stale": false
}

What does get_pledge_trend return?

get_pledge_trend returns the promoter pledge percentage for each of up to 16 recent quarters, plus latest_pledged_pct and the change against the previous quarter. Each period also carries pledge_disclosed. When it is false, the filing had no pledge field that quarter and pledged_pct is null. A null reads as not disclosed. A real 0.0 is reported only when pledge_disclosed is true.

We looked for a company with a non-zero series. Ashok Leyland (ASHOKLEY) reports 40.1% pledged for the quarters ended 30 September, 30 June and 31 March 2026. The quarter ended 31 December 2025 shows 40.93%. In shares, that is 1,228,500,000 pledged then and 1,203,500,000 pledged now. Reliance Industries reports a pledged_pct of 0.0 in the example above. We did not recompute pledged_pct from share counts. It is returned as the filing reports it.

{
  "nse_symbol": "ASHOKLEY",
  "name": "Ashok Leyland Limited",
  "periods": [
    { "period_end": "2026-09-30", "promoter_pct": 51.51, "pledged_pct": 40.1,  "pledged_shares": 1203500000, "pledge_disclosed": true },
    { "period_end": "2026-06-30", "promoter_pct": 51.51, "pledged_pct": 40.1,  "pledged_shares": 1203500000, "pledge_disclosed": true },
    { "period_end": "2026-03-31", "promoter_pct": 51.51, "pledged_pct": 40.1,  "pledged_shares": 1203500000, "pledge_disclosed": true },
    { "period_end": "2025-12-31", "promoter_pct": 51.51, "pledged_pct": 40.93, "pledged_shares": 1228500000, "pledge_disclosed": true }
  ],
  "latest_pledged_pct": 40.1,
  "pledge_change_vs_prev": 0.0,
  "cached_at": "2026-10-21T16:22:49+00:00",
  "source": "bse-shp",
  "stale": false
}

Which quarter is the latest one available?

On 29 October 2026 both checks returned 30 September 2026 as the newest quarter. Shareholding is quarterly. Companies file the pattern about three weeks after quarter end, so the September 2026 figures were due around 21 October 2026. Our two rows were cached on 21 October 2026.

Can I screen by promoter holding and pledge?

Yes. screen_stocks accepts these keys. promoter_pct and pledged_pct are percentages, so pass 50 for 50%. promoter_holding_change_qoq is the change in percentage points between the latest two shareholding filings, so 50% to 55% is 5. Each key takes a _min or _max suffix.

We ran one screen on 29 October 2026: promoter holding of at least 60%, a reported pledge of 0, promoter holding up by at least 0.5 percentage points, and a market cap of at least ₹10,000 crore (100,000,000,000 rupees). It matched 4 of 578 securities scanned, and 6 were excluded for a missing metric. A separate screen for a pledge of at least 20% with a market cap of at least ₹5,000 crore matched 41 of 817 securities scanned. The screen snapshot was computed on 28 October 2026 at 16:16 UTC.

// filters
{ "promoter_pct_min": 60, "pledged_pct_max": 0,
  "promoter_holding_change_qoq_min": 0.5, "market_cap_min": 100000000000 }

// response: match_count 4, total_scanned 578, showing the first 3 by market cap
{ "nse_symbol": "LTM",       "promoter_pct": 69.01, "pledged_pct": 0.0, "promoter_holding_change_qoq": 0.52 }
{ "nse_symbol": "ICICILIFE", "promoter_pct": 74.7,  "pledged_pct": 0.0, "promoter_holding_change_qoq": 1.97 }
{ "nse_symbol": "GABRIEL",   "promoter_pct": 66.29, "pledged_pct": 0.0, "promoter_holding_change_qoq": 2.74 }

What is covered and what is not?

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_shareholding for RELIANCE (limit 2), get_pledge_trend for ASHOKLEY (limit 4) and screen_stocks twice on the live server. The quarter, cache dates and counts above come from those responses. Figures change as filings arrive. This is research data, not investment advice, and DalalOS does not rank or rate stocks. Found an error? Email hello@dalalos.in.