# Kite MCP Server — Setup Guide

## Prerequisites
- Node.js 18+ installed
- ngrok account (free at ngrok.com)
- Zerodha Kite Connect app credentials

---

## Step 1 — Install dependencies
```
npm install
```

---

## Step 2 — Add your API Secret to .env
Open `.env` and replace `your_api_secret_here` with your actual API secret from:
https://developers.kite.trade/apps → click Jahangeer Shaik app → copy API Secret

---

## Step 3 — Set Redirect URL in Kite Connect
Go to your app settings on developers.kite.trade and set:
**Redirect URL:** `http://127.0.0.1:5000/callback`

---

## Step 4 — Get daily access token (do this every morning)
```
npm run auth
```
This opens Zerodha login in your browser → logs in → saves token automatically.

---

## Step 5 — Start MCP server
```
npm start
```
Server runs on: http://localhost:3000/mcp

---

## Step 6 — Start ngrok tunnel
```
ngrok http 3000
```
Copy the HTTPS URL shown e.g: `https://abc123.ngrok-free.app`

---

## Step 7 — Add to Claude.ai
1. Go to Claude.ai → Settings → Connectors → Add custom connector
2. Name: `Kite Zerodha`
3. URL: `https://abc123.ngrok-free.app/mcp`
4. Click Add ✅

---

## Daily Routine (market days)
1. `npm run auth` → login once
2. `npm start` → keep running
3. `ngrok http 3000` → keep running
4. Start chatting with Claude about your trades!

---

## Available Tools in Claude
- get_quote, get_ltp, get_ohlc, get_historical_data
- get_positions, get_holdings, get_margins
- get_orders, get_trades, place_order, modify_order, cancel_order
- get_gtts, place_gtt, modify_gtt, delete_gtt
- search_instruments