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

git clone 
cd Trade-MCP

2. Create and Activate a Virtual Environment

uv venv
.venv\Scripts\activate  # On Windows
# or
source .venv/bin/activate  # On Linux/Mac

3. Install Dependencies

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

2. Generate the Login URL

In a Python shell or script, run:

from kiteconnect import KiteConnect
   kite = KiteConnect(api_key="your_api_key")
   print(kite.login_url())

3. Extract the `request_token`

`http://localhost:8000/?request_token=REQUEST_TOKEN_HERE&action=login&status=success`

4. Exchange the `request_token` for an `access_token`

In a Python shell or script, run:

data = kite.generate_session("REQUEST_TOKEN_HERE", api_secret="your_api_secret")
   print(data["access_token"])

5. Set the Access Token

Usage

Run the MCP Server

uv run --with mcp[cli] mcp run server.py

Or, if MCP CLI is installed in your environment:

mcp run server.py

Claude Desktop Integration

1. Add a server entry in your `claude_desktop_config.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()`:

@mcp.tool()
def my_tool(...):
    ...

License

MIT License