Financial Data MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with real-time financial market data through Yahoo Finance.

Features

• Stock Data: Current prices, historical data, market metrics
• Options: Options chains with strikes, prices, and volume
• Technical Analysis: Moving averages, RSI, Sharpe ratio
• Comparisons: Compare multiple stocks across metrics
• News: Get recent company news headlines
• Dividends: Get dividend history for a stock

Installation

pip install "mcp[cli]" yfinance pandas numpy

Configuration

Add to Claude Desktop config:

{
  "mcpServers": {
    "financial-data": {
      "command": "python",
      "args": ["path/to/server.py"],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

Available Tools

Here is a detailed list of the tools available through this server.

Stock Data

• `get_stock_price(symbol: str)`

> Get current stock price and basic info.

• `get_historical_data(symbol: str, period: str = "1mo", interval: str = "1d")`

> Get historical price data for a stock.

• `get_options_chain(symbol: str, expiration_date: Optional[str] = None, sort_by: Optional[str] = "volume", limit: int = 20, descending: bool = True)`

> Get options chain data for a stock.

• `get_company_news(symbol: str, limit: int = 5)`

> Get recent company news headlines.

• `get_dividends(symbol: str, period: str = "5y")`

> Get dividend history for a stock.

Financial Calculations

• `calculate_moving_average(symbol: str, period: int = 20, ma_type: str = "SMA")`

> Calculate moving average for a stock.

• `calculate_rsi(symbol: str, period: int = 14)`

> Calculate Relative Strength Index (RSI) for a stock.

• `calculate_sharpe_ratio(symbol: str, period: str = "1y", risk_free_rate: float = 0.05)`

> Calculate Sharpe Ratio for a stock.

Comparison

• `compare_stocks(symbols: List[str], metric: str = "performance")`

> Compare multiple stocks by various metrics.

Utility

• `clear_cache()`

> Clear the cache to force fresh data retrieval.

Usage Examples

"What's the current price of AAPL?"
"Show me TSLA's 50-day moving average"
"Compare AAPL, MSFT, and GOOGL performance"
"Get SPY options expiring this Friday"
"What is the latest news for NVDA?"
"Show me the dividend history for KO over the last 10 years."

Troubleshooting

• Missing modules: Run `pip install yfinance pandas numpy "mcp[cli]"`
• No data: Verify ticker symbol and internet connection
• Server issues: Check Python path in config, restart Claude Desktop

Notes

• Data from Yahoo Finance (15-20 minute delay)
• Automatic caching and rate limiting
• For informational purposes only

License

MIT License