What is Yfinance Mcp

yfinance-mcp is a simple MCP server designed to interact with Yahoo Finance using the yfinance library. It provides tools to fetch stock data, news, and other financial information.

Use cases

Use cases include building dashboards for tracking stock performance, developing trading algorithms, and creating financial news aggregation tools.

How to use

To use yfinance-mcp, first install the ‘uv’ package. Then, add the specified configuration to your MCP server configuration file to set it up.

Key features

Key features include fetching ticker information, retrieving ticker news, searching for quotes, accessing market data, and exploring sectors and industries.

Where to use

yfinance-mcp can be used in financial applications, investment analysis tools, and any software requiring access to stock market data and news.

Yahoo Finance MCP Server

A simple MCP server for Yahoo Finance using yfinance. This server provides a set of tools to fetch stock data, news, and other financial information.

Tools

• get_ticker_info

  • Retrieve stock data including company info, financials, trading metrics and governance data.
  • Inputs:
    • symbol (string): The stock symbol.

• get_ticker_news

  • Fetches recent news articles related to a specific stock symbol with title, content, and source details.
  • Inputs:
    • symbol (string): The stock symbol.

• search

  • Fetches and organizes search results from Yahoo Finance, including stock quotes and news articles.
  • Inputs:
    • query (string): The search query (ticker symbol or company name).
    • search_type (string): Type of search results to retrieve (options: “all”, “quotes”, “news”).

• get_top

  • Get top entities (ETFs, mutual funds, companies, growth companies, or performing companies) in a sector.
  • Inputs:
    • sector (string): The sector to get.
    • top_type (string): Type of top companies to retrieve (options: “top_etfs”, “top_mutual_funds”, “top_companies”, “top_growth_companies”, “top_performing_companies”).
    • top_n (number, optional): Number of top entities to retrieve (default 10).

• get_price_history

  • Fetch historical price data for a given stock symbol over a specified period and interval.
  • Inputs:
    • symbol (string): The stock symbol.
    • period (string, optional): Time period to retrieve data for (e.g. ‘1d’, ‘1mo’, ‘1y’). Default is ‘1mo’.
    • interval (string, optional): Data interval frequency (e.g. ‘1d’, ‘1h’, ‘1m’). Default is ‘1d’.

Usage

You can use this MCP server either via uv (Python package installer) or Docker.

Via uv

1. Install uv
2. Add the following configuration to your MCP server configuration file:

{
  "mcpServers": {
    "yfmcp": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}

Via Docker

Add the following configuration to your MCP server configuration file:

{
  "mcpServers": {
    "yfmcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "narumi/yfinance-mcp"
      ]
    }
  }
}