Kite Trading MCP Server

Trade on Indian stock markets via AI — Claude, ChatGPT, VS Code, or any MCP client.

78 tools · Paper trading · Backtesting · Options Greeks · 8 safety checks · Telegram alerts · SEBI compliant

What it does

Connect any AI assistant to your Zerodha Kite account. Place orders, analyze portfolio, run backtests, compute options Greeks — all through natural conversation. 8 RiskGuard safety checks prevent costly mistakes before orders hit the exchange. Paper trading mode lets you practice risk-free.

Quick Start

1. Connect — add to your MCP client config:

{
  "mcpServers": {
    "kite": {
      "command": "npx",
      "args": ["mcp-remote", "https://kite-mcp-server.fly.dev/mcp"]
    }
  }
}

2. Login — tell your AI: "Log me in to Kite". Complete the OAuth flow in your browser.

3. Trade — ask anything: "Show my portfolio", "What's RELIANCE at?", "Backtest SMA crossover on INFY".

New to this? Start with paper trading: "Enable paper trading mode" — all orders are simulated, no real money at risk.

Features

Comparison

The official server is the right choice for read-only use. This server is for traders who want order placement, safety rails, and analytics.

Client Setup

Claude Code

// ~/.claude.json → mcpServers
{
  "kite": {
    "command": "npx",
    "args": ["mcp-remote", "https://kite-mcp-server.fly.dev/mcp"]
  }
}

Claude Desktop

Add to ~/.config/Claude/claude_desktop_config.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "kite": {
      "command": "npx",
      "args": ["mcp-remote", "https://kite-mcp-server.fly.dev/mcp"]
    }
  }
}

ChatGPT Desktop

Settings → Tools & Integrations → MCP Servers → Add:

https://kite-mcp-server.fly.dev/mcp

VS Code / Cursor

Add to .vscode/mcp.json:

{
  "servers": {
    "kite": {
      "command": "npx",
      "args": ["mcp-remote", "https://kite-mcp-server.fly.dev/mcp"]
    }
  }
}

Windsurf

Add to MCP configuration:

{
  "mcpServers": {
    "kite": {
      "command": "npx",
      "args": ["mcp-remote", "https://kite-mcp-server.fly.dev/mcp"]
    }
  }
}

Self-Hosted

git clone https://github.com/Sundeepg98/kite-mcp-server && cd kite-mcp-server
go build -o kite-mcp-server && ./kite-mcp-server

Point your client to http://localhost:8080/mcp with --allow-http.

Safety: RiskGuard

Every order passes through 8 checks before reaching the exchange. Any failure blocks the order instantly.

All limits are per-user, configurable, and persisted to SQLite. Paper trading mode bypasses the exchange entirely — orders are simulated locally.

Dashboard

SSO is automatic — login once via MCP OAuth, dashboard session follows.

Architecture

AI Client ←→ MCP Protocol ←→ Kite MCP Server ←→ Kite Connect API ←→ NSE/BSE

• Go with mcp-go v0.46.0
• SQLite for persistence (credentials, alerts, sessions, audit trail — all AES-256-GCM encrypted)
• OAuth 2.1 + PKCE — each user brings their own Kite developer app
• Fly.io deployment with static egress IP for SEBI compliance
• Litestream continuous SQLite replication to R2
• Telegram daily briefings (9 AM alerts + 3:35 PM P&L)

Prerequisites

• A Kite Connect developer app (Rs 500/month from Zerodha)
• npx (Node.js 18+) for mcp-remote — or self-host with Go 1.25+

Contributing

Contributions welcome. Check open issues for ideas.

nix develop          # or: install Go 1.25+
just build           # compile
just test            # run 487 tests
just lint            # format + lint

License

MIT

Disclaimer

This software is not financial advice. Not affiliated with Zerodha. Trading involves risk — use at your own risk. SEBI-regulated operations require compliance with applicable regulations.