Skip to main content
Glama
AmritanshuPrashar

Zerodha Trading Bot MCP

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
  1. Install dependencies:

npm install
  1. 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.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to interact with the Zerodha trading platform for placing stock orders, viewing portfolio holdings, and managing mutual fund investments. Provides secure OAuth authentication and real-time trading capabilities through Zerodha's official API.
    1
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables trading operations on Zerodha platform through natural language, supporting account management, order placement/modification, portfolio holdings, positions, margins, and stock news retrieval.
    Apache 2.0
  • A
    license
    B
    quality
    D
    maintenance
    Enables trading and portfolio management on Zerodha Kite Connect through natural language. Supports placing orders, viewing positions/holdings, accessing real-time market data, and managing GTT orders.
    24
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Trade Indian stocks on Zerodha Kite via natural conversation. 14 tools for holdings, orders, quotes, GTT triggers with automated TOTP login.
    14
    6
    MIT