Zerodha Trading MCP

A Model Context Protocol (MCP) server that enables AI models to interact with the Zerodha trading platform. This project provides a set of tools for executing trades, viewing portfolio, and managing positions on Zerodha through a standardized interface.

Features

🔐 Secure authentication with Zerodha API
📊 View portfolio holdings
📈 Check open positions
💹 Place buy/sell orders
👤 Access user profile information

Prerequisites

Node.js (v14 or higher)
Zerodha Trading Account
API credentials from Zerodha

Installation

Clone the repository:

git clone https://github.com/shubhamprajapati7748/zerodha-trade-mcp.git
cd zerodha-trade-mcp

Install dependencies:

npm install

Create a .env file in the root directory with your Zerodha credentials:

KITE_API_KEY=your_api_key
KITE_SECRET_KEY=your_secret_key
REQUEST_TOKEN=your_request_token
ACCESS_TOKEN=your_access_token

Claude Desktop MCP Configuration

To use this MCP server with Claude Desktop, you need to configure the mcp server details. Here's how to set it up:

Open claude_desktop_config.json in your project root
Add the following configuration:

{
  "mcpServers": {
    "tradeStocks": {
      "command": "/opt/homebrew/bin/bun",
      "args": [
        "/path/to/your/index.ts"
      ], 
      "env": {
        "KITE_API_KEY": "your_api_key",
        "KITE_SECRET_KEY": "your_secret_key",
        "REQUEST_TOKEN": "your_request_token",
        "ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

Make sure to:

Update the path to your index.ts file
Replace the environment variables with your actual Zerodha credentials

Usage

The MCP server provides the following tools:

Get Profile

get-profile

Retrieves the user's profile information from Zerodha.

Buy Stock

buy-stock {stock: string, quantity: number}

Places a buy order for the specified stock and quantity.

Sell Stock

sell-stock {stock: string, quantity: number}

Places a sell order for the specified stock and quantity.

Show Portfolio

show-portfolio

Displays the user's complete portfolio holdings.

Show Positions

show-positions

Shows the user's open positions.

Development

The project is built using:

TypeScript
KiteConnect API
Model Context Protocol (MCP) SDK
Zod for schema validation

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This project is for educational purposes only. Trading in financial markets carries significant risk. Always do your own research and trade responsibly.

Zerodha Trading MCP

Integrations