Skip to main content
Glama

Groww MCP

by arkapravasinha
GitHub
JavaScript
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Groww MCP Server

A comprehensive Model Context Protocol (MCP) server for the Groww Trading API. This server provides tools to interact with Groww's trading platform, enabling you to place orders, manage your portfolio, access live market data, and more.

Features

This MCP server provides access to all major Groww API endpoints:

  • download_instruments_csv - Download/refresh complete tradeable instruments data
  • search_instruments - Search for instruments by name, trading symbol, groww symbol, or criteria
  • get_instrument_details - Get detailed information about a specific instrument

📋 Orders Management

  • place_order - Place new orders (stocks, F&O)
  • modify_order - Modify existing pending/open orders
  • cancel_order - Cancel pending/open orders
  • get_order_status - Get order status by Groww order ID
  • get_order_status_by_reference - Get order status by user reference ID
  • get_order_list - Get list of all orders for the day
  • get_order_details - Get detailed order information
  • get_order_trades - Get all trades/executions for an order

💼 Portfolio Management

  • get_holdings - Get current stock holdings in DEMAT account
  • get_positions - Get all trading positions
  • get_position_by_symbol - Get position for specific trading symbol

💰 Margin Management

  • get_user_margin - Get available margin details
  • calculate_margin_requirement - Calculate required margin for orders

📊 Live Market Data

  • get_live_quote - Get complete live market data for instruments
  • get_ltp - Get Last Traded Price for multiple instruments (up to 50)
  • get_ohlc - Get OHLC data for multiple instruments (up to 50)

📈 Historical Data

  • get_historical_data - Get historical candle data for instruments

📊 Technical Analysis

  • calculate_moving_averages - Calculate SMA and EMA for trend analysis
  • calculate_rsi - Calculate Relative Strength Index for momentum analysis
  • calculate_bollinger_bands - Calculate Bollinger Bands for volatility analysis
  • calculate_support_resistance - Identify key support and resistance levels
  • calculate_volatility_metrics - Calculate various volatility metrics for risk assessment
  • calculate_macd - Calculate MACD for trend and momentum analysis
  • calculate_stochastic - Calculate Stochastic Oscillator for momentum analysis
  • calculate_williams_r - Calculate Williams %R for momentum analysis
  • calculate_adx - Calculate ADX for trend strength analysis
  • calculate_fibonacci_levels - Calculate Fibonacci retracement and extension levels
  • analyze_candlestick_patterns - Identify common candlestick patterns

Prerequisites

  1. Groww Account: You need a Groww account with F&O trading enabled
  2. API Subscription: Active Trading API subscription (₹499 + taxes per month)
  3. API Key: Generate your API access token from Groww account settings

Generating API Key

  1. Log in to your Groww account
  2. Click on the profile section at the top-right
  3. Click on the settings icon
  4. Navigate to 'Trading APIs'
  5. Create and manage your API tokens

Configuration

The server requires the following configuration:

{ "apiKey": "your_groww_api_key_here", "debug": false }

API Enums and Constants

Exchanges

  • NSE - National Stock Exchange
  • BSE - Bombay Stock Exchange

Segments

  • CASH - Regular equity market
  • FNO - Futures and Options

Order Types

  • MARKET - Execute immediately at best available price
  • LIMIT - Execute at specified price or better
  • SL - Stop Loss order
  • SL_M - Stop Loss Market order

Transaction Types

  • BUY - Long position
  • SELL - Short position

Product Types

  • CNC - Cash and Carry (delivery-based)
  • MIS - Margin Intraday Square-off
  • NRML - Regular margin trading

Validity

  • DAY - Valid until market close

Usage Examples

Search for Instruments

// Search for instruments containing "reliance" search_instruments({ query: "reliance", exchange: "NSE", segment: "CASH", limit: 5 }) // Search for NIFTY options search_instruments({ query: "nifty", segment: "FNO", instrument_type: "CE", limit: 10 }) // Get details for a specific symbol get_instrument_details({ trading_symbol: "RELIANCE", exchange: "NSE" })

Place a Market Order

