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 ☕️