Kite Connect MCP POC

A proof-of-concept TypeScript MCP server that demonstrates how MCP tools can call Kite Connect APIs over stdio. This project is intentionally incomplete and focuses on proving the primary concept rather than providing a production-ready trading integration.

Features

• greet: returns a greeting for a provided name.

• add_two_numbers: adds two numbers.

• factorial: calculates the factorial of a non-negative integer.

• buy_stock: places a Kite Connect market buy order on NSE.

• sell_stock: places a Kite Connect market sell order on NSE.

Related MCP server: NSE-BSE MCP Server

Prerequisites

• Node.js

• pnpm

• A Zerodha Kite Connect API key

• A valid Kite Connect access token

Setup

Install dependencies:

pnpm install

Create a .env file in the project root:

KITE_API_KEY=your_api_key
KITE_ACCESS_TOKEN=your_access_token

Run

Start the MCP server:

pnpm dev

The server uses stdio transport, so it is intended to be launched by an MCP-compatible client.

MCP Tools

buy_stock

Places a regular CNC market buy order on NSE.

Input:

{
  "stock": "INFY",
  "qty": 1
}

sell_stock

Places a regular CNC market sell order on NSE.

Input:

{
  "stock": "INFY",
  "qty": 1
}

greet

Input:

{
  "name": "Bhimanshu"
}

add_two_numbers

Input:

{
  "a": 2,
  "b": 3
}

factorial

Input:

{
  "a": 5
}

Safety Note

The buy_stock and sell_stock tools call Kite Connect's placeOrder API and can place real market orders. Use valid credentials carefully and test with small quantities only when you are ready to trade.

Project Structure

.
├── config.ts       # Loads required environment variables
├── index.ts        # Defines and starts the MCP server
├── trade.ts        # Wraps Kite Connect order placement
├── package.json    # Scripts and dependencies
└── tsconfig.json   # TypeScript configuration