Fyers MCP Server

MCP (Model Context Protocol) server for Fyers API v3 with automated OAuth authentication

A comprehensive MCP server that enables Claude Desktop to interact with Fyers trading platform through a secure, automated authentication flow. Supports all major trading operations including portfolio management, order placement, and real-time market data.

🎬 Demo

✨ Features

🔐 Smart Authentication

• One-click OAuth flow with automatic browser handling
• Persistent token storage in .env file
• Auto-refresh capabilities with session management

📊 Complete Trading Toolkit

• Portfolio Management: Holdings, positions, funds, profile
• Order Management: Place, modify, cancel orders
• Market Data: Real-time quotes for multiple symbols
• Order History: Complete order and trade book

🚀 Production Ready

• Full error handling with detailed error messages
• Type safety with parameter validation
• Comprehensive logging for debugging
• Claude Desktop integration with simple configuration

🚀 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!

🛠️ Available Tools

Authentication & Profile

• authenticate() - One-click OAuth authentication
• check_auth_status() - Verify current authentication
• get_profile() - User profile information

Portfolio & Funds

• get_funds() - Account balance and margin details
• get_holdings() - Portfolio holdings with P&L
• get_positions() - Current trading positions

Orders & Trading

• place_order(symbol, quantity, order_type, side, ...) - Place new orders
• modify_order(order_id, quantity, limit_price, ...) - Modify existing orders
• cancel_order(order_id) - Cancel pending orders
• get_orders() - Order history and status

Market Data

• `get_quotes(symb

... View full README on GitHub