Fyers Mcp Server

Created By
quantaboxa year ago
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.
Overview

Fyers MCP Server

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

Python 3.10+ Fyers API v3 License: MIT

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.

✨ 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

🛠️ 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(symbols) - Real-time quotes for multiple symbols

⚠️ Disclaimer

This software is for educational and development purposes. Trading involves financial risk. Users are responsible for their trading decisions and should thoroughly test in demo environments before live trading.

📊 Status

  • Current Version: 1.0.0
  • API Compatibility: Fyers API v3.1.7
  • Python Support: 3.10+
  • Tools Available: 11/11 ✅
  • Production Ready: Yes ✅

Made with ❤️ for the trading community
Enable algorithmic trading with Claude's intelligence

Server Config

{
  "mcpServers": {
    "fyers-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "<path to the repo>/fyers-mcp-server",
        "python",
        "fyers_mcp_complete.py"
      ],
      "env": {
        "PATH": "<path to any uv path, this is optional>",
        "PYTHONWARNINGS": "ignore"
      }
    }
  }
}
Project Info
Created At
a year ago
Updated At
a year ago
Author Name
quantabox
Star
-
Language
-
License
-
Category

Recommend Servers

View All
Docwand

20 hours ago
Orkestr

5 hours ago
Tavily Mcp
@tavily-ai

JavaScript
a year ago