Sign up
Back to MCP

MCP Tool Reference

All 36 tools the DocStoX MCP server exposes. Your assistant picks the right one automatically — these names are also what you can ask for by name.

Find a stock and see what is moving today.

Search & Discovery

2
search_stocks
query*sector?limit?

Find Indian stocks by symbol, company name, or ISIN. Optionally filter by sector.

get_trending_stocks
category*limit?

Top gainers, losers, high-volume, or high-delivery stocks for today (Nifty 500).

Quotes and historical candles.

Quotes & Prices

3
get_stock_quote
symbol*

Current price, change %, volume, delivery %, 52-week high/low, and key ratios.

get_batch_quotes
symbols*

Quotes for up to 20 stocks in a single call — counts as one request.

get_price_history
symbol*days?exchange?

Historical OHLCV (up to 2,000 days) plus a smoothed returns block and an anomaly flag.

Everything about a single company.

Company & Fundamentals

9
get_company_profile
symbol*include_technicals?include_peers?

Sector, industry, fundamentals, listing info, pros/cons. Optionally include technicals & peers.

get_financials
symbol*period_type?report_type?periods?

P&L, balance sheet, cash flow, and computed ratios — quarterly or annual, consolidated or standalone.

get_shareholding
symbol*quarters?

Promoter, FII, DII, MF, and public holdings over the last N quarters.

get_screener_ratios
symbol*

Complete set of screener ratios for one stock (the screener snapshot view).

get_stock_events
symbol*limit?

Corporate actions — dividends, splits, bonuses, buybacks.

get_stock_ownership
symbol*quarters?

Shareholding pattern plus mutual-fund holdings for a stock.

get_forecasts
symbol*

Analyst estimates vs actuals — revenue, EPS, EBITDA per fiscal period, with surprise %.

get_documents
symbol*doc_type?limit?

Filings & documents: results, annual reports, concall transcripts, announcements (with source URLs).

get_key_insights
symbol*

Plain-English strengths (pros) and weaknesses (cons) plus growth-rate metrics.

Decision aids built on top of the raw data.

Research & Scoring

6
score_stock
symbol*

Deterministic composite score (0–10) with BUY/HOLD/AVOID verdict, confidence %, and sub-scores.

get_investment_thesis
symbol*

Structured thesis: bull case, bear case, key monitorables, what must happen, what breaks it.

get_peer_comparison
symbol*limit?

Same-sector peers (computed PE, market cap, growth, ROE, D/E) with sector medians.

get_backtest_record
symbol?

Backtested performance of the scoring engine — hit rate, avg/median return, alpha.

get_verdict_history
symbol*limit?

How a stock’s scoring verdict has trended over time — score, verdict, confidence.

get_stock_research
symbol*

AI-ready Research View for a stock — a decision aid that bundles the signals that matter.

Indicators and multi-filter screens.

Technicals & Screener

3
get_technicals
symbol*

Full set of pre-computed indicators: RSI, SMA/EMA, MACD, Bollinger, ATR, ADX, Supertrend, Stochastic, patterns.

screen_stocks
min_pe?max_pe?min_roe?min_roce?max_debt_equity?min_rsi?max_rsi?sector?market_cap_cat?min_revenue_yoy_pct?min_piotroski?supertrend_bullish?min_delivery_pct?sort_by?sort_dir?limit?

Custom screener combining fundamental, technical, and market filters with sort options.

screen_stocks_technical
pattern?signal?index_filter?limit?

Screen by technical patterns/signals — golden cross, RSI extremes, MACD, supertrend, 52w breakouts.

Macro view: flows, valuations, breadth.

Market Insights

7
get_market_pulse

Today’s snapshot: FII/DII net flows, index PE/PB, market breadth.

get_fii_dii_flows
days?include_derivatives?

Daily FII and DII net buy/sell flows in the cash market.

get_fii_dii_detail
days?

FII/DII analysis with buying streaks, velocity, and 30d/YTD summary stats.

get_fpi_sectors

FPI sector-wise AUM from NSDL with fortnight change and 6-month flow.

market_valuations
index_name?days?

Historical PE, PB, and dividend yield for a market index.

market_signals

Market-wide technical signals: breakouts, crossovers, volume spikes, RSI extremes.

market_heatmap
index_name?

Constituent stocks of an index with price change % and sector breakdown.

Deals, bans, IPOs, delivery, news.

Market Data

6
get_market_news
symbol?category?limit?

Latest market news, AI-enriched with sentiment + impact score and related symbols.

analyze_event_impact
event_text*

Causal "ripple" map for a market event: event → direct-impact sectors → second-order supply-chain effects → hedge, each with real NSE stocks, a thesis and expected move. For "what happens if X?" questions.

market_deals
days?deal_type?symbol?

Bulk and block deals: client name, quantity, price, and total value.

market_fno_ban

F&O ban list: stocks in ban or approaching it (OI > 80% of MWPL).

market_deliveries
min_delivery_pct?limit?

Stocks with high delivery percentage — an institutional-conviction signal.

market_ipo
status?

Current and upcoming IPOs with price band, dates, and subscription data.

name* = required · name? = optional. Plus watchlist & portfolio tools once you connect your account. Data is informational only, not investment advice.