Skip to content

Tools Reference

Jump to bottom
Jai Rajput edited this page Jul 3, 2026 · 1 revision

Tools Reference

Complete reference for all 25 tools. Each tool is callable via MCP's tools/call method.

Portfolio Tools (Free)

get_holdings

Returns all stocks in your DEMAT account.

Parameter Type Required Description
none — — No parameters needed

Returns: Array of holdings with trading symbol, ISIN, quantity, average price, and current value.

Example prompt: "Show me my current holdings"

get_positions

Returns open intraday and F&O positions with unrealized P&L.

Parameter Type Required Description
segment string No CASH or FNO (default: all)

Returns: Open positions with entry price, current price, quantity, and unrealized profit/loss.

Example prompt: "What are my open positions today?"

get_margins

Returns available cash, collateral, and margin details for equity and F&O.

Parameter Type Required Description
none — — No parameters needed

Returns: Available margin, used margin, collateral value, cash balance.

Example prompt: "What's my available margin?"

calculate_margin

Pre-check margin requirement before placing an order.

Parameter Type Required Description
trading_symbol string Yes Stock symbol (e.g., RELIANCE)
exchange string No NSE or BSE (default: NSE)
transaction_type string Yes BUY or SELL
order_type string Yes MARKET, LIMIT, SL, SL-M
quantity integer Yes Number of shares
price number No Price (for LIMIT/SL orders)
product string Yes CNC, MIS, or NRML
segment string No CASH or FNO (default: CASH)

Example prompt: "How much margin do I need to buy 100 shares of RELIANCE?"

Order Tools (Free)

get_orders

List all orders with status, filterable by segment.

Parameter Type Required Description
segment string No CASH or FNO

Example prompt: "Show me today's orders"

get_order_detail

Detailed status of a specific order.

Parameter Type Required Description
order_id string Yes Groww order ID
segment string No CASH or FNO (default: CASH)

Example prompt: "What's the status of order ORD123456?"

get_order_trades

Get all trade executions (partial fills) for a specific order.

Parameter Type Required Description
order_id string Yes Groww order ID
segment string No CASH or FNO (default: CASH)

Example prompt: "Show me the fill details for order ORD123456"

place_order

Place a BUY or SELL order. Supports MARKET, LIMIT, SL, and SL-M order types.

Parameter Type Required Description
trading_symbol string Yes Stock/option symbol
exchange string No NSE or BSE (default: NSE)
transaction_type string Yes BUY or SELL
order_type string Yes MARKET, LIMIT, SL, SL-M
quantity integer Yes Number of shares
price number No Price (for LIMIT/SL)
trigger_price number No Trigger price (for SL/SL-M)
product string Yes CNC (delivery), MIS (intraday), NRML (F&O)
segment string No CASH or FNO (default: CASH)
validity string No DAY or IOC (default: DAY)
disclosed_qty integer No Disclosed quantity

Example prompt: "Place a limit buy order for 10 shares of RELIANCE at 2800"

The AI assistant will always confirm before executing.

modify_order

Modify a pending order's price, quantity, or type.

Parameter Type Required Description
order_id string Yes Groww order ID
order_type string No New order type
quantity integer No New quantity
price number No New price
trigger_price number No New trigger price
segment string No CASH or FNO (default: CASH)

cancel_order

Cancel an open or pending order.

Parameter Type Required Description
order_id string Yes Groww order ID
segment string No CASH or FNO (default: CASH)

Smart Order Tools — GTT/OCO (Free)

Unique to this MCP — no other Groww MCP server supports smart orders.

get_smart_orders

List all GTT (Good Till Triggered) and OCO (One Cancels Other) orders.

Parameter Type Required Description
segment string No CASH or FNO
page integer No Page number
page_size integer No Results per page

create_smart_order

Create a GTT or OCO conditional order.

  • GTT: Triggers a buy/sell when price hits your target
  • OCO: Sets both stop-loss AND target — whichever hits first executes