// Buy 10 shares of RELIANCE at market price place_order({ trading_symbol: "RELIANCE", quantity: 10, exchange: "NSE", segment: "CASH", product: "CNC", order_type: "MARKET", transaction_type: "BUY" })

Place a Limit Order

// Buy 100 shares of WIPRO at ₹250 per share place_order({ trading_symbol: "WIPRO", quantity: 100, exchange: "NSE", segment: "CASH", product: "CNC", order_type: "LIMIT", transaction_type: "BUY", price: 250 })

Place a Stop Loss Order

// Stop loss order for RELIANCE place_order({ trading_symbol: "RELIANCE", quantity: 10, exchange: "NSE", segment: "CASH", product: "CNC", order_type: "SL", transaction_type: "SELL", price: 2450, trigger_price: 2400 })

Get Live Market Data

// Get live quote for NIFTY get_live_quote({ trading_symbol: "NIFTY", exchange: "NSE", segment: "CASH" }) // Get LTP for multiple symbols get_ltp({ segment: "CASH", exchange_symbols: ["NSE_RELIANCE", "NSE_TCS", "NSE_INFY"] })

Get Historical Data

// Get 5-minute candles for RELIANCE get_historical_data({ trading_symbol: "RELIANCE", exchange: "NSE", segment: "CASH", start_time: "2024-01-01 09:15:00", end_time: "2024-01-01 15:30:00", interval_in_minutes: 5 })

Technical Analysis Examples

// Calculate moving averages calculate_moving_averages({ trading_symbol: "RELIANCE", exchange: "NSE", segment: "CASH", start_time: "2024-01-01 09:15:00", end_time: "2024-01-31 15:30:00", periods: [5, 10, 20, 50] }) // Calculate RSI calculate_rsi({ trading_symbol: "NIFTY", exchange: "NSE", segment: "CASH", start_time: "2024-01-01 09:15:00", end_time: "2024-01-31 15:30:00", period: 14 }) // Calculate Bollinger Bands calculate_bollinger_bands({ trading_symbol: "RELIANCE", exchange: "NSE", segment: "CASH", start_time: "2024-01-01 09:15:00", end_time: "2024-01-31 15:30:00", period: 20, std_dev: 2 }) // Find support and resistance levels calculate_support_resistance({ trading_symbol: "RELIANCE", exchange: "NSE", segment: "CASH", start_time: "2023-12-01 09:15:00", end_time: "2024-01-31 15:30:00", interval_in_minutes: 60, min_touches: 2 }) // Calculate volatility metrics calculate_volatility_metrics({ trading_symbol: "RELIANCE", exchange: "NSE", segment: "CASH", start_time: "2023-01-01 09:15:00", end_time: "2024-01-31 15:30:00", interval_in_minutes: 1440 // Daily candles }) // Calculate MACD calculate_macd({ trading_symbol: "RELIANCE", exchange: "NSE", segment: "CASH", start_time: "2024-01-01 09:15:00", end_time: "2024-01-31 15:30:00", fast_period: 12, slow_period: 26, signal_period: 9 }) // Calculate Stochastic Oscillator calculate_stochastic({ trading_symbol: "NIFTY", exchange: "NSE", segment: "CASH", start_time: "2024-01-01 09:15:00", end_time: "2024-01-31 15:30:00", k_period: 14, d_period: 3 }) // Calculate Williams %R calculate_williams_r({ trading_symbol: "RELIANCE", exchange: "NSE", segment: "CASH", start_time: "2024-01-01 09:15:00", end_time: "2024-01-31 15:30:00", period: 14 }) // Calculate ADX for trend strength calculate_adx({ trading_symbol: "RELIANCE", exchange: "NSE", segment: "CASH", start_time: "2024-01-01 09:15:00", end_time: "2024-01-31 15:30:00", period: 14 }) // Calculate Fibonacci levels calculate_fibonacci_levels({ trading_symbol: "RELIANCE", exchange: "NSE", segment: "CASH", start_time: "2023-12-01 09:15:00", end_time: "2024-01-31 15:30:00", trend_direction: "AUTO" }) // Analyze candlestick patterns analyze_candlestick_patterns({ trading_symbol: "RELIANCE", exchange: "NSE", segment: "CASH", start_time: "2024-01-25 09:15:00", end_time: "2024-01-31 15:30:00", lookback_candles: 5 })

