# Trading Bot with MCP

A trading bot built using the Model Context Protocol (MCP) that provides a set of tools for automated trading operations. This bot offers various functionalities for trading stocks, managing positions, and accessing market information.

## Features

- **Stock Trading**
  - Buy stocks with specified quantity
  - Sell stocks with specified quantity
  - Cancel existing orders

- **Market Information**
  - Get real-time quotes for stocks
  - Check market status
  - View order history

- **Account Management**
  - View current positions
  - Check account balance
  - Monitor order status

## Prerequisites

- Node.js (Latest LTS version recommended)
- npm or yarn package manager
- Trading account credentials (configured in `mcp-conf.json`)

## Installation

1. Clone the repository:
```bash
git clone https://github.com/AmritanshuPrashar/zerodha-mcp.git
cd mcp-zerodha
```

2. Install dependencies:
```bash
npm install
```

3. Configure your trading credentials:
   - Create a `mcp-conf.json` file in the root directory
   - Add your trading platform credentials and configuration

## Configuration

The `mcp-conf.json` file should contain the following structure:
```json
{
  "buyStock": {
    "prompt": "Your buy stock prompt"
  },
  "sellStock": {
    "prompt": "Your sell stock prompt"
  },
  "getPosition": {
    "prompt": "Your get position prompt"
  },
  "getMarketStatus": {
    "prompt": "Your market status prompt"
  },
  "getQuote": {
    "prompt": "Your quote prompt"
  },
  "getOrderHistory": {
    "prompt": "Your order history prompt"
  },
  "cancelOrder": {
    "prompt": "Your cancel order prompt"
  },
  "getAccountBalance": {
    "prompt": "Your account balance prompt"
  }
}
```

## Usage

The bot provides several tools that can be used through the MCP interface:

- `buy-stock`: Place buy orders for stocks
- `sell-stock`: Place sell orders for stocks
- `get-positions`: View current positions
- `get-market-status`: Check market status
- `get-quote`: Get real-time quotes
- `get-order-history`: View order history
- `cancel-order`: Cancel existing orders
- `get-account-balance`: Check account balance

## Development

The project is built using:
- TypeScript
- Model Context Protocol (MCP) SDK
- Zod for schema validation

## License

[Add your chosen license here]

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## Disclaimer

This trading bot is for educational purposes only. Use at your own risk. Always test thoroughly before using with real money.