Kite MCP Server

A Model Context Protocol (MCP) server for integrating with Zerodha Kite API. This server provides Claude with tools to interact with your Kite trading account.

Features

• Portfolio Management: Get positions, holdings, and orders

• Market Data: Real-time quotes, LTP, and instrument data

• Order Management: Place, modify, and cancel orders

• Account Info: Profile, margins, and authentication status

• Secure Authentication: OAuth 2.0 flow with token persistence

Related MCP server: Monad NFT Launch Tool

Prerequisites

1. Zerodha Kite Connect App: Create an app at Kite Connect

2. API Credentials: Get your API Key and Secret

3. Bun: Latest version of Bun runtime

Installation

1. Clone and install dependencies:

2. Set up environment variables:

3. Configure your Kite Connect app with redirect URL:

Quick Start

1. Authenticate with Kite API

This will:

• Start a local OAuth server

• Open your browser to Kite login

• Save your access token securely

2. Start the MCP Server

3. Configure Claude Desktop

Add to your Claude Desktop configuration:

Available Tools

Portfolio Tools

• get_profile - Get user profile information

• get_positions - Get current trading positions

• get_holdings - Get long-term holdings

• get_margins - Get account margins and funds

Order Tools

• get_orders - Get today's orders

• place_order - Place a new trading order

• cancel_order - Cancel an existing order

Market Data Tools

• get_ltp - Get Last Traded Price for instruments

• get_quote - Get detailed market quotes

• get_instruments - Get tradable instruments list

Utility Tools

• get_auth_status - Check authentication status

Project Structure

Development

Build (Optional)

Development Mode

Architecture

The project follows the Single Responsibility Principle:

• ConfigManager: Environment and configuration handling

• TokenManager: Token persistence and validation

• OAuthServer: OAuth 2.0 authentication flow

• KiteClient: Kite API wrapper with error handling

• KiteMCPServer: MCP protocol implementation

• Tools: Individual MCP tool implementations

Environment Variables

Security

• Tokens are stored locally in access_token.json

• OAuth flow uses secure redirect handling

• API credentials are never logged or exposed

• Tokens auto-expire for security

Troubleshooting

Authentication Issues

1. Verify API credentials in .env

2. Check redirect URL in Kite Connect app settings

3. Ensure OAuth port (50000) is available

Token Expiry

• Kite tokens expire every ~6 hours

• Re-run bun run auth when expired

• Server will notify you of authentication status

MCP Connection Issues

1. Verify Claude Desktop configuration

2. Check server is running: bun start

3. Look for errors in Claude Desktop logs

Contributing

1. Fork the repository

2. Create a feature branch

3. Follow the existing code structure and patterns

4. Add appropriate error handling

5. Submit a pull request

License

MIT License - see LICENSE file for details

Disclaimer

This is an unofficial integration with Zerodha Kite API. Use at your own risk. Always verify trades and orders before execution.