# Trade-MCP
A modular trading automation project using Zerodha Kite Connect and MCP (Modular Command Platform) for tool-based and resource-based automation. This project exposes trading actions (like placing orders and fetching holdings) as MCP tools, making them accessible to Claude Desktop and other MCP-compatible clients.
---
## Features
- **Zerodha Integration:** Place buy/sell orders and fetch holdings using the Kite Connect API.
- **MCP Tools:** Expose trading actions as callable tools for automation and AI agents.
- **Environment-based Secrets:** API keys and secrets are loaded from a `.env` file for security.
- **Extensible:** Easily add new tools or resources for more trading actions.
---
## Setup
### 1. Clone the Repository
```sh
git clone <your-repo-url>
cd Trade-MCP
```
### 2. Create and Activate a Virtual Environment
```sh
uv venv
.venv\Scripts\activate # On Windows
# or
source .venv/bin/activate # On Linux/Mac
```
### 3. Install Dependencies
```sh
uv pip install -r requirements.txt
# or, if using pyproject.toml:
uv pip install .
```
### 4. Configure Environment Variables
Create a `.env` file in the project root:
```
API_KEY=your_zerodha_api_key
API_SECRET=your_zerodha_api_secret
```
### 5. Get Your Zerodha Access Token
To use the Zerodha API, you need an **access token**. Follow these steps:
1. **Get Your API Key and Secret**
- Obtain these from the [Zerodha developer console](https://developers.kite.trade/apps).
2. **Generate the Login URL**
In a Python shell or script, run:
```python
from kiteconnect import KiteConnect
kite = KiteConnect(api_key="your_api_key")
print(kite.login_url())
```
- Open the printed URL in your browser and log in with your Zerodha credentials.
3. **Extract the `request_token`**
- After login, you will be redirected to your redirect URL (set in the Zerodha app settings).
- The URL will look like:
`http://localhost:8000/?request_token=REQUEST_TOKEN_HERE&action=login&status=success`
- Copy the `request_token` value from the URL.
4. **Exchange the `request_token` for an `access_token`**
In a Python shell or script, run:
```python
data = kite.generate_session("REQUEST_TOKEN_HERE", api_secret="your_api_secret")
print(data["access_token"])
```
- Replace `"REQUEST_TOKEN_HERE"` and `"your_api_secret"` with your actual values.
- The printed value is your `access_token`.
5. **Set the Access Token**
- You can set this as an environment variable or use it directly in your code as needed.
---
## Usage
### Run the MCP Server
```sh
uv run --with mcp[cli] mcp run server.py
```
Or, if MCP CLI is installed in your environment:
```sh
mcp run server.py
```
### Claude Desktop Integration
1. Add a server entry in your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"Trade-MCP": {
"command": "uv.EXE", # Exact Path to uv executable
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"server.py" # Exact Path to your server script
]
}
}
}
```
2. Restart Claude Desktop.
3. The tools will appear in Claude's tool list.
---
## Exposed Tools
- `add(a: int, b: int)`: Add two numbers.
- `place_zerodha_buy_order(symbol: str, quantity: int)`: Place a buy order.
- `place_zerodha_sell_order(symbol: str, quantity: int)`: Place a sell order.
- `get_zerodha_holdings()`: Get all holdings from Zerodha.
---
## Extending
To add a new tool, define a function in `server.py` and decorate it with `@mcp.tool()`:
```python
@mcp.tool()
def my_tool(...):
...
```
---
## License
MIT License
---
