Zerodha Kite Connect MCP Server

This is a Cloudflare Worker that serves as an MCP (Multi-Cloud Provider) server for interacting with the Zerodha Kite Connect API. It provides a RESTful API interface to various Zerodha trading functionalities.

Features

Authentication with Zerodha
User profile information
Margins and funds
Holdings and positions
Order placement and management
Instrument details

Setup

Prerequisites

Zerodha Kite Connect API credentials (API Key and Secret)
Cloudflare account

Deployment

Clone this repository
Install dependencies:
npm install
Create your configuration file:
cp wrangler.jsonc.example wrangler.jsonc
Configure your Zerodha API credentials in the wrangler.jsonc file:
- Update the ZERODHA_API_KEY and ZERODHA_API_SECRET values
- Note: This file is gitignored to prevent committing sensitive information
Create a KV namespace in Cloudflare:
wrangler kv:namespace create ZERODHA_KV
Update the wrangler.jsonc file with the KV namespace ID
Deploy the worker:
npm run deploy

API Endpoints

GET /api/login - Redirects to Zerodha login page
POST /api/session - Exchange request token for access token
GET /api/profile - Get user profile
GET /api/margins - Get user margins
GET /api/holdings - Get user holdings
GET /api/orders - Get user orders
POST /api/orders - Place a new order
GET /api/positions - Get user positions
GET /api/instruments?exchange=NSE - Get instruments for a specific exchange

Authentication Flow

Redirect the user to /api/login
After successful login, Zerodha will redirect to your registered redirect URL with a request_token
Send a POST request to /api/session with the request_token to obtain an access token
The access token will be stored in the KV namespace for subsequent API calls

Security

API keys and secrets are stored securely in Cloudflare environment variables or KV namespace
CORS headers are properly configured
Access tokens are managed securely

Development

To run the worker locally:

npm run dev

License

MIT