📈 Finance MCP Server

What is 📈 Finance MCP Server?

A Model Context Protocol (MCP) server that brings comprehensive stock market data and technical analysis capabilities to MCP-compatible clients such as Claude Desktop. It provides real-time quotes, historical data, professional-grade indicators, and company fundamentals via the Yahoo Finance API.

How to use 📈 Finance MCP Server?

Install the package with pip install finance-mcp-server and add a JSON configuration entry under mcpServers in Claude Desktop. Once configured, ask natural language questions like “What’s Apple’s current stock price and market cap?” or “Calculate RSI for Microsoft.” The server exposes eleven MCP tools covering everything from stock info to sector performance.

Key features of 📈 Finance MCP Server

• Complete stock profiles and market metrics
• Customizable historical price data (multiple timeframes)
• Live stock prices with change calculations
• 10+ professional technical analysis indicators
• Intelligent caching for optimal performance
• Robust error handling and validation

Use cases of 📈 Finance MCP Server

• Get current stock price, market cap, and key statistics
• Analyze historical performance over weeks or months
• Compute RSI, MACD, Bollinger Bands, and moving averages
• Compare moving averages across multiple stocks
• Retrieve earnings calendar, options chain, and analyst recommendations

FAQ from 📈 Finance MCP Server

What data source does the server use?

All data is retrieved in real-time from Yahoo Finance; no user data is stored or tracked.

What are the runtime requirements?

Python 3.8 or higher, with dependencies: mcp >= 1.0.0, yfinance >= 0.2.18, pandas >= 2.0.0, and ta >= 0.10.2.

How is caching handled?

Company info, news, options, holders, and recommendations are cached for 5–60 minutes. Real-time data caches for 1 minute. Fundamentals cache for 10 minutes.

What transport and authentication are used?

The server uses the MCP protocol’s standard stdio transport. No authentication is required; data is fetched from public Yahoo Finance endpoints.

How can I report issues or contribute?

Report bugs or request features via the GitHub Issues page. Contributions are welcome – fork the repo, create a feature branch, run tests (pytest), and submit a pull request.