dhan-mcp-server by vikkysarswat - MCP Server

Dhan MCP Server - Python Trading API Integration with Model Context Protocol

Production-ready MCP server for algorithmic trading with Dhan broker API - Complete integration with Dhan trading platform providing market data, order management, portfolio tracking, and real-time trading capabilities through the Model Context Protocol.

🚀 Overview

The Dhan MCP Server is a comprehensive Python-based Model Context Protocol (MCP) server that enables seamless integration with the Dhan trading platform. Ideal for algorithmic trading, automated trading systems, trading bots, and quantitative trading strategies in Indian stock markets.

Key Features

Complete Trading Suite: 19 production-ready tools for order execution, position management, and market analysis
Real-time Market Data: Live LTP, OHLC, market depth, and tick-by-tick data streaming
Order Management: Place, modify, cancel orders with support for all order types (Market, Limit, Stop Loss, Cover, Bracket)
Risk Management: Pre-trade margin calculation and position monitoring
Historical Data: Access to intraday and daily historical data for backtesting
Portfolio Tracking: Real-time positions, holdings, and P&L monitoring
MCP Protocol: Standards-compliant Model Context Protocol implementation using FastMCP

📋 Installation

Prerequisites

Python 3.8 or higher
Dhan trading account with API access
Dhan API credentials (Client ID and Access Token)

Quick Start

# Clone the repository
git clone https://github.com/vikkysarswat/dhan-mcp-server.git
cd dhan-mcp-server

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
export DHAN_CLIENT_ID="your_client_id"
export DHAN_ACCESS_TOKEN="your_access_token"

# Run the MCP server
python -m dhan_mcp_server

Installation via pip

pip install dhan-mcp-server

Configuration

Create a .env file in the project root:

DHAN_CLIENT_ID=your_dhan_client_id
DHAN_ACCESS_TOKEN=your_dhan_access_token

📊 Complete Feature Matrix

Account Management (3 Tools)

Tool	Functionality	Status
`get_profile()`	User profile and account information	✅ Complete
`validate_token()`	Access token validation and expiry	✅ Complete
`get_fund_limits()`	Account balance and margin information	✅ Complete

Trading Operations (4 Tools)

Tool	Functionality	Status
`place_order({...})`	Place new orders (all types & products)	✅ Complete
`modify_order({...})`	Modify pending orders	✅ Complete
`cancel_order({orderId})`	Cancel pending orders	✅ Complete
`slice_order({...})`	Handle large quantity orders	✅ Complete

Order & Trade Tracking (5 Tools)

Tool	Functionality	Status
`get_orders()`	Current day's order book	✅ Complete
`get_order_by_id({orderId})`	Specific order details	✅ Complete
`get_order_by_correlation_id({correlationId})`	Find order by custom ID	✅ Complete
`get_trades()`	Current day's executed trades	✅ Complete
`get_trades_by_order_id({orderId})`	Trades for specific order	✅ Complete

Position & Holdings Management (2 Tools)

Tool	Functionality	Status
`get_positions()`	Real-time open positions	✅ Complete
`get_holdings()`	Long-term holdings portfolio	✅ Complete

Risk Management (1 Tool)

Tool	Functionality	Status
`calculate_margin({...})`	Pre-trade margin calculation	✅ Complete

Market Data (3 Tools)

Tool	Functionality	Status
`get_market_ltp({...})`	Live last traded prices	✅ Complete
`get_market_ohlc({...})`	OHLC data with volume	✅ Complete
`get_market_depth({...})`	Full market depth & order book	✅ Complete

Historical Data & Analysis (3 Tools)

Tool	Functionality	Status
`get_historical_data({...})`	Daily OHLC historical data	✅ Complete
`get_intraday_data({...})`	Minute-level intraday data	✅ Complete
`get_tick_data({...})`	Tick-by-tick historical data	✅ Complete

🔧 Usage Examples

Place a Market Order

from dhan_mcp_server import DhanMCPServer

server = DhanMCPServer()
order = server.place_order(
    security_id="1333",  # Reliance
    exchange="NSE",
    transaction_type="BUY",
    quantity=1,
    order_type="MARKET",
    product_type="INTRADAY"
)

Get Real-time Market Data

# Get LTP for multiple securities
ltp_data = server.get_market_ltp(
    exchange="NSE",
    security_ids=["1333", "11536"]  # Reliance, TCS
)

# Get market depth
depth = server.get_market_depth(
    exchange="NSE",
    security_id="1333"
)

Retrieve Historical Data

import datetime

historical = server.get_historical_data(
    security_id="1333",
    exchange="NSE",
    instrument="EQUITY",
    from_date=datetime.date(2024, 1, 1),
    to_date=datetime.date(2024, 12, 31)
)

🏗️ Architecture

Built with:

FastMCP: High-performance MCP server framework
Dhan Python SDK: Official Dhan trading API client
Python AsyncIO: Asynchronous operations for real-time data

🔐 Security

Never commit API credentials to version control
Use environment variables or secure vaults for sensitive data
Implement IP whitelisting on Dhan platform
Enable 2FA on your Dhan account

📝 API Documentation

For detailed Dhan API documentation, visit:

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Related Projects

FastMCP - MCP server framework
Model Context Protocol - Protocol specification
Dhan Trading Platform - Trading broker

📧 Support

For issues, questions, or feature requests, please open an issue on GitHub.

Keywords

algorithmic trading, trading bot, stock market API, Dhan API, MCP server, Model Context Protocol, Python trading, automated trading, quantitative trading, Indian stock market, NSE, BSE, equity trading, derivatives trading, market data API, real-time trading, trading automation, backtesting, trading strategy