Indian Stock Market Data API
Query NSE and BSE prices, company fundamentals, financial results and shareholding from a script or an AI client. The DocStoX financial data API uses Model Context Protocol (MCP) with JSON-RPC over Streamable HTTP and requires authentication.
Available financial data
- Company financials
get_financials
Quarterly and annual revenue, net profit, EPS and available fundamental ratios.- Historical stock prices
get_price_history
Historical price candles and volume by symbol and exchange.- Shareholding patterns
get_shareholding
Quarter-end promoter, institutional and public ownership where reported.- Stock screening
screen_stocks
Filter the market using valuation, growth, profitability and other supported metrics.- Company news
get_stock_news_feed
Recent company coverage and events linked to a ticker.
Data history and completeness vary by instrument and reporting period. See market coverage and data freshness.
Example request for annual company financials
Connect your MCP client to https://mcp.docstox.com/mcp. For scripts, load your key from an environment variable and send it as a Bearer token. After the client initializes the connection, use the tool call below for the latest three annual periods available for Reliance Industries.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "get_financials",
"arguments": {
"symbol": "RELIANCE",
"period_type": "A",
"report_type": "Consolidated",
"periods": 3
}
}
}Check period_end_date and report_type in the response before comparing periods. The default reporting basis can fall back to standalone filings when consolidated filings are unavailable.

