venkatakaushikvemani/groww-mcp

Groww MCP Server

This project provides an MCP (Multi-Channel Platform) server for interacting with the Groww trading API. It allows you to fetch portfolio data, get live quotes, place/cancel/modify orders, and more, all via a unified API interface.

Features

• Fetch your current portfolio
• Get live stock quotes and OHLC data
• Place, modify, and cancel stock orders
• Fully typed and validated with Zod schemas

Available Tools

portfolio

Fetches the user's current portfolio holdings, including trading symbol, quantity, and average price. Use this tool to view your current investments.

• Actions:
  • get: Get the current portfolio
• Sample Prompt:

  Show my portfolio

place_order

Place a new stock order (buy/sell). Use this tool to execute trades on Groww.

• Sample Prompts:

  Place a buy order for 10 shares of TATAMOTORS Buy 10 shares of SADHNANIQ at market price

modify_order

Modify an existing stock order. Use this tool to update quantity, price, or trigger price of a pending order.

• Sample Prompts:

  Modify my order for BPL to 20 shares Update the price of my order to 100 rupees

cancel_order

Cancel an existing stock order. Use this tool to cancel a pending order on Groww.

• Sample Prompts:

  Cancel my latest order for BPL Cancel order with ID ABC123

order_status

Get the status of a stock order. Use this tool to check the current status, filled quantity, and other details of an order.

• Sample Prompts:

  What is the status of my last order? Check the status of order ABC123

market-data

Fetch live quotes, last traded prices (LTP), OHLC, or historical candle data for stocks. Use this tool to get real-time or historical market data.

• Actions:
  • live-quote: Get live quote data for a specific stock
  • ltp: Get the last traded price for one or more stocks
  • ohlc: Get OHLC (Open, High, Low, Close) data for stocks
  • historical-candle: Fetch historical candle data (Open, High, Low, Close, Volume) for a stock for a given time range and interval
• Sample Prompts:

  Get the live quote for TATAMOTORS What is the last traded price of BPL and HFCL? Show me the OHLC data for TATAMOTORS Show me the historical candle data for TATAMOTORS for the last 1 day Fetch 5-minute historical candles for TATAMOTORS from 2024-06-01 09:15:00 to 2024-06-01 15:30:00

Requirements

• Node.js v18 or later
• A valid Groww API key

Setup (Local)

1. Clone the repository:

   git clone https://github.com/venkatakaushikvemani/groww-mcp
   cd groww-mcp
   

2. Install dependencies:

   npm install
   # or
   pnpm install
   

3. Set environment variables: Create a .env file in the root directory and add:

   GROWW_API_KEY=your_groww_api_key_here
   PORT=3000 # or your preferred port
   

4. Start the server:

   npm start
   # or
   pnpm start
   

Use with Cursor / Claude / Windsurf

mcp.json

{
  "mcpServers": {
    "groww-mcp": {
      "command": "pnpm",
      "args": ["dlx", "groww-mcp"],
      "env": {
        "GROWW_API_KEY": "YOUR_GROWW_API_KEY"
      }
    }
  }
}

Usage

• The server exposes intent-based tools for portfolio, market data, and order management.
• See the code in src/groww/tools/ for available tools and their parameters.

Contributing

Pull requests and issues are welcome! Please open an issue to discuss your ideas or report bugs.

License

MIT