zerodha-mcp

Overview

This is a comprehensive MCP server for Zerodha, an Indian stock brokerage platform. It provides a set of tools to manage trading accounts, place orders, retrieve positions, and interact with the trading platform. The server supports multiple client implementations including Agno framework, Google ADK, and a Gradio web interface. The implementation follows the Model Context Protocol (MCP) for standardized communication and can be used to build AI trading assistants.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_login_url

  Get the login URL for user authentication

  Try:How do I log in to my Zerodha account?Try:Get the login URL
• get_access_token

  Generate access token using request token

  Try:Generate access token for my accountTry:Get API access token
• get_user_profile

  Get user's Zerodha profile information

  Try:Show me my user profileTry:What's my account information?
• get_margins

  Get available margins and fund details

  Try:Check my available marginsTry:What are my fund details?
• get_holdings

  Get portfolio holdings

  Try:Show me my portfolio holdingsTry:What stocks do I currently hold?
• get_positions

  Get current positions

  Try:What are my current positions?Try:Show me my open positions
• get_orders

  Get all orders for the day

  Try:Show me today's ordersTry:List all my orders
• get_order_history

  Get history of a specific order

  Try:Show history of order ID 12345Try:What's the status of my previous order?
• get_order_trades

  Get trades generated by an order

  Try:Show trades for order ID 12345Try:What trades were made in my order?
• place_order

  Place a new order

  Try:Place a buy order for 10 shares of RELIANCETry:I want to sell 5 TATASTEEL at market price
• modify_order

  Modify an existing order

  Try:Modify order ID 12345 to increase quantityTry:Change the limit price of my order
• cancel_order

  Cancel an order

  Try:Cancel order ID 12345Try:I want to cancel my pending order

Comparable tools

Installation

git clone https://github.com/mtwn105/zerodha-mcp-server-client.git
cd zerodha-mcp-server-client

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

pip install -r requirements.txt

cp .env.example .env
# Edit .env with your credentials

{
  "mcpServers": {
    "zerodha": {
      "command": "python",
      "args": ["/path/to/zerodha-mcp-server-client/server.py"],
      "env": {
        "ZERODHA_API_KEY": "your_api_key",
        "ZERODHA_API_SECRET": "your_api_secret",
        "PORT": "8001"
      }
    }
  }
}

FAQ

What APIs are required to use this MCP server?

You need a Zerodha trading account with Personal API access, plus either an OpenAI API key (for Agno Agent) or a Gemini API key/Application Default Credentials (for Google ADK Agent).

How do I connect different clients to the MCP server?

The server supports multiple connection methods - you can use environment variables, command-line arguments, or configure through the provided .env file. Each client (Agno, Google ADK, Gradio) has specific connection steps detailed in the README.

Compare zerodha-mcp with