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.
The repository has 11 stars and 3 forks, with the last commit a month ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/sukeesh/zerodha-mcp-goThis 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.
Tools (5)
**Account Information**`get_user_profile`
Parameters not published.
**Instruments**`get_instruments`
Parameters not published.
**Market Data**`get_ltp`
Parameters not published.
**Mutual Funds**`get_mf_instruments`
Parameters not published.
**Portfolio & Positions**`get_kite_holdings`
Parameters not published.
Ask AI
Ask AI about Zerodha MCP Go
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
Zerodha MCP Server
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
- Go (version 1.21 or later)
- A Zerodha Kite trading account
- Claude Desktop App
- API credentials from the Kite Connect developer portal
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
-
Get your
ZERODHA_API_KEYandZERODHA_API_SECRETfrom the Kite Connect developer portal -
Set up a redirect URL in the Kite developer portal:
http://127.0.0.1:5888/auth -
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>"
}
}
}
}
- 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 fetched from the repository 7 days ago. The original is authoritative.