Overview
What is Zerodha MCP Server?
Zerodha MCP Server is a Go-based implementation of the Claude MCP (Model Context Protocol) interface that allows Claude AI to access your Zerodha Kite trading account data directly.
How to use Zerodha MCP Server?
Install the binary via go install or build from source. Obtain your API key and secret from the Kite Connect developer portal, set the redirect URL to http://127.0.0.1:5888/auth, and add the server configuration to Claude Desktop’s claude_desktop_config.json. Restart Claude Desktop and authenticate with your Zerodha Kite credentials when prompted.
Key features of Zerodha MCP Server
- Retrieve user profile and margin information
- View current holdings and open positions
- Get last traded price, quotes, and OHLC data
- Search instruments by exchange or auction status
- Access mutual fund holdings, orders, and SIP details
- Supports read-only operations (no trading)
Use cases of Zerodha MCP Server
- Ask Claude “Show me my current portfolio holdings”
- Get real-time margin availability with a natural language query
- Request the latest price for a specific stock like RELIANCE
- Check open positions and their profit/loss status
- Review mutual fund holdings and order history
FAQ from Zerodha MCP Server
What data can I access through Zerodha MCP Server?
You can access account profile, margins, holdings, positions, order margins, market quotes (LTP, OHLC), instrument lists, and mutual fund data (holdings, orders, SIPs). All tools are read-only.
Can I place trades using Zerodha MCP Server?
No. Only read operations are supported; trading (buy/sell) is not yet available.
How do I authenticate with Zerodha?
You must set ZERODHA_API_KEY and ZERODHA_API_SECRET as environment variables, configure the redirect URL in your Kite developer portal, and complete authentication in Claude Desktop when first connecting. The token expires daily and requires re-authentication.
How do I debug if something goes wrong?
Logs are stored at ~/Library/Logs/Claude. If the MCP server is not killed on Claude shutdown, you can stop it manually with kill -9 $(lsof -t -i:5888).
What are the runtime requirements?
Go version 1.21 or later, a Zerodha Kite trading account, and the Claude Desktop App. No additional services or external dependencies are needed.
