Yahoo Finance MCP Server

Yahoo Finance MCP Server

A simple MCP server to access Yahoo Finance data via standardized tools.

68
Stars
28
Forks
68
Watchers
0
Issues
Yahoo Finance MCP Server provides a Model Context Protocol (MCP) server enabling seamless access to financial data from Yahoo Finance. It offers a set of standardized tools to fetch stock information, news, historical prices, and perform advanced searches. The server can be deployed using either Docker or uv with straightforward configuration. It is designed to easily integrate with MCP-compatible AI environments and workflows.

Key Features

Retrieve comprehensive stock and company information
Fetch recent news articles related to specific stock symbols
Perform advanced search queries for quotes and news
Obtain top sector-based ETFs, companies, and funds
Access historical price data with customizable timeframes
Standardized MCP tool interface for AI and automation
Simple deployment via Docker or Python uv
Configurable input parameters for all endpoints
Integration with external financial analysis workflows
Tool consolidation for multiple finance data queries

Use Cases

Automated retrieval of up-to-date stock and company data for portfolio tracking
Monitoring financial news relevant to investment interests
Building AI agents that require real-time or historical market data
Sector analysis using top performing companies, ETFs, or mutual funds
Financial research and reporting through customizable queries
Supporting algorithmic trading setups with fresh market data
Generating summaries or dashboards from Yahoo Finance sources
Automating alerts based on financial news or stock movements
Enhancing financial chatbots with live finance data feeds
Academic or corporate financial trend analysis using standardized data access

README

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:
json
{
  "mcpServers": {
    "yfmcp": {
      "command": "uvx",
      "args": ["yfmcp@latest"]
    }
  }
}

Via Docker

Add the following configuration to your MCP server configuration file:

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

Star History

Star History Chart

Repository Owner

narumiruna
narumiruna

User

Repository Details

Language Python
Default Branch main
Size 534 KB
Contributors 4
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
91.99%
Dockerfile
5.91%
Makefile
2.09%

Tags

Topics

finance mcp mcp-server python yahoo-finance

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • FinData MCP Server

    FinData MCP Server

    Open-source MCP server for LLM access to professional financial data.

    FinData MCP Server offers standardized financial data access to large language models by implementing the Model Context Protocol. It supports multiple data providers such as Tushare and Wind, and enables retrieval of both market and macroeconomic data via Stdio or SSE transports. The server is configurable and integrates into AI systems, providing tools for market, fundamental, and financial data queries.

    • 45
    • MCP
    • zlinzzzz/finData-mcp-server
  • Dappier MCP Server

    Dappier MCP Server

    Real-time web search and premium data access for AI agents via Model Context Protocol.

    Dappier MCP Server enables fast, real-time web search and access to premium data sources, including news, financial markets, sports, and weather, for AI agents using the Model Context Protocol (MCP). It integrates seamlessly with tools like Claude Desktop and Cursor, allowing users to enhance their AI workflows with up-to-date, trusted information. Simple installation and configuration are provided for multiple platforms, leveraging API keys for secure access. The solution supports deployment via Smithery and direct installation with 'uv', facilitating rapid setup for developers.

    • 35
    • MCP
    • DappierAI/dappier-mcp
  • ZoomEye MCP Server

    ZoomEye MCP Server

    Real-time cyberspace asset intelligence for AI assistants via Model Context Protocol.

    ZoomEye MCP Server implements the Model Context Protocol (MCP) to provide network asset intelligence to AI assistants and development tools. It enables querying of global internet assets through ZoomEye's cyber asset search engine using structured parameters and dorks. The server includes features like caching, error handling, and compatibility with leading MCP environments, supporting real-time cyber asset data integration for various AI and developer platforms.

    • 50
    • MCP
    • zoomeye-ai/mcp_zoomeye
  • MLB API MCP Server

    MLB API MCP Server

    A Model Context Protocol server for seamless MLB data access through AI applications.

    MLB API MCP Server provides comprehensive access to MLB statistics and baseball data via a FastMCP-based interface. It exposes a range of MLB functionalities—including live game data, player statistics, team information, and advanced metrics—as MCP tools accessible by AI workflows. Compatible with MCP-enabled AI clients, it enables structured, schema-validated querying and integrations for baseball data.

    • 33
    • MCP
    • guillochon/mlb-api-mcp
  • Hacker News MCP Server

    Hacker News MCP Server

    An MCP server for accessing and analyzing Hacker News stories, comments, and users.

    Hacker News MCP Server implements the Model Context Protocol to provide tools for fetching and searching Hacker News stories, retrieving story comments, and accessing user information. It integrates seamlessly with AI assistants like Claude Desktop and supports use via Smithery. The server is designed for structured information retrieval, contextual exploration, and summarization of Hacker News content.

    • 55
    • MCP
    • erithwik/mcp-hn
  • Twelve Data MCP Server

    Twelve Data MCP Server

    Seamless AI-powered access to financial market data via the Twelve Data API.

    Twelve Data MCP Server provides a Model Context Protocol-compliant server for integrating and accessing Twelve Data’s financial market API. It enables users and AI agents to retrieve historical data, real-time quotes, and instrument metadata for stocks, forex, and crypto using natural language or endpoint calls. The system leverages AI-driven routing, including OpenAI GPT-4o, to intelligently map plain English queries to relevant API endpoints for structured or conversational workflows. Integration options are available for platforms like Claude Desktop and VS Code, with flexible local or remote deployment.

    • 43
    • MCP
    • twelvedata/mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results