📈 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

Related MCP server: Zerodha Trading MCP

🔧 Setup Instructions

1. Clone the Repository

2. Install Dependencies (using Bun)

3. Configure Environment Variables

Create a .env file in the root:

4. Start the MCP Server

📸 Screenshots

Claude AI making transaction

Zerodha server

📥 Example Command Usage

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

✅ 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

🛡️ 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