1. Conduid
  2. Developer Tools
  3. Zerodha MCP Go
MCP server · Developer Tools

Zerodha MCP Go

by · github.com/sukeesh/zerodha-mcp-go

MCP Server for Zerodha written in Golang

Unclaimed last commit a year ago devtools
InstallView source
46Fair

Scored 5 days ago · breakdown

About Zerodha MCP Go

Zerodha MCP Go is an MCP server published by sukeesh in the Developer Tools category: mCP Server for Zerodha written in Golang. It has been installed 0 times through Conduid.

The repository has 11 stars and 2 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx zerodha-mcp-go

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Zerodha MCP Go

Powered by Claude · Grounded in docs

I know everything about Zerodha MCP Go. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v0.0.2v0.0.2 · 29 Apr 2025What's Changed Fix bugs in the tools available by @sukeesh in https://github.com/sukeesh/zerodha-mcp-go/pull/2 Use reflect package for better format of struct by @sukeesh in https://github.com/sukeesh/zerodha-mcp-go/pull/3 Fix panic by…
v0.0.1v0.0.1 · 21 Apr 2025Full Changelog**: https://github.com/sukeesh/zerodha-mcp-go/commits/v0.0.1

README

Zerodha MCP Server

Go

Overview

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

Prerequisites

Installation

Option 1: Using Go Install

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 to your GOBIN directory, which should be in your PATH.

Usage with an MCP Client

GPT 4o mini

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

Claude Sonnet 3.7

Configuration

  1. Get your ZERODHA_API_KEY and ZERODHA_API_SECRET from the Kite Connect developer portal

  2. Set up a redirect URL in the Kite developer portal:

    http://127.0.0.1:5888/auth

  3. Configure Claude Desktop:

    • Open Claude Desktop → Settings → Developer → Edit Config
    • Add the following to your claude_desktop_config.json:
{
  "mcpServers": {
    "zerodha": {
      "command": "<path-to-zerodha-mcp-binary>",
      "env": {
       "ZERODHA_API_KEY": "<api_key>",
       "ZERODHA_API_SECRET": "<api_secret>"
      }
    }
  }
}
  1. Restart Claude Desktop. When prompted, authenticate with your Zerodha Kite credentials.

Debugging

The logs for MCP Server are available at ~/Library/Logs/Claude

Known Bugs

When the Claude desktop is shutdown, the underlying MCP Server is not getting killed.

kill -9 $(lsof -t -i:5888)

Available Tools

Category Tool Status Description
Account Information get_user_profile ✅ Get basic user profile information
get_user_margins ✅ Get all user margins
get_user_segment_margins ✅ Get segment-wise user margins
Portfolio & Positions get_kite_holdings ✅ Get current holdings in Zerodha Kite account
get_positions ✅ Get current day and net positions
get_order_margins ✅ Get margin requirements for specific orders
Market Data get_ltp ✅ Get Last Traded Price for specific instruments
get_quote ✅ Get detailed quotes for specific instruments
get_ohlc ✅ Get Open, High, Low, Close quotes
Instruments get_instruments ✅ Get list of all available instruments on Zerodha
get_instruments_by_exchange ✅ Get instruments filtered by exchange
get_auction_instruments ✅ Get instruments available for auction sessions
Mutual Funds get_mf_instruments ✅ Get list of all available mutual fund instruments
get_mf_holdings ✅ Get list of mutual fund holdings
get_mf_holdings_info ✅ Get detailed information about mutual fund holdings
get_mf_orders ✅ Get list of all mutual fund orders
get_mf_order_info ✅ Get detailed information about specific mutual fund orders
get_mf_sip_info ✅ Get information about mutual fund SIPs
get_mf_allotted_isins ✅ Get allotted mutual fund ISINs

Usage

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

  • "Show me my current portfolio holdings"
  • "What's my current margin availability?"
  • "Give me the latest price for RELIANCE"
  • "Show me my open positions with P&L"

Limitations

  • Only read operations are supported; trading is not yet available
  • Authentication token expires daily and requires re-login

README mirrored from the source repository 5 days ago. The original is authoritative.

Questions

About Zerodha MCP Go

How do I install Zerodha MCP Go?

Run npx zerodha-mcp-go, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Zerodha MCP Go safe to use with an AI agent?

Its trust score is 46 out of 100 (fair). It passes 0 of 1 static security checks; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Zerodha MCP Go still maintained?

The last commit was a year ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.