Skip to content
Docs
Get Pro

Company & fundamentals

Financial statements, estimates, filings and events. The DocStoX MCP tools in this group, what each returns and the parameters it takes.

Updated
On this page

You do not call these tools yourself. Ask your question in plain English and your AI picks the right one.

get_company_profileFree

Get company profile

Full company profile: sector, industry, fundamentals, listing info.

symbolrequired
NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.
include_technicalsoptional
true adds the latest RSI, SMAs, MACD, Bollinger, Supertrend, ADX, ATR and Stochastic readings.
include_peersoptional
true adds up to 6 same-sector peers (price, P/E, ROE, revenue).

get_financialsFree

Get financials

P&L, balance sheet, cash flow, and computed ratios.

symbolrequired
NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.
period_typeoptional
Q = quarterly, A = annual. NOT 'quarterly'/'annual'.
report_typeoptional
Consolidated includes subsidiaries. Standalone has wider coverage in this DB, so retry with it if empty.
periodsoptional
How many periods, newest first (1-40).

get_batch_financialsFree

Get batch financials

Financial TREND + analyst view + ownership shift for many stocks at once.

symbolsrequired
NSE symbols, up to 25 per call (heavier than get_batch_fundamentals).
period_typeoptional
Q = quarterly, A = annual. NOT 'quarterly'/'annual'.
include_forecastsoptional
Attach the analyst consensus + target per symbol.
include_shareholdingoptional
Attach the promoter/FII/DII shift per symbol.

get_batch_fundamentalsFree

Get batch fundamentals

Valuation, quality, growth and trend metrics for UP TO 50 stocks in ONE call.

symbolsrequired
NSE symbols, up to 50 per call.
include_technicalsoptional
Also return RSI/SMA/trend fields per symbol.

get_screener_ratiosFree

Get screener ratios

Complete set of screener ratios from the mv_screener_snapshot view.

symbolrequired
NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

get_forecastsPro

Get forecasts

Analyst estimates vs actuals for a stock: revenue, EPS, EBITDA per fiscal period, with surprise %, PLUS the last known analyst price target. Includes forward periods (estimates, no actuals yet).

symbolrequired
NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

get_analyst_revisionsPro

Get analyst revisions

How analyst consensus and target price have MOVED: the revision trend.

symbolrequired
NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.
daysoptional
Lookback window in days (7-730).

get_batch_analyst_viewPro

Get batch analyst view

Last known consensus, target price and computed upside for up to 50 symbols.

symbolsrequired
NSE symbols, e.g. ['RELIANCE','TCS'].

get_documentsFree

Get documents

Company filings & documents: quarterly/annual results, annual reports, concall transcripts, investor presentations, LODR filings, announcements, credit ratings, with title, date, and source URL, plus an AI-written summary of the filing where one has been produced.

symbolrequired
NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.
doc_typeoptional
Restrict to one document type; omit for all. counts_by_type in the response shows what exists.
limitoptional
Max documents, newest first (1-100).

get_company_timelineFree

Get company timeline

What a company disclosed over time: a dated, source-linked timeline of results, order wins, management and auditor changes, ratings, legal and capital events, ownership moves and deals.

symbolrequired
NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.
daysoptional
Days of history. Free: 365; Pro: up to 1825 (5 years); free callers asking for more get 365 plus a count of older events.
include_routineoptional
Include routine filings. Default false: routine paperwork (e.g. trading-window notices) is left out.
kindsoptional
Only these kinds, e.g. ['order','auditor']. Valid: results, board_meeting, order, capacity, deal, capital, buyback, dividend, rating, auditor, leadership, legal, ownership, investor_comm, shareholder_meeting, clarification, other. Omit for all.
limitoptional
Max events. Material events are kept first when the window holds more.

get_earnings_calendarFree

Get earnings calendar

Upcoming results / board meetings: who reports and when.

symboloptional
NSE symbol to scope results to. Omit for market-wide.
days_aheadoptional
How far FORWARD to look, in days (0-180).
days_backoptional
How far back to include, in days (0-180).
only_resultsoptional
True = results meetings only; False = all board purposes (dividend, fundraising, ...).
limitoptional
Max meetings to return, soonest first (1-200).

get_stock_eventsFree

Get stock events

Corporate actions (dividends, splits, bonuses, buybacks) for a stock.

symbolrequired
NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.
limitoptional
Max corporate-action rows (1-100), newest ex-date first. The 10 latest bulk/block deals are always included.

get_corporate_actions_feedFree

Get corporate actions feed

Structured corporate-action RECORDS (not headlines): dividends, splits, bonuses, buybacks, with ex/record/payment dates, amounts and ratios.

symboloptional
NSE symbol to scope results to. Omit for market-wide.
action_typeoptional
Corporate action type: DIVIDEND, BONUS, SPLIT, RIGHTS, BUYBACK or OTHER. Omit for all.
daysoptional
Window in days around today (1-365).
limitoptional
Max rows to return (1-100).

Running low?

Two ways to get more calls and credits

Invite a friend, free

When someone signs up through your link, you get 2,000 research credits and they get 500. Bonus credits never expire.

Get your invite link

Move to Pro

5,000 tool calls a day instead of 50, 5,000 research credits instead of 500, and every one of the 94 tools in full.

See Pro

See what you have used today at Usage.

Was this page helpful?

Something wrong or missing on this page? Email [email protected]