Yahoo Finance

Provides real-time and historical market data, portfolio analytics, and economic indicators via MCP.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "leo-ye0-mcp-finance-data": {
      "command": "python",
      "args": [
        "src/yahoo_finance_mcp/server.py"
      ],
      "env": {
        "PYTHONWARNINGS": "ignore"
      }
    }
  }
}

You run a Python-based MCP server that exposes Yahoo Finance data and related financial analytics through a clean, protocol-driven interface. This server lets you fetch real-time and historical market data, analyze portfolios, and retrieve economic indicators, all via a consistent MCP client workflow.

How to use

To use this MCP server, connect with an MCP client and query the available tools to retrieve stock/crypto data, perform portfolio analyses, and fetch market indicators. You can request current prices, historical series, earnings, dividends, news, and more, then compose analyses across multiple symbols to build dashboards or automated reports.

How to install

Prerequisites you need before starting:

Python 3.11.5 or later are installed on your system.

Step-by-step commands to set up and run the server locally:

git clone https://github.com/leo-ye0/yahoo-finance-mcp.git
cd yahoo-finance-mcp

python -m venv .venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate

pip install -e .

Starting the server directly from the repository:

python src/yahoo_finance_mcp/server.py

If you prefer an alternative local runtime configuration shown for Claude integration, you can also run the server via the MCP runtime with the provided CLI example (see the dedicated configuration entry below).

## Additional sections

Configuration, security considerations, and practical usage notes help you integrate and operate the server effectively.

## Available tools

### get\_stock\_info

Fetches comprehensive stock and cryptocurrency information including real-time price, historical data, market cap, volume, and classifications.

### get\_historical\_prices

Retrieves historical price data with customizable time ranges and intervals.

### get\_financial\_statements

Returns income statements, balance sheets, and cash flow data for specified symbols.

### get\_stock\_news

Fetches the latest news articles related to a given stock.

### get\_analyst\_recommendations

Retrieves analyst ratings and recent changes for specified symbols.

### get\_options\_data

Provides option chains including calls and puts for options-enabled symbols.

### compare\_stocks

Compares multiple stocks across metrics such as price, market cap, and ratios.

### get\_market\_summary

Gives a quick overview of major market indices and overall market sentiment.

### get\_holder\_info

Shows major holders, institutional investors, and insider trades.

### get\_earnings\_info

Delivers earnings dates, estimates, history, and trend data.

### get\_dividend\_info

Provides dividend history, yield, and upcoming payment dates.

### get\_balance\_sheet\_analysis

Offers detailed balance sheet metrics and trend analysis.

### get\_cash\_flow\_analysis

Delivers cash flow metrics and analysis across periods.

### get\_financial\_ratios

Returns key financial ratios across multiple categories for comparisons.