Zerodha Trading Bot
Serves as the runtime environment for the trading bot, handling API requests and responses to the Zerodha platform.
Integrates with the Zerodha trading platform to enable automated stock trading operations, including session management, portfolio tracking, and executing buy/sell orders for stocks.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Zerodha Trading Bot buy 10 shares of RELIANCE"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Zerodha Trading Bot
A Node.js-based trading bot that integrates with the Zerodha trading platform using the Model Context Protocol (MCP) for automated trading operations.
Features
Automated stock trading through Zerodha platform
Session management and token handling
Portfolio management
Buy and Sell operations
Real-time portfolio tracking
Related MCP server: Zerodha Trading Bot MCP
Prerequisites
Node.js (v14 or higher)
Zerodha Trading Account
API Key and Secret from Zerodha
Installation
Clone the repository:
git clone <repository-url>
cd trading-journalInstall dependencies:
npm installConfigure your Zerodha credentials:
Open
backend/index.jsReplace
apiKeyandapiSecretwith your Zerodha credentials
Project Structure
├── backend/
│ ├── index.js # Main server file with MCP tools
│ ├── trading.js # Zerodha trading implementation
│ └── tokenManager.js # Token management systemAvailable Tools
The bot provides the following MCP tools:
Generate-Session
Generates a new session token using request token
Required parameter:
requestToken
Buy-Stock
Places a buy order for specified stock
Parameters:
stock: Stock symbolqty: Quantity to buy
Sell-Stock
Places a sell order for specified stock
Parameters:
stock: Stock symbolqty: Quantity to sell
Show-Portfolio
Displays current portfolio holdings
No parameters required
Usage
Start the server:
node backend/index.jsThe server will start and listen for MCP commands through stdio transport.
Security Notes
Never commit your API credentials to version control
Keep your
apiSecretsecure and privateUse environment variables for sensitive data in production
Error Handling
The bot includes comprehensive error handling for:
Authentication failures
Trading operation errors
Network issues
Invalid parameters
Contributing
Fork the repository
Create your feature branch
Commit your changes
Push to the branch
Create a new Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Disclaimer
This trading bot is for educational purposes only. Use at your own risk. Always test thoroughly before using with real money.
Available Tools
6 toolsadditionD
Inputs: a (required), b (required).
Buy-StockC
This tool buys a stock in the zerodha trading platform for the given quantity and stock name at the current market price for the given user
Inputs: stock (required), qty (required).
factorialC
This tool calculates the factorial of a number
Inputs: a (required).
Generate-SessionC
Generate a new session token using request token
Inputs: requestToken (required).
Sell-StockB
This tool sells a stock in the zerodha trading platform for the given quantity and stock name at the current market price for the given user
Inputs: stock (required), qty (required).
Show-PortfolioC
This tool shows the current portfolio of the given user
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
The tool set has significant ambiguity with unrelated tools mixed together. 'addition' and 'factorial' are basic math operations that have no clear connection to trading, while 'Buy-Stock', 'Sell-Stock', and 'Show-Portfolio' are clearly trading-related. 'Generate-Session' is authentication-related but fits the trading context. The presence of math tools alongside trading tools creates confusion about the server's actual purpose.
Naming conventions are inconsistent and chaotic. 'addition' and 'factorial' use lowercase with no clear pattern, 'Buy-Stock', 'Sell-Stock', 'Generate-Session', and 'Show-Portfolio' use PascalCase with hyphens, and there's no consistent verb_noun structure. The mixing of different naming styles makes the tool set appear unorganized and harder to understand as a cohesive unit.
With 6 tools total, the count is reasonable, but the composition is problematic. For a trading bot, having 3 core trading tools (Buy-Stock, Sell-Stock, Show-Portfolio) plus authentication (Generate-Session) is appropriate, but the inclusion of two unrelated math tools makes the set feel bloated and unfocused. The count would be appropriate if all tools were trading-related.
For a trading bot domain, there are significant gaps in coverage. While basic buy/sell operations and portfolio viewing are present, there's no way to check current prices, view order history, cancel orders, set limit orders, or manage positions beyond basic buying and selling. The inclusion of unrelated math tools further dilutes the completeness for the trading domain, making this an incomplete trading surface.
Maintenance
Related MCP Connectors
Open-source MCP server for Zerodha Kite Connect. Portfolio, market data, backtesting, alerts.
TradeOS MCP: ticker search, My Agent, chart TA, macro news. npm stdio or HTTP.
Build and backtest investing strategies from your AI assistant. Remote MCP with OAuth sign-in.
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA 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.3MIT
- FlicenseNot gradedqualityDmaintenanceAn automated trading bot that interfaces with Zerodha to execute stock trades, manage positions, and access market information through natural language commands.1-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that integrates with Zerodha APIs for automated trading, providing tools for authentication, market data retrieval, order placement, and portfolio management.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that integrates with the Zerodha KiteConnect API to facilitate programmatic stock trading operations. It enables users to execute buy and sell commands directly through an MCP-compatible interface.ISC