# 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
## Prerequisites
- Node.js (v14 or higher)
- Zerodha Trading Account
- API Key and Secret from Zerodha
## Installation
1. Clone the repository:
```bash
git clone <repository-url>
cd trading-journal
```
2. Install dependencies:
```bash
npm install
```
3. Configure your Zerodha credentials:
- Open `backend/index.js`
- Replace `apiKey` and `apiSecret` with your Zerodha credentials
## Project Structure
```
├── backend/
│ ├── index.js # Main server file with MCP tools
│ ├── trading.js # Zerodha trading implementation
│ └── tokenManager.js # Token management system
```
## Available Tools
The bot provides the following MCP tools:
1. **Generate-Session**
- Generates a new session token using request token
- Required parameter: `requestToken`
2. **Buy-Stock**
- Places a buy order for specified stock
- Parameters:
- `stock`: Stock symbol
- `qty`: Quantity to buy
3. **Sell-Stock**
- Places a sell order for specified stock
- Parameters:
- `stock`: Stock symbol
- `qty`: Quantity to sell
4. **Show-Portfolio**
- Displays current portfolio holdings
- No parameters required
## Usage
1. Start the server:
```bash
node backend/index.js
```
2. The server will start and listen for MCP commands through stdio transport.
## Security Notes
- Never commit your API credentials to version control
- Keep your `apiSecret` secure and private
- Use 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
1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. 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.
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/yogendhra9/ZerodhaMCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server