Calculate Margin Requirements

// Calculate margin for basket orders calculate_margin_requirement({ segment: "CASH", orders: [ { trading_symbol: "RELIANCE", transaction_type: "BUY", quantity: 10, order_type: "LIMIT", product: "CNC", exchange: "NSE", price: 2500 }, { trading_symbol: "TCS", transaction_type: "BUY", quantity: 5, order_type: "MARKET", product: "CNC", exchange: "NSE" } ] })

Rate Limits

The Groww API has rate limits applied at the category level:

CategoryRequestsPer SecondPer MinutePer Day
OrdersCreate, Modify, Cancel152503000
Live DataQuote, LTP, OHLC103005000
Non-TradingStatus, List, Holdings, Margin102503000

Error Handling

The server handles various types of errors:

  1. API Authentication Errors: Invalid API key
  2. Rate Limit Errors: Exceeded API rate limits
  3. Validation Errors: Invalid parameters
  4. Trading Errors: Market closed, insufficient margin, etc.

All errors are returned with descriptive messages to help identify and resolve issues.

Support and Documentation

Disclaimer

⚠️ Trading Risk Warning:

  • Trading in financial markets involves substantial risk of loss
  • Past performance does not guarantee future results
  • Only trade with money you can afford to lose
  • This tool is for educational and development purposes
  • Always verify orders and trades manually
  • The developers are not responsible for any trading losses

License

This project is licensed under the MIT License.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Enable seamless integration of Groww platform data and tools with language models to enhance financial decision-making and automation. Provide access to Groww-specific resources, execute financial operations, and utilize predefined prompts for investment workflows. Simplify interaction with Groww se

  1. Features
    1. 🔧 Instruments & Search
    2. 📋 Orders Management
    3. 💼 Portfolio Management
    4. 💰 Margin Management
    5. 📊 Live Market Data
    6. 📈 Historical Data
    7. 📊 Technical Analysis
  2. Prerequisites
    1. Generating API Key
  3. Configuration
    1. API Enums and Constants
      1. Exchanges
      2. Segments
      3. Order Types
      4. Transaction Types
      5. Product Types
      6. Validity
    2. Usage Examples
      1. Search for Instruments
      2. Place a Market Order
      3. Place a Limit Order
      4. Place a Stop Loss Order
      5. Get Live Market Data
      6. Get Historical Data
      7. Technical Analysis Examples
      8. Calculate Margin Requirements
    3. Rate Limits
      1. Error Handling
        1. Support and Documentation
          1. Disclaimer
            1. License

              Related MCP Servers

              • Model Context Provider (MCP) Server

                Mark850409
                -
                security
                F
                license
                -
                quality
                Facilitates enhanced interaction with large language models (LLMs) by providing intelligent context management, tool integration, and multi-provider AI model coordination for efficient AI-driven workflows.
                Last updated -
                Python

              • MCP Yahoo Finance

                leoncuhk
                A
                security
                F
                license
                A
                quality
                Provides tools to get financial data (stock prices, company information) and generate financial visualizations through the Model Context Protocol.
                Last updated -
                10
                4
                Python
                • Apple
                • Linux

              • Financial Modeling Prep MCP Server

                imbenrabi
                -
                security
                F
                license
                -
                quality
                Enables AI assistants to access and analyze financial data including stock information, company fundamentals, and market insights through the Financial Modeling Prep API.
                Last updated -
                16
                TypeScript

              • Hexiaoyi MCP

                dddd-community
                -
                security
                A
                license
                -
                quality
                A powerful toolkit that enables seamless interaction with EVM-compatible networks through natural language processing and AI assistance, allowing users to manage wallets, launch tokens, and interact with blockchain networks.
                Last updated -
                0
                JavaScript
                MIT License

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/arkapravasinha/groww-mcp-server'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server