narumiruna/yfinance-mcp

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) |
**Returns:** JSON object with company details, price data, valuation metrics, trading info, dividends, financials, and performance indicators.
yfinance_get_analyst_price_targets
Fetch the current price and analyst consensus price targets for a stock.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| symbol | string | Yes | Stock ticker symbol (e.g. AAPL, GOOGL, MSFT) |
**Returns:** JSON object with current, low, high, mean, and median price fields. Analyst coverage and available fields vary by symbol.
yfinance_get_analyst_estimates
Fetch analyst consensus estimates, revision momentum, recommendations, growth estimates, and earnings history.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| symbol | string | Yes | Stock ticker symbol |
| sections | array | No | Any of recommendations, earnings_estimate, revenue_estimate, eps_trend, eps_revisions, earnings_history, or growth_estimates. Omit for all sections |
| max_rows | number | No | Maximum rows per section. Default: 12. Use 0 for all rows |
**Returns:** Named arrays for available sections plus _metadata containing per-section row counts, truncation status, unavailable sections, and failed sections. A failure in one section does not discard successfully fetched sections.
yfinance_get_upgrades_downgrades
Fetch analyst upgrades, downgrades, initiations, reiterations, and price-target changes, newest first.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| symbol | string | Yes | Stock ticker symbol |
| max_rows | number | No | Maximum actions to return. Default: 25. Use 0 to return all rows |
**Returns:** JSON object containing upgrades_downgrades records and _metadata with row counts and truncation status. Records can include:
- GradeDate: Date and time of the analyst action
- Firm: Analyst firm name
- ToGrade and FromGrade: New and previous ratings
- Action: Rating action
- priceTargetAction: Price-target action such as Raises, Lowers, or Maintains
- currentPriceTarget and priorPriceTarget: New and previous price targets
Available fields vary by symbol and analyst action.
yfinance_get_ticker_news
Fetch recent news articles and press releases for a specific stock.
| Parameter | Type | Required | Description |