📈 KiteMCP – Zerodha Trading via MCP

KiteMCP is a command-based Zerodha trading system built using the KiteConnect API, Bun, and the Model Context Protocol (MCP). It allows real-time stock buy/sell operations through MCP command calls from a local server, currently integrated with Claude or any compatible tool interface.

---

🚀 Features

• 🔄 Buy and sell stocks programmatically via commands
• 🛠 Modular MCP tool structure (buy-stock, sell-stock)
• 🔐 Secure API key handling via .env
• ✅ Schema validation using Zod
• ⚙️ Fast runtime with Bun and TypeScript
• 🧪 Local test environment with log outputs

---

🔧 Setup Instructions

1. Clone the Repository

git clone https://github.com/your-username/zerodha-trade
cd zerodha-trade

2. Install Dependencies (using Bun)

bun install

3. Configure Environment Variables

Create a .env file in the root:

KITE_API_KEY=your_api_key
KITE_API_SECRET=your_api_secret
ACCESS_TOKEN=your_access_token

4. Start the MCP Server

bun index.ts

---

📸 Screenshots

Claude AI making transaction

Zerodha server

📥 Example Command Usage

Send the following JSON to the server via terminal or Claude:

{
  "id": "1",
  "action": "call_tool",
  "tool": "buy-stock",
  "arguments": {
    "symbol": "RELIANCE",
    "exchange": "NSE",
    "quantity": 10,
    "price": 2800
  }
}

---

✅ Input Validation

All tool inputs are validated using Zod for:

• Required fields: symbol, exchange, quantity
• Type and range checks
• Custom error messages on invalid input

---

🧪 Example Output

{
  "status": "success",
  "message": "Buy order placed for RELIANCE at ₹2800"
}

---

🛡️ Security Notes

• Do not expose your .env file in production
• Add rate limiting and request authentication if going public
• Store order logs securely

---

📌 Future Enhancements

• 🌐 Deploy on cloud with webhook interface
• 📊 Add portfolio view and PnL tracking
• 🔔 Telegram/email alerts for order confirmations
• 🧠 Auto-trading with strategy modules

---

👨‍💻 Author

Utkarsh Agarwal
GitHub • LinkedIn

---

📜 License

MIT License © 2025 Utkarsh Agarwal