ContextCraft
ContextCraft is an intelligent stock trading assistant powered by Claude and Zerodha KiteConnect, integrated with powerful tools for automated trading, portfolio risk analysis, and in-depth stock analysis. With seamless integration of MCP (Model Context Protocol), it enables natural language interaction for live trading, portfolio management.
GitHub Stars
4
User Rating
Not Rated
Forks
0
Issues
0
Views
0
Favorites
0
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
| File | Purpose |
|---|---|
server.py |
MCP server with trading tools |
main.py |
Minimal script entrypoint |
.env |
API key + token (Git ignored) |
pyproject.toml |
Project + dependency declarations |
π 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.
| Param | Type | Description |
|---|---|---|
| symbol | str |
Substring or full tradingsymbol |
| side | str |
"buy" or "sell" |
| quantity | int |
Number of shares |
| price | float? |
Leave blank or say "market" for LTP |
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.
| Param | Type | Description |
|---|---|---|
| symbol | str |
Substring or full tradingsymbol |
earnings_calendar()
Fetches the earnings calendar for the current or upcoming quarter, providing predictions on stock movements based on earnings announcements.
π Claude Desktop Integration
"mcpServers": {
"ContextCraft": {
"command": "uv",
"args": [
"--directory", "C:\\Users\\Arin Dhimar\\Documents\\ContextCraft\\mcp-server-contextcraft",
"run", "python", "server.py"
]
}
}
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 βοΈ