概要
What is 🚀 Zerodha Trading Agent (MCP x Bun.js)?
This is an intelligent stock trading agent built with Bun.js, the Zerodha Kite Connect API, and Claude MCP Server Integration. It allows users to place trades, auto-buy or sell stocks based on triggers, and (on the roadmap) predict stock trends using historical data and live news.
How to use 🚀 Zerodha Trading Agent (MCP x Bun.js)?
Install dependencies with bun install, then configure your Kite Connect API key, secret, and access token in tokenStore.json. Optionally run bun login.ts to generate an access token. Start the server with bun index.ts; it runs on http://localhost:3000. For HTTPS (required by Kite Connect), tunnel with ngrok. Finally, add the MCP server configuration to your Claude toolchain, pointing to the Bun binary and index.ts.
Key features of 🚀 Zerodha Trading Agent (MCP x Bun.js)
- Place buy and sell orders automatically via MCP Agent
- Authenticate securely using Kite Connect
- Auto-refresh access tokens periodically
- Built with Bun.js for superfast runtime
- Fully compatible with Claude Toolchain / MCP Agents
- Smart GTT‑like watchlist and stock prediction (coming soon)
Use cases of 🚀 Zerodha Trading Agent (MCP x Bun.js)
- Automated stock trading through natural language conversation with Claude
- Auto-buy or sell stocks based on pre‑defined triggers
- Secure order placement without manual login each time
- Future: GTT‑style threshold orders for price crossing
- Future: Stock trend prediction using historical data and news
FAQ from 🚀 Zerodha Trading Agent (MCP x Bun.js)
What runtime and dependencies are required?
Bun.js must be installed. After cloning the repo, run bun install to pull dependencies. You also need a Zerodha Kite Connect API key and secret.
How do I obtain an access token?
Run bun login.ts to generate one manually. The server will then auto‑refresh the access token every 24 hours during normal operation.
How do I expose the server to Kite Connect via HTTPS?
Use ngrok to tunnel local port 3000 to a public HTTPS URL (e.g., https://abc1234.ngrok.io). Set that URL as the Redirect URL in your Kite Connect App configuration.
Does the agent currently support stock predictions?
No. Stock future prediction using charts and news is on the roadmap but not yet implemented. The current version handles placing buy and sell orders.
What transport and authentication does the MCP server use?
The server runs on HTTP (default port 3000). Authentication relies on Kite Connect API credentials (apiKey, apiSecret) and a persistent access token stored in tokenStore.json.
