Kite MCP

What aranjan/kite-mcp MCP server does

aranjan/kite-mcp MCP server exposes Zerodha Kite account and trading operations through the Model Context Protocol. An MCP-compatible assistant can use it to retrieve holdings, intraday and delivery positions, order history, available margins, live quotes, OHLC values, historical candles, and searchable instruments across NSE, BSE, NFO, and MCX.

Trading operations include placing buy and sell orders, modifying or cancelling pending orders, viewing Good Till Triggered orders, and creating single or OCO GTT triggers. The server supports delivery (CNC), intraday (MIS), F&O (NRML), and after-market orders (AMO), according to the supplied documentation.

How it works

The assistant interprets a natural-language request and calls the appropriate MCP tool. The server then communicates with the Zerodha Kite API. For example, an assistant can look up a company name, retrieve a quote, inspect available funds, and submit an order through separate tool calls.

Authentication can be automated with a Zerodha client ID, password, Kite Connect API credentials, and a TOTP seed. The server generates TOTP codes during login and can retry authentication when an access token becomes stale. Without the TOTP seed, a separate daily login command is required and the resulting token is cached for the day.

Setup and configuration

Install the Python package with pip install kite-mcp. Configure the MCP client to launch the kite-mcp command and provide these environment variables:

• KITE_API_KEY
• KITE_API_SECRET
• KITE_USER_ID
• KITE_PASSWORD
• KITE_TOTP_SECRET (optional)

The API key and secret come from a Kite Connect API app. The user ID is the Zerodha client ID. KITE_TOTP_SECRET is the base32 seed from an external authenticator setup and enables automated login. If it is omitted, run kite-mcp-login manually each day after setting the required credentials.

Tools and capabilities

The 14 documented tools are:

• kite_login for authentication with TOTP
• get_holdings, get_positions, and get_orders for account and trading records
• get_margins for available funds and margins
• get_quote, get_ohlc, and get_historical_data for market data
• get_instruments for finding tradeable instruments
• place_order, modify_order, and cancel_order for order management
• get_gtt_triggers and place_gtt for GTT orders, including single and OCO triggers

The tool set fits conversational portfolio reviews, quote checks, supported buy or sell requests, order cancellation, and stop-loss or target trigger setup. The assistant can work with stock names in plain English and map them to trading symbols, as described by the project.

Limitations and notes

This server requires a Zerodha account and Kite Connect API credentials. It is intended for local execution; the documentation states that credentials are passed through environment variables, access tokens are cached at ~/.zerodha_kite_token.json, and Zerodha communication uses HTTPS.

The TOTP secret is optional, but omitting it removes fully automated daily authentication. Access tokens expire daily, so manual-login users must repeat that process. The roadmap lists option-chain data, basket orders, mutual-fund tools, watchlist management, portfolio analytics, streaming alerts, and multiple-account support as future work rather than current capabilities.

Use aranjan/kite-mcp MCP server with a client that supports MCP, including Claude Desktop, Cursor, or Windsurf. The project is released under the MIT license.