Groww

You run a dedicated MCP server that exposes your Groww trading data and actions through a unified interface. It lets you fetch portfolios, obtain live quotes and OHLC data, and place, modify, or cancel orders, all with typed, validated inputs for reliability.

How to use

Use an MCP client to connect to the Groww MCP Server and perform common trading actions. You can fetch your current portfolio, request live market data, place new orders, modify existing ones, cancel orders, and check order status. The server exposes these capabilities as intent-driven tools that you can invoke from your MCP client using natural language prompts or structured tool calls.

How to install

Prerequisites: make sure you have Node.js v18 or later installed on your machine.

Step 1: Clone the repository and navigate into it.

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

Step 2: Install dependencies using your preferred package manager.

npm install
# or
pnpm install

Step 3: Create a local environment file with your Groww API key and desired port.

GROWW_API_KEY=your_groww_api_key_here
PORT=3000

Step 4: Start the server.

npm start
# or
pnpm start

Additional configuration and usage notes

If you want to run the MCP via a pre-arranged command snippet, you can use the following MCP configuration. This snippet runs the server via pnpm and passes your Groww API key through an environment variable.

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

Environment and requirements

• Node.js version: v18 or later. - A valid Groww API key is required to access trading data and perform actions.

Security and keys

Keep your Groww API key secure. Do not share the key in public code or logs. Rotate keys as recommended by your security policy.

Notes on usage patterns

• To view your holdings, request the portfolio tool. - For live data, use market-data tools to fetch live quotes or OHLC data. - To trade, use place_order to submit new orders, modify_order to adjust pending orders, and cancel_order to withdraw them. - Use order_status to monitor the state of any active or filled orders.

Troubleshooting

If the server fails to start, verify that PORT is not in use and that GROWW_API_KEY is set. Check that Node.js v18+ is installed and that dependencies installed correctly.

Available tools

portfolio

Fetches the user's current portfolio holdings, including symbol, quantity, and average price.

place_order

Place a new stock order (buy or sell) with specified quantity and price or market execution.

modify_order

Modify an existing pending order by updating quantity, price, or trigger price.

cancel_order

Cancel an existing pending order.

order_status

Retrieve the status and details of a specific order, including filled quantity and remaining quantity.

market-data

Fetch live quotes, last traded price, OHLC data, and historical candle data for stocks.