KiteMCP

📈 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

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 -
40
Python
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
TypeScript
MIT License
Zerodha Kite MCP Server
121yaseen
-
security
F
license
-
quality
Implements a Model Context Protocol server that connects with Zerodha Kite API, allowing users to buy/sell stocks and retrieve holdings and positions information.
Last updated -
1
TypeScript
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
JavaScript

View all related MCP servers