# yfinance-ai: Yahoo Finance (pypi · yfinance-ai)

Yahoo Finance in 68 tools: stocks, crypto, forex, commodities, funds, options, analysts, calendars.

- Trust score: 73/100 (medium)
- Change this week: −11
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- pypi · `yfinance-ai`: 73/100 (this document), [markdown](https://verifymcp.io/servers/lkcair-yfinance-ai/yfinance-ai.md), [page](https://verifymcp.io/servers/lkcair-yfinance-ai/yfinance-ai)

## Channel facts

- Registry: `pypi`
- Package: `yfinance-ai`
- Version: `5.0.5`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 50/100
  - Malware scan not yet available for this package.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 1 of 48 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to lkcair/yfinance-ai-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 15 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 73/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 4413 tokens (~64/item across 68 items; 68 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 50/100
  - Stability observed for 15 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 68 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 69 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the yfinance-ai: Yahoo Finance MCP server?

yfinance-ai: Yahoo Finance runs locally as a PyPI package, launched with uvx yfinance-ai. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add lkcair-yfinance-ai -- uvx yfinance-ai
```

### Cursor

```json
{
  "mcpServers": {
    "lkcair-yfinance-ai": {
      "command": "uvx",
      "args": [
        "yfinance-ai"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "lkcair-yfinance-ai": {
      "command": "uvx",
      "args": [
        "yfinance-ai"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add lkcair-yfinance-ai -- uvx yfinance-ai
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "lkcair-yfinance-ai": {
      "type": "local",
      "command": [
        "uvx",
        "yfinance-ai"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add lkcair-yfinance-ai --command uvx --arg yfinance-ai
```

### Hermes

```yaml
mcp_servers:
  lkcair-yfinance-ai:
    command: "uvx"
    args: ["yfinance-ai"]
```

### Netclaw

```json
{
  "McpServers": {
    "lkcair-yfinance-ai": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "yfinance-ai"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add lkcair-yfinance-ai -t stdio -c uvx -a yfinance-ai
```

### Other

```json
{
  "mcpServers": {
    "lkcair-yfinance-ai": {
      "command": "uvx",
      "args": [
        "yfinance-ai"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 73, −14)

- [security regression] Malware scan: pass → unverified

### 2026-11-04 (score 87, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-03 (score 72, −14)

- [security regression] Malware scan: pass → unverified

### 2026-11-01 (score 86, +1)

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-30 (score 85, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-29 (score 84, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-28 (score 69, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-27 (score 68, +2)

- [functional improvement] Stability: unverified → 0.20

## MCP tools (68)

### `compare_stocks` (~64 tokens)

Compare Stocks

Compare key metrics across multiple stocks.

Returns: Comparison table of price, market cap, P/E, dividend yield, and returns

Input parameters:

- `tickers` (string, required): Comma-separated list of ticker symbols (e.g., 'AAPL,MSFT,GOOGL')

Output parameters:

- `result` (string)

### `download_multiple_tickers` (~90 tokens)

Download Multiple Tickers

Download historical data for multiple tickers at once (bulk operation).

Returns: Summary of downloaded data for all tickers

Input parameters:

- `interval` (string): Data interval (default: 1d)
- `period` (string): Time period (default: 1mo)
- `tickers` (string, required): Space or comma-separated ticker symbols (e.g., 'AAPL MSFT GOOGL')

Output parameters:

- `result` (string)

### `get_analyst_estimates` (~41 tokens)

Analyst Estimates

Get analyst estimates for earnings, revenue, and EPS.

Returns: Comprehensive analyst estimates and forecasts

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_analyst_price_targets` (~59 tokens)

Analyst Price Targets

Get detailed analyst price targets for a stock.

Returns: Comprehensive price target data including current, low, mean, median, high targets
    and the number of analysts covering the stock

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_analyst_recommendations` (~49 tokens)

Analyst Recommendations

Get analyst recommendations and ratings.

Returns: Analyst buy/hold/sell recommendations, consensus, and recent upgrades/downgrades

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_api_status` (~25 tokens)

API Status

Get API status and usage information.

Returns: Current API usage statistics and configuration

Output parameters:

- `result` (string)

### `get_balance_sheet` (~50 tokens)

Balance Sheet

Get balance sheet data.

Returns: Balance sheet with assets, liabilities, and equity

Input parameters:

- `period` (string): 'annual' or 'quarterly'
- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_capital_gains` (~47 tokens)

Capital Gains

Get capital gains distributions (primarily for funds/ETFs).

Returns: Capital gains distribution history

Input parameters:

- `ticker` (string, required): Ticker symbol (typically ETF or mutual fund)

Output parameters:

- `result` (string)

### `get_cash_flow` (~53 tokens)

Cash Flow

Get cash flow statement data.

Returns: Cash flow statement with operating, investing, and financing activities

Input parameters:

- `period` (string): 'annual' or 'quarterly'
- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_commodity_price` (~65 tokens)

Commodity Price

Get commodity/futures price data.

Returns: Current price, day change, and key market data

Input parameters:

- `commodity` (string, required): Commodity name or ticker (e.g., 'gold', 'oil', 'crude oil', 'GC=F', 'CL=F')

Output parameters:

- `result` (string)

### `get_company_info` (~44 tokens)

Company Info

Get detailed company information and business description.

Returns: Company overview including sector, industry, employees, website, and business summary

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_company_officers` (~38 tokens)

Company Officers

Get company officers and key management.

Returns: List of company officers with titles and compensation

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_company_overview` (~68 tokens)

Company Overview

Get a beautiful, insightful company overview with context for every metric.
Perfect for quick overviews and basic questions about a company.

Returns: Beautifully formatted company overview with insights and context

Input parameters:

- `ticker` (string, required): Stock ticker symbol (e.g., 'AAPL', 'MSFT')

Output parameters:

- `result` (string)

### `get_complete_analysis` (~121 tokens)

Complete Analysis

Run a complete analysis of a stock by calling ALL available functions.
This is the most comprehensive analysis available - use when user asks
for "everything about" or "complete analysis of" a company.

Returns: Comprehensive analysis with results from all applicable functions

Input parameters:

- `peers` (string): Optional comma-separated peer tickers for comparison (e.g., 'MSFT,GOOGL,META') AI should provide contextually relevant peers based on the conversation.
- `ticker` (string, required): Stock ticker symbol (e.g., 'AAPL', 'MSFT')

Output parameters:

- `result` (string)

### `get_corporate_actions` (~43 tokens)

Corporate Actions

Get all corporate actions (dividends + splits combined).

Returns: Combined history of dividends and stock splits

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_crypto_price` (~64 tokens)

Crypto Price

Get cryptocurrency price and market data.

Returns: Current price, 24h change, market cap, volume, and key metrics

Input parameters:

- `symbol` (string, required): Crypto symbol (e.g., 'BTC', 'ETH', 'bitcoin', 'ethereum', 'BTC-USD')

Output parameters:

- `result` (string)

### `get_dividends` (~62 tokens)

Dividends

Get dividend payment history and current metrics.

Returns: Dividend history and current dividend metrics

Input parameters:

- `period` (string): Time period for dividend history (1y, 5y, 10y, max)
- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_earnings_calendar` (~48 tokens)

Earnings Calendar

Get earnings calendar including next earnings date and dividend dates.

Returns: Upcoming earnings dates, ex-dividend dates, and dividend payment dates

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_earnings_dates` (~43 tokens)

Earnings Dates

Get upcoming and past earnings dates with estimates.

Returns: Earnings calendar with dates, estimates, and actual results

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_earnings_history` (~40 tokens)

Earnings History

Get historical earnings data with annual and quarterly figures.

Returns: Historical earnings by year and quarter

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_economic_calendar` (~72 tokens)

Economic Calendar

Get upcoming economic events (CPI, jobs, GDP, rate decisions) with expected and prior values.

Returns: Table of economic events by region and time

Input parameters:

- `days` (integer): Look-ahead window in days (default 7)
- `limit` (integer): Max events (default 30)

Output parameters:

- `result` (string)

### `get_eps_revisions` (~41 tokens)

EPS Revisions

Get EPS revision data showing analyst estimate changes.

Returns: EPS revisions showing up/down estimate changes by analysts

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_eps_trend` (~49 tokens)

EPS Trend

Get EPS (Earnings Per Share) trend data showing how estimates have changed.

Returns: EPS trend data showing estimate changes over different time periods

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_fast_info` (~47 tokens)

Fast Info

Get fast-access ticker information (lightweight, quick response).

Returns: Quick summary with most recent price, market cap, and basic metrics

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_financial_summary` (~47 tokens)

Financial Summary

Get a comprehensive one-page financial summary of a stock.

Returns: Comprehensive summary including price, valuation, financials, and analyst data

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_forex_rate` (~69 tokens)

Forex Rate

Get foreign exchange (forex) rate for a currency pair.

Returns: Current exchange rate, bid/ask, day range, and recent changes

Input parameters:

- `pair` (string, required): Currency pair (e.g., 'EURUSD', 'EUR/USD', 'eurusd', 'GBPUSD=X')

Output parameters:

- `result` (string)

### `get_fund_holdings` (~74 tokens)

Fund Holdings

Get top holdings for an ETF or mutual fund.

Returns: List of top holdings with weights and values

Input parameters:

- `limit` (integer): Maximum number of holdings to return (default 25)
- `ticker` (string, required): Fund ticker symbol (e.g., 'VOO', 'SPY', 'QQQ')

Output parameters:

- `result` (string)

### `get_fund_overview` (~68 tokens)

Fund Overview

Get overview data for an ETF or mutual fund.

Returns: Fund category, family, total assets, expense ratio, and other key metrics

Input parameters:

- `ticker` (string, required): Fund ticker symbol (e.g., 'VOO', 'SPY', 'QQQ', 'ARKK')

Output parameters:

- `result` (string)

### `get_fund_sector_weights` (~57 tokens)

Fund Sector Weights

Get sector allocation/weights for an ETF or mutual fund.

Returns: Sector allocation percentages for the fund

Input parameters:

- `ticker` (string, required): Fund ticker symbol (e.g., 'VOO', 'SPY', 'QQQ')

Output parameters:

- `result` (string)

### `get_growth_estimates` (~34 tokens)

Growth Estimates

Get analyst growth estimates.

Returns: Growth rate estimates for various periods

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_historical_comparison` (~76 tokens)

Historical Comparison

Compare historical price performance of multiple stocks.

Returns: Performance comparison showing % returns for each ticker

Input parameters:

- `period` (string): Time period for comparison (default: 1y)
- `tickers` (string, required): Comma or space-separated ticker symbols (e.g., 'AAPL,MSFT,GOOGL')

Output parameters:

- `result` (string)

### `get_historical_data` (~156 tokens)

Historical Data

Get historical price data for a stock.

Returns: Historical price data summary with statistics and returns

Input parameters:

- `interval` (string): Data interval - valid values: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo
- `period` (string): Time period - valid values: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_historical_price_on_date` (~66 tokens)

Historical Price on Date

Get historical price for a specific date.

Returns: Price on that date (or closest trading day)

Input parameters:

- `date` (string, required): Date in YYYY-MM-DD format (e.g., "2024-01-15")
- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_income_statement` (~61 tokens)

Income Statement

Get income statement data.

Returns: Income statement with revenue, expenses, and net income

Input parameters:

- `period` (string): 'annual', 'quarterly', or 'ttm' (trailing twelve months)
- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_industry_overview` (~82 tokens)

Industry Overview

Get an industry overview: largest, best-performing and fastest-growing companies.

Returns: Industry summary with top companies by size, YTD performance and growth

Input parameters:

- `industry` (string): Industry key, e.g. semiconductors, software-infrastructure, biotechnology, banks-regional, oil-gas-integrated (see get_sector_overview for all keys)

Output parameters:

- `result` (string)

### `get_insider_purchases` (~37 tokens)

Insider Purchases

Get insider purchases only (filtered for buys).

Returns: Recent insider purchase transactions

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_insider_roster_holders` (~42 tokens)

Insider Roster Holders

Get insider roster (list of company insiders).

Returns: List of company insiders and their positions

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_insider_transactions` (~35 tokens)

Insider Transactions

Get recent insider trading activity.

Returns: Recent insider buy/sell transactions

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_institutional_holders` (~43 tokens)

Institutional Holders

Get major institutional holders and their ownership.

Returns: List of institutional holders with shares owned and percentage ownership

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_ipo_calendar` (~64 tokens)

IPO Calendar

Get upcoming IPOs (exchange, expected date, price range, shares).

Returns: Table of upcoming IPOs

Input parameters:

- `days` (integer): Look-ahead window in days (default 14)
- `limit` (integer): Max IPOs (default 25)

Output parameters:

- `result` (string)

### `get_isin` (~42 tokens)

ISIN

Get International Securities Identification Number (ISIN) for a ticker.

Returns: ISIN code and related identification information

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_key_ratios` (~51 tokens)

Key Ratios

Get key financial ratios and valuation metrics.

Returns: Comprehensive ratios including P/E, P/B, ROE, ROA, profit margins, debt ratios

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_major_holders` (~43 tokens)

Major Holders

Get major holders summary (institutions, insiders, public float).

Returns: Summary of insider vs institutional ownership percentages

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_market_indices` (~39 tokens)

Market Indices

Get current prices for major market indices.

Returns: Current values and changes for S&P 500, Nasdaq, Dow Jones, and other major indices

Output parameters:

- `result` (string)

### `get_market_movers` (~132 tokens)

Market Movers

Get today's market movers from Yahoo Finance screeners.

Returns: Table of tickers with price, change %, volume and market cap

Input parameters:

- `category` (string): day_gainers, day_losers, most_actives, most_shorted_stocks, small_cap_gainers, undervalued_large_caps, undervalued_growth_stocks, growth_technology_stocks, aggressive_small_caps, top_etfs_us, top_per…
- `count` (integer): Number of results (1-50, default 10)

Output parameters:

- `result` (string)

### `get_market_status` (~34 tokens)

Market Status

Check if US stock markets are currently open.

Returns: Market status (open/closed), current time, and market hours

Output parameters:

- `result` (string)

### `get_market_summary` (~80 tokens)

Market Summary

Get a market overview for a region: open/closed status plus main indices, futures, bonds and FX.

Returns: Market status and a table of the region's headline instruments

Input parameters:

- `region` (string): US, GB, DE, FR, JP, HK, IN, CA, AU, BR, EUROPE, ASIA (default US)

Output parameters:

- `result` (string)

### `get_mutualfund_holders` (~37 tokens)

Mutual Fund Holders

Get mutual fund holders.

Returns: List of mutual funds holding the stock

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_options_chain` (~59 tokens)

Options Chain

Get options chain data (calls and puts).

Returns: Options chain with top calls and puts by volume

Input parameters:

- `expiration` (string): Specific expiration date (YYYY-MM-DD) or empty for nearest
- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_options_expirations` (~38 tokens)

Options Expirations

Get all available options expiration dates.

Returns: List of all available options expiration dates

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_peer_comparison` (~62 tokens)

Peer Comparison

Compare a stock with its peers on key metrics.

Returns: Comparison table of key metrics across stocks

Input parameters:

- `peers` (string): Optional comma-separated peer tickers (if not provided, uses sector peers)
- `ticker` (string, required): Primary stock ticker symbol

Output parameters:

- `result` (string)

### `get_sec_filings` (~48 tokens)

SEC Filings

Get recent SEC filings (10-K, 10-Q, 8-K, etc.).

Returns: Recent SEC filings with types and dates

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_sector_overview` (~78 tokens)

Sector Overview

Get a sector overview: size, weight, largest companies, industries and sector ETFs.

Returns: Sector summary with top companies and its industries

Input parameters:

- `sector` (string): basic-materials, communication-services, consumer-cyclical, consumer-defensive, energy, financial-services, healthcare, industrials, real-estate, technology, utilities

Output parameters:

- `result` (string)

### `get_sector_performance` (~29 tokens)

Sector Performance

Get performance of major market sectors.

Returns: Performance data for major S&P 500 sectors

Output parameters:

- `result` (string)

### `get_shares_history` (~60 tokens)

Shares History

Get shares outstanding over time (dilution or buybacks).

Returns: Shares outstanding at several points and the total change

Input parameters:

- `ticker` (string, required): Stock ticker symbol
- `years` (integer): How many years back (default 3)

Output parameters:

- `result` (string)

### `get_splits_calendar` (~54 tokens)

Splits Calendar

Get upcoming stock splits.

Returns: Table of upcoming splits with ratios

Input parameters:

- `days` (integer): Look-ahead window in days (default 14)
- `limit` (integer): Max splits (default 25)

Output parameters:

- `result` (string)

### `get_stock_news` (~56 tokens)

Stock News

Get recent news articles about a stock.

Returns: Recent news headlines, sources, and links

Input parameters:

- `limit` (integer): Maximum number of news articles to return (default 10)
- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_stock_price` (~67 tokens)

Stock Price

Get current stock price and key metrics for a ticker symbol.

Returns: Formatted string with current price, market cap, P/E ratio, and other key metrics

Input parameters:

- `ticker` (string, required): Stock ticker symbol (e.g., 'AAPL', 'TSLA', 'SPY')

Output parameters:

- `result` (string)

### `get_stock_quote` (~50 tokens)

Stock Quote

Get detailed quote with bid/ask, day range, and trading info.

Returns: Detailed quote information including bid/ask spreads and intraday trading data

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_stock_splits` (~36 tokens)

Stock Splits

Get stock split history.

Returns: Complete stock split history with dates and ratios

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_trending_tickers` (~48 tokens)

Trending Tickers

Get today's most active (trending) US tickers.

Returns: List of trending tickers with basic info

Input parameters:

- `count` (integer): Number of trending tickers to return

Output parameters:

- `result` (string)

### `get_ttm_financials` (~62 tokens)

TTM Financials

Get trailing-twelve-month (TTM) income statement and cash flow.

Returns: Key TTM lines: revenue, gross profit, operating income, net income, EBITDA, EPS, cash flows

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_upcoming_earnings` (~70 tokens)

Upcoming Earnings

Get the market-wide earnings calendar (which companies report in the next N days).

Returns: Companies with report date, timing and EPS estimate

Input parameters:

- `days` (integer): Look-ahead window in days (default 7)
- `limit` (integer): Max companies (default 25)

Output parameters:

- `result` (string)

### `get_upgrades_downgrades` (~66 tokens)

Upgrades and Downgrades

Get detailed analyst upgrades and downgrades history.

Returns: Recent analyst rating changes including firm, action, and grade changes

Input parameters:

- `limit` (integer): Maximum number of rating changes to return (default 20)
- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `get_valuation_history` (~61 tokens)

Valuation History

Get valuation measures now and for the last quarters (market cap, EV, P/E, PEG, P/S, P/B, EV/EBITDA).

Returns: Table of valuation measures by quarter

Input parameters:

- `ticker` (string, required): Stock ticker symbol

Output parameters:

- `result` (string)

### `run_self_test` (~105 tokens)

Self-Test

Run comprehensive self-test of the yfinance-ai tools (64 checks).

This function is designed to be called by AI assistants to verify
that all tools are working correctly. It tests each tool category,
reports success/failure status, and shows sample data from each test.

Returns: Comprehensive test report with pass/fail status and sample data for all tools

Input parameters:

- `ticker` (string): Ticker symbol to use for testing (default: SPY - reliable ETF with full data)

Output parameters:

- `result` (string)

### `search_ticker` (~40 tokens)

Search Ticker

Search for ticker symbols by company name or keyword.

Returns: List of matching tickers

Input parameters:

- `query` (string, required): Company name or keyword to search

Output parameters:

- `result` (string)

### `validate_ticker` (~42 tokens)

Validate Ticker

Validate if a ticker symbol exists and is tradeable.

Returns: Validation result with ticker details if valid

Input parameters:

- `ticker` (string, required): Ticker symbol to validate

Output parameters:

- `result` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/lkcair-yfinance-ai/yfinance-ai#diagnostics

## Score history

- 2026-11-05: 73
- 2026-11-04: 87
- 2026-11-03: 72
- 2026-11-02: 86
- 2026-11-01: 86
- 2026-10-31: 85
- 2026-10-30: 85
- 2026-10-29: 84
- 2026-10-28: 69
- 2026-10-27: 68
- 2026-10-26: 66
- 2026-10-25: 66
- 2026-10-24: 66
- 2026-10-23: 66
- 2026-10-22: 66
- 2026-10-21: 66

## Common questions

### What is the yfinance-ai: Yahoo Finance MCP server?

yfinance-ai: Yahoo Finance is an MCP server listed in the public MCP registry as io.github.lkcair/yfinance-ai. Yahoo Finance in 68 tools: stocks, crypto, forex, commodities, funds, options, analysts, calendars. This page covers its PyPI package (yfinance-ai).

### Is the yfinance-ai: Yahoo Finance MCP server safe to use?

yfinance-ai: Yahoo Finance scores 73 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the yfinance-ai: Yahoo Finance MCP server expose?

yfinance-ai: Yahoo Finance exposes 68 tools: compare_stocks, download_multiple_tickers, get_analyst_estimates, get_analyst_price_targets, get_analyst_recommendations, and 63 more. Their descriptions and schemas cost roughly 3,923 tokens of context every time the server is loaded.

### Is the yfinance-ai: Yahoo Finance MCP server still maintained?

yfinance-ai: Yahoo Finance is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the yfinance-ai: Yahoo Finance MCP server under?

yfinance-ai: Yahoo Finance declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/yfinance-ai/
- Socket report: https://socket.dev/pypi/package/yfinance-ai
- Repository: https://github.com/lkcair/yfinance-ai-mcp
- Website: https://github.com/lkcair/yfinance-ai
- Changelog RSS feed: https://verifymcp.io/servers/lkcair-yfinance-ai/yfinance-ai.xml
- Changelog JSON feed: https://verifymcp.io/servers/lkcair-yfinance-ai/yfinance-ai.json
- HTML version of this page: https://verifymcp.io/servers/lkcair-yfinance-ai/yfinance-ai