Happy slice of mcp pizzaMCP.pizza

yfinance-mcp

MCP.Pizza Chef: narumiruna

Fifteen tools cover company profiles, price history, income statements and balance sheets, analyst targets and rating changes, headlines, screeners, option chains, holders and fund holdings, plus candlestick and volume charts drawn as pictures. Everything comes from Yahoo Finance, so there is no account to create and nothing to pay. The flip side is that Yahoo throttles heavy use, and the tool then simply reports that the limit was reached. Figures are delayed, and nothing here places a trade.

Data
Web/Research

Use This MCP server To

Compare two companies' revenue and profit over five years Ask what analysts currently think a stock is worth Get a price chart for a ticker without opening a website Catch up on this week's headlines for a company I own Screen for the day's biggest gainers in one question Check which funds hold the most of a given stock

README

Yahoo Finance MCP Server

PyPI version Python CI License: MIT

A Model Context Protocol (MCP) server that provides AI assistants with access to Yahoo Finance data via yfinance. Query stock information, financial news, sector rankings, and generate professional financial charts — all from your AI chat.

Features

  • Stock Data — Company info, financials, valuation metrics, dividends, and trading data
  • Analyst Data — Consensus targets, estimate/revision trends, recommendation history, and firm-level actions
  • Financial Statements — Income statement and balance sheet with historical data (EBIT, Invested Capital, etc.)
  • Financial News — Recent news articles and press releases for any ticker
  • Search — Find stocks, ETFs, and news across Yahoo Finance
  • Sector Rankings — Top ETFs, mutual funds, companies, growth leaders, and top performers by sector
  • Price History — Historical OHLCV data as markdown tables or professional charts
  • Chart Generation — Candlestick, VWAP, and volume profile charts returned as WebP images
  • Options Data — Option chains with calls, puts, strike prices, IV, and expiration dates
  • Ownership Data — Major holders, institutional investors, mutual fund holders, and insider transactions
  • Fund Look-Through — ETF and mutual-fund holdings, asset classes, sectors, ratings, and operating details
  • Screeners — Predefined, equity, mutual-fund, and ETF query trees

Tools

yfinance_get_ticker_info

Retrieve comprehensive stock data including company info, financials, trading metrics, and governance data.

Parameter Type Required Description
symbol string Yes Stock ticker symbol (e.g. AAPL, GOOGL, MSFT)

yfinance-mcp FAQ

Do I need a paid data subscription?
No. It reads public Yahoo Finance data, so there is no sign-up, no key and no bill.
Is the data live?
No. Yahoo's figures are delayed, and Yahoo throttles heavy use. When that happens the tool says the rate limit was reached and asks you to try later.
Can it buy or sell anything?
No. All fifteen tools only read. It cannot reach a brokerage account or move money.
Can I use this to research a company before I invest?
Yes. Profiles, financial statements, analyst targets, rating changes, news, options and holder lists are all covered. It is information, not advice.
Does it actually draw charts?
Yes. Candlestick, average-price and volume charts come back as pictures you can look at right in the conversation.
How hard is the setup?
One short block in your config that runs the published package. Python 3.12 or newer is needed, or you can use the ready-made container image instead.
Which apps does it work in?
Any assistant that starts a local helper from a config file. The readme does not single out one app.