Fyers Mcp Server

🚀 Quick Start

Prerequisites

• Python 3.10 or higher
• Claude Desktop installed
• Fyers Trading Account with API access

1. Installation

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

# Install dependencies using uv (recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync

# Or install with pip
pip install .

2. Get Fyers API Credentials

1. Create Fyers API App:

   • Visit Fyers API Dashboard
   • Create a new app with redirect URI: http://localhost:8080/
   • Note down your App ID and Secret Key

2. Configure Environment:

   cp .env.example .env
   

   Edit .env file:

   FYERS_CLIENT_ID=YOUR_APP_ID-100     # e.g., ABC123XYZ-100
   FYERS_SECRET_KEY=YOUR_SECRET_KEY    # Secret from Fyers app
   FYERS_REDIRECT_URI=http://localhost:8080/
   

3. Configure Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fyers-mcp-server": {
      "command": "uv",
      "args": [
        "run", 
        "--directory",
        "/path/to/fyers-mcp-server",
        "python",
        "fyers_mcp_complete.py"
      ],
      "env": {
        "PYTHONWARNINGS": "ignore"
      }
    }
  }
}

4. First Run

1. Restart Claude Desktop
2. Authenticate: In Claude, type: authenticate
3. Browser will open → Login to Fyers → Automatic token capture
4. Start trading: All 11 tools are now available!

📖 Usage Examples

Portfolio Analysis

# Check account balance
get_funds()

# View all holdings with P&L
get_holdings()

# Check current positions
get_positions()

Order Management

# Place a market order
place_order("NSE:SBIN-EQ", 10, "MARKET", "BUY")

# Place a limit order
place_order("NSE:RELIANCE-EQ", 5, "LIMIT", "BUY", limit_price=2500)

# Modify an order
modify_order("ORDER_ID", quantity=15, limit_price=2550)

# Cancel an order
cancel_order("ORDER_ID")

Market Data

# Get live quotes
get_quotes("NSE:SBIN-EQ,NSE:RELIANCE-EQ,NSE:TCS-EQ")

🔧 Configuration Options

Order Types

• MARKET - Market order (immediate execution)
• LIMIT - Limit order (execute at specific price)
• STOP - Stop loss order
• STOPLIMIT - Stop limit order

Product Types

• MARGIN - Margin trading (intraday with leverage)
• CNC - Cash and Carry (delivery)
• INTRADAY - Intraday trading
• BO - Bracket Order
• CO - Cover Order

Validity Options

• DAY - Valid for current trading day
• IOC - Immediate or Cancel
• GTD - Good Till Date