Zerodha MCP Server & Client
About
A Python-based trading assistant that connects to a Zerodha MCP server to help users manage their trading account. It integrates with Zerodha’s API via the Model Context Protocol and supports both Agno and Google ADK agent frameworks for natural-language interaction.
Details
- Author
- mtwn105
- Downloads
- 394
- Categories
- Other, AI
Jump to
- Account management for orders, positions, and margins
- Interactive chat interface using natural language
- Built on the Model Context Protocol (MCP)
- Two agent frameworks: Agno and Google ADK
- Place, modify, and cancel orders
- Retrieve portfolio holdings, positions, and user profile
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Zerodha MCP Server & ClientCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install dependencies, configure a .env file with Zerodha API credentials and an LLM API key (OpenAI for Agno, Gemini or ADC for Google ADK), then start the server with python server.py. Launch the client with python client/agno_client.py or python client/google_adk_client.py. Use the interactive chat to execute trading commands such as “Show me my holdings” or “Place a market order”.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"zerodha mcp server & client": {
"zerodha-mcp-mtwn105": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
}
}McpServers
{
"zerodha-mcp-mtwn105": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}Zerodha MCP Server & Client
A Python-based trading assistant that connects to a Zerodha MCP server to help users manage their trading account.
Features
- Account Management: Manage Zerodha trading account, orders, and positions
- Interactive Chat Interface: Natural language interface for trading operations
- MCP Integration: Built on the Model Context Protocol for standardized communication
- Zerodha API Integration: Uses Zerodha's API to interact with the trading platform
- Agno Agent: Uses Agno Agent to interact with the trading platform
- Google ADK Agent: Uses Google ADK Agent to interact with the trading platform
Tech Stack
- Protocol: Model Context Protocol (MCP)
- Agent Framework:
- Agno
- Google ADK
Tools
- Place Orders: Place orders in the trading platform
- Modify Orders: Modify orders in the trading platform
- Cancel Orders: Cancel orders in the trading platform
- Get Orders: Get orders in the trading platform
- Get Order History: Get order history in the trading platform
- Get Order Trades: Get order trades in the trading platform
- Get Margins: Get margins in the trading platform
- Get Holdings: Get holdings in the trading platform
- Get Positions: Get positions in the trading platform
- Get User Profile: Get user profile in the trading platform
Prerequisites
- Python
- Zerodha trading account with Personal API access from here
- Zerodha API key and secret
- OpenAI API key (for Agno Agent)
- Gemini API key or Application Default Credentials (for Google ADK Agent)
Installation
1. Clone the repository:
git clone https://github.com/mtwn105/zerodha-mcp-server-client.git
cd zerodha-mcp-server-client
2. Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
3. Install dependencies:
pip install -r requirements.txt
4. Set up environment variables:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
