What is Contextcraft

ContextCraft is an intelligent stock trading assistant that utilizes Claude and Zerodha KiteConnect for automated trading, portfolio risk analysis, and in-depth stock analysis. It allows natural language interaction for live trading and portfolio management through the MCP (Model Context Protocol).

Use cases

Use cases for ContextCraft include executing trades based on natural language commands, analyzing portfolio risks, managing stock investments, and utilizing AI tools for stock information and predictions.

How to use

To use ContextCraft, clone the repository, set up a virtual environment, install dependencies, and configure your API keys in the .env file. You can then run the server and interact with it using natural language commands for stock trading.

Key features

Key features of ContextCraft include placing market or limit orders, querying symbols, seamless integration with Claude Desktop, real-time stock data, advanced portfolio management, auto trading with conditions, portfolio risk analysis, earnings calendar, and an AI tool for stock explanations.

Where to use

ContextCraft can be used in the finance and investment sectors, particularly for individual traders, investment firms, and financial analysts looking for automated trading solutions and portfolio management tools.

ContextCraft: Claude-Ready Stock Trading MCP Server

Built by Arin Dhimar ✨
Claude-integrated 🧐 • Zerodha-powered 📈 • Python 3.10+ ✨

🚀 Overview

ContextCraft is an intelligent, Claude-compatible MCP (Model Context Protocol) server that lets Claude (or any MCP agent) perform live stock trading through Zerodha KiteConnect.

Speak naturally. Claude understands:

“Buy 10 shares of INFY at market price.”
“Sell 5 SBIN when it hits 780.”

🔧 Features

• Place Market or Limit orders
• Query symbols by substring
• Works seamlessly with Claude Desktop
• FastMCP-compatible — zero boilerplate
• Auto-installs kiteconnect
• Real-time stock data integration (via Zerodha KiteConnect API)
• Advanced portfolio management (coming soon)
• Full integration with the Claude platform for hands-free trading
• Auto Trade Assistant with conditions like price triggers
• Portfolio Risk Analyzer for better decision-making
• Earnings Calendar & Predictions for proactive trading strategies
• Explain This Stock AI Tool to simplify stock information

📂 Project Structure

📅 Installation

1. Clone the repo

git clone https://github.com/arindhimar/contextcraft.git
cd contextcraft

2. Setup virtual environment

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install dependencies

uv pip install -e .

4. Setup .env

API_KEY=your_kiteconnect_key
ACCESS_TOKEN=your_valid_access_token
RAPIDAPI_KEY =your_valid_rapidapi_key
RAPIDAPI_HOST = "indian-stock-exchange-api2.p.rapidapi.com"

▶️ How to Run

🚧 Development

mcp dev server.py

⚛️ Production

uv run python server.py

🧰 Tools Available

trade(symbol, side, quantity, price?)

Place a buy/sell order for a stock.

portfolio_risk_analyzer()

Analyzes your portfolio’s risk by evaluating the stocks you hold, their current prices, and their market volatility.

explain_stock(symbol)

Returns a simplified, AI-generated explanation of a stock, including its market trends, news, and predictions.

earnings_calendar()

Fetches the earnings calendar for the current or upcoming quarter, providing predictions on stock movements based on earnings announcements.

🌐 Claude Desktop Integration

Reload config in Claude Desktop. You’re live!

🚀 Future Ideas

• [ ] Tool to fetch holdings
• [ ] View order history
• [ ] Fetch current prices on demand
• [ ] Add more financial tools (alerts, watchlists, etc.)

🎓 License

MIT License © Arin Dhimar

Made with coffee, code & context ☕️