Zerodha MCP Go

🚀 Zerodha MCP Server

A protocol for communicating with Zerodha data, implemented in Golang.

🚀 Quick Start

The Zerodha MCP Server offers an implementation of the Claude MCP (Model Completion Protocol) interface for Zerodha trading data. This enables Claude AI to directly access your Zerodha trading account information.

✨ Features

• Allows Claude AI to access Zerodha trading account information.
• Supports communication with Zerodha data through the MCP protocol.

📦 Installation

Prerequisites

• Go (version 1.21 or higher)
• A Zerodha Kite trading account
• Claude Desktop Application
• API credentials from the Kite Connect Developer Portal

Option 1: Install with Go

go install github.com/sukeesh/zerodha-mcp@latest

Option 2: Build from Source

git clone https://github.com/sukeesh/zerodha-mcp.git
cd zerodha-mcp
go install

The binary will be installed in your GOBIN directory, which should be in your PATH.

💻 Usage Examples

Usage with MCP Clients

GPT 4o mini

https://github.com/user-attachments/assets/849c4aca-0ca2-4aed-a9be-3df135f8a5c5

Claude Sonnet 3.7

Configuration

1. Obtain your ZERODHA_API_KEY and ZERODHA_API_SECRET from the Kite Connect Developer Portal.

2. Set the redirect URL in the Kite Developer Portal:

   http://127.0.0.1:5888/auth
   

3. Configure the Claude Desktop Application:

   • Open Claude Desktop → Settings → Developers → Edit Configuration
   • Add the following to your claude_desktop_config.json file:

{
  "mcpServers": {
    "zerodha": {
      "command": "<path-to-zerodha-mcp-binary>",
      "env": {
       "ZERODHA_API_KEY": "<api_key>",
       "ZERODHA_API_SECRET": "<api_secret>"
      }
    }
  }
}

4. Restart the Claude Desktop Application. When prompted, log in with your Zerodha account information.

Using the Server

After setup, you can interact with your Zerodha account data directly through Claude. For example:

• "Show my current portfolio holdings."
• "What is my current margin availability?"
• "Give me the latest price of RELIANCE."
• "Show my open positions and their P&L."

🔧 Technical Details

• Limitations:
  • Only read operations are supported; trading functionality is not implemented.
  • Authentication tokens expire daily and require re - login.