📈 Finance MCP Server

A powerful Model Context Protocol (MCP) server that brings comprehensive stock market data and technical analysis capabilities to Claude Desktop and other MCP-compatible clients.

🚀 Features

• 📊 Stock Information: Complete company profiles, market metrics, and key statistics
• 📈 Historical Data: Customizable historical price data with multiple timeframes
• ⚡ Real-time Quotes: Live stock prices with change calculations
• 🔧 Technical Indicators: 10+ professional-grade technical analysis tools
• 🚀 High Performance: Intelligent caching system for optimal speed
• 🛡️ Robust: Comprehensive error handling and validation
• 🔌 Easy Integration: One-command installation for Claude Desktop

📦 Quick Installation

For Claude Desktop Users

pip install finance-mcp-server

Then add to your Claude Desktop configuration:

{
  "mcpServers": {
    "finance": {
      "command": "finance-mcp-server"
    }
  }
}

Restart Claude Desktop and start asking about stocks! 🎉

Manual Installation

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

# Install in development mode
pip install -e .

# Or install from PyPI
pip install finance-mcp-server

🎯 Usage Examples

Once installed, you can ask Claude Desktop natural language questions like:

• “What’s Apple’s current stock price and market cap?”
• “Show me Tesla’s performance over the last 6 months”
• “Calculate RSI and MACD for Microsoft stock”
• “Compare the 50-day moving average of Google vs Amazon”
• “What are the Bollinger Bands for Netflix right now?”

🛠️ Available Tools

The Finance MCP Server exposes the following tools via the MCP protocol:

• get_comprehensive_stock_info: Get detailed company, market, financial, and analyst data for any stock symbol.
• get_historical_data: Retrieve historical price data with customizable period and interval, including splits/dividends.
• get_options_data: Fetch options chain data for a stock, including calls and puts for multiple expiration dates.
• get_institutional_holders: View institutional and major holders for a stock.
• get_earnings_calendar: Access earnings calendar, history, and analyst price targets.
• get_analyst_recommendations: Analyst recommendations, upgrades, and downgrades.
• get_financial_statements: Download full income statement, balance sheet, and cash flow (annual/quarterly).
• get_news: Latest news headlines and metadata for a stock.