narumiruna/yfinance-mcp
Free使用 Yahoo Finance API 获取金融数据,方便进行股票分析。
FreeFree tier
About narumiruna/yfinance-mcp
The Yahoo Finance MCP Server is a Model Context Protocol (MCP) server that provides AI assistants with access to Yahoo Finance data via the yfinance Python library. It enables querying comprehensive stock information, financial statements, recent news, sector rankings, historical price data, professional financial charts (candlestick, VWAP, volume profile), options chains, and ownership data. The server exposes a set of tools (e.g., yfinance_get_ticker_info, yfinance_search, yfinance_get_top) that can be invoked by compatible AI chat interfaces to retrieve structured financial data and visualizations.
Key Features
Company info, valuation metrics, dividends, and trading data
Income statement and balance sheet with historical data (EBIT, Invested Capital, etc.)
Recent news articles and press releases for any ticker
Search Yahoo Finance for stocks, ETFs, and news articles
Top-ranked ETFs, mutual funds, companies, growth leaders, and top performers by sector
Historical OHLCV data as markdown tables or professional financial charts
Candlestick, VWAP, and volume profile charts returned as WebP images
Options chains with calls, puts, strike prices, implied volatility, and expiration dates
Major holders, institutional investors, mutual fund holders, and insider transactions
Run predefined or custom screeners for equity and fund queries
Pros & Cons
Pros
- Free and open source with no API key required
- Comprehensive coverage of Yahoo Finance data including financials, news, and charts
- MCP standard integration enables use with AI chat interfaces like Claude and Copilot
- Multiple pre-built tools covering a wide range of financial data needs
- Includes professional chart generation (candlestick, VWAP, volume profile)
- Supports both predefined and custom screeners for flexible queries
Cons
- Data accuracy and availability depend on Yahoo Finance (yfinance library), which may have delays or gaps
- No option to specify date ranges for price history (limited to 'max' by default in one tool?)
- Requires running an MCP client/server setup; not a standalone application
- Chart generation may have size or performance limitations for very large datasets
Best For
Retrieve detailed stock fundamentals and valuation for investment researchFetch latest news and press releases for monitoring market sentimentSearch for tickers across stocks, ETFs, and news by keywordGet top-performing assets within a specific sector for portfolio comparisonGenerate candlestick and VWAP charts for technical analysisObtain options chain data for options trading strategiesAccess institutional ownership and insider transactions for due diligence
FAQ
What is the Yahoo Finance MCP Server?
It is a Model Context Protocol (MCP) server that allows AI assistants to access and query a wide range of Yahoo Finance data, including stock fundamentals, news, sector rankings, historical prices, charts, options, and ownership data.
Do I need an API key to use this tool?
No, the server uses the free yfinance Python library, which does not require an API key. However, you must have the MCP client configured to connect to the server.
What types of charts can it generate?
It can generate candlestick charts, VWAP charts, and volume profile charts, returned as WebP images.
Can I search for any stock ticker?
Yes, you can use the yfinance_search tool to search for stocks, ETFs, and news articles across Yahoo Finance by company name, ticker symbol, or keywords.
What sectors are supported for top rankings?
Supported sectors include Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, and Utilities.