Zerodha Mcpserver

🚀 Zerodha Kite Connect MCP Server

This is a Cloudflare Worker that serves as a Model Context Protocol (MCP) server for interacting with the Zerodha Kite Connect API. It offers comprehensive interfaces for trading and portfolio management through Zerodha.

✨ Features

• Zerodha authentication and session management
• Portfolio management (holdings, positions)
• GTT (Good Till Triggered) orders
• Historical data retrieval
• MCP-compatible responses for seamless integration with Claude Desktop and other MCP clients

📦 Installation

Prerequisites

• Zerodha Kite Connect API credentials (API key and secret)
• A Cloudflare account

Deployment

1. Clone this repository.
2. Install dependencies:

   npm install
   

3. Create a configuration file:

   cp wrangler.jsonc.example wrangler.jsonc
   

4. Configure Zerodha API credentials in the wrangler.jsonc file:
   • Update the values of ZERODHA_API_KEY and ZERODHA_API_SECRET.
   • Note: This file is ignored by Git to prevent accidental commits of sensitive information.
5. Create a KV namespace on Cloudflare:

   wrangler kv:namespace create ZERODHA_KV
   

6. Update the KV namespace ID in the wrangler.jsonc file.
7. Add Node.js compatibility to use the crypto module:

   {
     "compatibility_date": "2023-10-25",
     "compatibility_mode": "node"
   }
   

8. Run and test the worker using the following commands:

   npx wrangler dev
   npx wrangler dev --test
   

🔒 Security

• API keys and secrets are securely stored in Cloudflare environment variables.
• Access tokens are stored in the Cloudflare KV namespace.
• The wrangler.jsonc file containing credentials is ignored by Git to prevent accidental exposure.
• Only necessary endpoints are exposed to minimize the attack surface.

📚 Documentation

For more information about the Zerodha Kite Connect API, please refer to the official documentation:

• Kite Connect API Documentation
• Kite Connect API - Authentication
• Kite Connect API - Portfolio
• Kite Connect API - GTT Orders
• Kite Connect API - Historical Data

📚 MCP Documentation

For more information about the Model Context Protocol (MCP), please refer to:

• Model Context Protocol Documentation