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

Related MCP server: Zerodha MCP Server

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.