📈 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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

A command-based MCP server that enables programmatic stock trading on Zerodha through natural language interfaces like Claude, allowing users to buy and sell stocks via API calls.

Related MCP Servers

Zerodha MCP Integration
aptro
-
security
A
license
-
quality
Integrates Zerodha's trading platform with Claude AI using the Multi-Cloud Plugin framework, allowing users to interact with their Zerodha trading account directly through Claude for stock trading and mutual fund operations.
Last updated -
43
MIT License
Zerodha Trading MCP
shubhamprajapati7748
-
security
A
license
-
quality
A Model Context Protocol server that enables AI models to interact with the Zerodha trading platform, allowing users to execute trades, view portfolio holdings, and manage positions through a standardized interface.
Last updated -
2
MIT License
Zerodha Trading Bot
yogendhra9
A
security
F
license
A
quality
A Node.js-based trading bot that integrates with the Zerodha platform to provide automated stock trading operations through MCP tools including session management, buy/sell operations, and portfolio tracking.
Last updated -
6
Zerodha Trading Bot MCP
AmritanshuPrashar
-
security
F
license
-
quality
An automated trading bot that interfaces with Zerodha to execute stock trades, manage positions, and access market information through natural language commands.
Last updated -
1

View all related MCP servers

KiteMCP