Zerodha MCP Server & Client

What is Zerodha MCP Server & Client?

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.

How to use Zerodha MCP Server & Client?

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”.

Key features of Zerodha MCP Server & Client

• 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

Use cases of Zerodha MCP Server & Client

• Place market orders for shares using plain‑language commands
• View real‑time portfolio holdings and margin details
• Cancel or modify existing orders without navigating the trading UI
• Fetch order history and trade details for a specific order
• Get user profile and account information

FAQ from Zerodha MCP Server & Client

What prerequisites are required?

You need Python, a Zerodha trading account with Personal API access (obtained from developers.kite.trade), and an OpenAI API key (for Agno) or Gemini API key or Application Default Credentials (for Google ADK).

Which agent frameworks are supported?

Agno and Google ADK agent frameworks are both supported; choose either agno_client.py or google_adk_client.py.

How do I configure authentication?

Set ZERODHA_API_KEY and ZERODHA_API_SECRET in your .env file. For the client, also set OPENAI_API_KEY or GOOGLE_API_KEY as required.

What transport modes are available?

The server can run in SSE mode or stdio mode, configured via SERVER_MODE in .env or the --mode command‑line argument.

Where can I get my Zerodha API key?

Log in to developers.kite.trade with your Zerodha credentials to generate your API key and secret.