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:**
   ```sh
   git clone https://github.com/venkatakaushikvemani/groww-mcp
   cd groww-mcp
   ```
2. **Install dependencies:**
   ```sh
   npm install
   # or
   pnpm install
   ```
3. **Set environment variables:**
   Create a `.env` file in the root directory and add:
   ```env
   GROWW_API_KEY=your_groww_api_key_here
   PORT=3000 # or your preferred port
   ```
4. **Start the server:**
   ```sh
   npm start
   # or
   pnpm start
   ```

## Use with Cursor / Claude / Windsurf
mcp.json

```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