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:

git clone https://github.com/AmritanshuPrashar/zerodha-mcp.git
cd mcp-zerodha

2. Install dependencies:

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:

{
  "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.