Parameter Type Required Description
trading_symbol string Yes Stock symbol
exchange string No NSE or BSE (default: NSE)
transaction_type string Yes BUY or SELL
smart_order_type string Yes GTT or OCO
trigger_price number Yes Trigger price
order_type string No MARKET or LIMIT (default: LIMIT)
quantity integer Yes Number of shares
price number No Limit price (for LIMIT)
product string Yes CNC, MIS, or NRML
segment string No CASH or FNO (default: CASH)
stop_loss_trigger number No Stop-loss trigger (OCO only)
stop_loss_price number No Stop-loss limit price (OCO only)
target_trigger number No Target trigger (OCO only)
target_price number No Target limit price (OCO only)

Example prompt: "Create a GTT order to buy RELIANCE when it drops to 2700"

modify_smart_order

Update triggers, quantity, or prices on an existing smart order.

Parameter Type Required Description
order_id string Yes Smart order ID
trigger_price number No New trigger price
quantity integer No New quantity
price number No New limit price
stop_loss_trigger number No New SL trigger (OCO)
target_trigger number No New target trigger (OCO)

cancel_smart_order

Cancel a pending GTT or OCO order.

Parameter Type Required Description
order_id string Yes Smart order ID
segment string No CASH or FNO (default: CASH)

Market Data Tools (Requires ₹499/mo Subscription)

These tools require the Groww Live Data subscription. Without it, they return a clear error explaining how to subscribe.

get_quote

Live quote with OHLC, bid/ask, volume, and change %.

Parameter Type Required Description
trading_symbol string Yes Stock symbol
exchange string No NSE or BSE (default: NSE)
segment string No CASH or FNO (default: CASH)

get_ltp

Last traded price for up to 50 symbols at once.

Parameter Type Required Description
symbols array Yes Array of { trading_symbol, exchange, segment } objects

get_ohlc

OHLC data for up to 50 symbols at once.

Parameter Type Required Description
symbols array Yes Array of { trading_symbol, exchange, segment } objects

get_option_chain

Full option chain with OI, IV, and Greeks (Delta, Gamma, Theta, Vega).

Parameter Type Required Description
trading_symbol string Yes Underlying symbol (NIFTY, BANKNIFTY, RELIANCE)
exchange string No NSE or BSE (default: NSE)

Example prompt: "Show me the NIFTY option chain"

get_historical_data

Historical candlestick data for chart analysis.

Parameter Type Required Description
trading_symbol string Yes Stock symbol
exchange string No NSE or BSE (default: NSE)
segment string No CASH or FNO (default: CASH)
interval string Yes 1m, 5m, 15m, 30m, 1h, 1d
start_time integer Yes Start time (epoch seconds)
end_time integer Yes End time (epoch seconds)

Instrument Tools (Free)

search_instruments

Search for tradable instruments by name or symbol.

Parameter Type Required Description
query string Yes Search query (e.g., "Reliance", "NIFTY")

Example prompt: "Search for HDFC on Groww"

get_instrument_detail

Detailed contract info including lot size, tick size, and expiry.

Parameter Type Required Description
trading_symbol string Yes Trading symbol
exchange string No NSE or BSE (default: NSE)
segment string No CASH or FNO (default: CASH)

download_instruments

Download the complete CSV of all tradable instruments (returns first 20 rows as sample).

Parameter Type Required Description
none — — No parameters needed

Backtesting (Requires ₹499/mo Subscription)

run_backtest

Simulate a trading strategy on historical data.

Parameter Type Required Description
trading_symbol string Yes Symbol to backtest
exchange string No NSE or BSE (default: NSE)
segment string No CASH or FNO (default: CASH)
start_time integer Yes Backtest start (epoch seconds)
end_time integer Yes Backtest end (epoch seconds)
strategy object Yes Strategy parameters

Other Tools

authenticate

Manually trigger a token refresh. Normally auto-handled by the server.

Parameter Type Required Description
none — — No parameters needed

get_profile

Account information including UCC, enabled exchanges, segments, and DDPI status.

Parameter Type Required Description
none — — No parameters needed

Built by Jai Rajput | MIT License | Report an Issue

Groww MCP Wiki

Home

Setup

Reference

Community

Links

Clone this wiki locally