Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

yfinance-ai: Yahoo Finance

PYPI · YFINANCE-AI

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

Available components

−11 this week 73 Trust /100

Last scanned (6 hours ago)

Scores higher than 69% of PyPI servers

Category Finance and Payments

Trust breakdown (7 categories)

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. How we score → Why this is hard to score →

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

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 5 Nov 26 −14
    • Malware scan: pass → unverified ▼ security
  • 4 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 3 Nov 26 −14
    • Malware scan: pass → unverified ▼ security
  • 1 Nov 26 +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.

  • 30 Oct 26 +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.

  • 29 Oct 26 +15
    • Malware scan: unverified → pass ▲ security
  • 28 Oct 26 +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.

  • 27 Oct 26 +2
    • Stability: unverified → 0.20 ▲ functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 5 Nov 2026 · Analysed pypi/yfinance-ai@5.0.5

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem pypi
Reason Verified
Discovered via Registry attestation endpoint
Source repo lkcair/yfinance-ai-mcp
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/lkcair/yfinance-ai-mcp/.github/workflows/publish.yml@refs/tags/v5.0.5
Rekor log index 3349962077
Predicate type PyPI publish attestation https://docs.pypi.org/attestations/publish/v1
Subject digest sha256:6e19f5a5398de8c08ff8c5de7f571dcf901b9795920dbe5bd9ee42626b982793

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend allowlisted hatchling.build

Background: Why install scripts are a supply-chain risk →

Dependencies 48 packages
Packages resolved 48
No linked repository 1
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 68 exposed · ~3,923 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
compare_stocks ~64

Compare key metrics across multiple stocks. Returns: Comparison table of price, market cap, P/E, dividend yield, and returns

NameTypeReqDescription
tickersstringyesComma-separated list of ticker symbols (e.g., 'AAPL,MSFT,GOOGL')
NameTypeReqDescription
resultstringyes–

No examples provided.

download_multiple_tickers ~90

Download historical data for multiple tickers at once (bulk operation). Returns: Summary of downloaded data for all tickers

NameTypeReqDescription
intervalstring–Data interval (default: 1d)
periodstring–Time period (default: 1mo)
tickersstringyesSpace or comma-separated ticker symbols (e.g., 'AAPL MSFT GOOGL')
NameTypeReqDescription
resultstringyes–

No examples provided.

get_analyst_estimates ~41

Get analyst estimates for earnings, revenue, and EPS. Returns: Comprehensive analyst estimates and forecasts

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_analyst_price_targets ~59

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

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_analyst_recommendations ~49

Get analyst recommendations and ratings. Returns: Analyst buy/hold/sell recommendations, consensus, and recent upgrades/downgrades

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_api_status ~25

Get API status and usage information. Returns: Current API usage statistics and configuration

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultstringyes–

No examples provided.

get_balance_sheet ~50

Get balance sheet data. Returns: Balance sheet with assets, liabilities, and equity

NameTypeReqDescription
periodstring–'annual' or 'quarterly'
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_capital_gains ~47

Get capital gains distributions (primarily for funds/ETFs). Returns: Capital gains distribution history

NameTypeReqDescription
tickerstringyesTicker symbol (typically ETF or mutual fund)
NameTypeReqDescription
resultstringyes–

No examples provided.

get_cash_flow ~53

Get cash flow statement data. Returns: Cash flow statement with operating, investing, and financing activities

NameTypeReqDescription
periodstring–'annual' or 'quarterly'
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_commodity_price ~65

Get commodity/futures price data. Returns: Current price, day change, and key market data

NameTypeReqDescription
commoditystringyesCommodity name or ticker (e.g., 'gold', 'oil', 'crude oil', 'GC=F', 'CL=F')
NameTypeReqDescription
resultstringyes–

No examples provided.

get_company_info ~44

Get detailed company information and business description. Returns: Company overview including sector, industry, employees, website, and business summary

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_company_officers ~38

Get company officers and key management. Returns: List of company officers with titles and compensation

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_company_overview ~68

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

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., 'AAPL', 'MSFT')
NameTypeReqDescription
resultstringyes–

No examples provided.

get_complete_analysis ~121

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

NameTypeReqDescription
peersstring–Optional comma-separated peer tickers for comparison (e.g., 'MSFT,GOOGL,META') AI should provide contextually relevant peers based on the conversation.
tickerstringyesStock ticker symbol (e.g., 'AAPL', 'MSFT')
NameTypeReqDescription
resultstringyes–

No examples provided.

get_corporate_actions ~43

Get all corporate actions (dividends + splits combined). Returns: Combined history of dividends and stock splits

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_crypto_price ~64

Get cryptocurrency price and market data. Returns: Current price, 24h change, market cap, volume, and key metrics

NameTypeReqDescription
symbolstringyesCrypto symbol (e.g., 'BTC', 'ETH', 'bitcoin', 'ethereum', 'BTC-USD')
NameTypeReqDescription
resultstringyes–

No examples provided.

get_dividends ~62

Get dividend payment history and current metrics. Returns: Dividend history and current dividend metrics

NameTypeReqDescription
periodstring–Time period for dividend history (1y, 5y, 10y, max)
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_earnings_calendar ~48

Get earnings calendar including next earnings date and dividend dates. Returns: Upcoming earnings dates, ex-dividend dates, and dividend payment dates

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_earnings_dates ~43

Get upcoming and past earnings dates with estimates. Returns: Earnings calendar with dates, estimates, and actual results

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_earnings_history ~40

Get historical earnings data with annual and quarterly figures. Returns: Historical earnings by year and quarter

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_economic_calendar ~72

Get upcoming economic events (CPI, jobs, GDP, rate decisions) with expected and prior values. Returns: Table of economic events by region and time

NameTypeReqDescription
daysinteger–Look-ahead window in days (default 7)
limitinteger–Max events (default 30)
NameTypeReqDescription
resultstringyes–

No examples provided.

get_eps_revisions ~41

Get EPS revision data showing analyst estimate changes. Returns: EPS revisions showing up/down estimate changes by analysts

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_eps_trend ~49

Get EPS (Earnings Per Share) trend data showing how estimates have changed. Returns: EPS trend data showing estimate changes over different time periods

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_fast_info ~47

Get fast-access ticker information (lightweight, quick response). Returns: Quick summary with most recent price, market cap, and basic metrics

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_financial_summary ~47

Get a comprehensive one-page financial summary of a stock. Returns: Comprehensive summary including price, valuation, financials, and analyst data

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_forex_rate ~69

Get foreign exchange (forex) rate for a currency pair. Returns: Current exchange rate, bid/ask, day range, and recent changes

NameTypeReqDescription
pairstringyesCurrency pair (e.g., 'EURUSD', 'EUR/USD', 'eurusd', 'GBPUSD=X')
NameTypeReqDescription
resultstringyes–

No examples provided.

get_fund_holdings ~74

Get top holdings for an ETF or mutual fund. Returns: List of top holdings with weights and values

NameTypeReqDescription
limitinteger–Maximum number of holdings to return (default 25)
tickerstringyesFund ticker symbol (e.g., 'VOO', 'SPY', 'QQQ')
NameTypeReqDescription
resultstringyes–

No examples provided.

get_fund_overview ~68

Get overview data for an ETF or mutual fund. Returns: Fund category, family, total assets, expense ratio, and other key metrics

NameTypeReqDescription
tickerstringyesFund ticker symbol (e.g., 'VOO', 'SPY', 'QQQ', 'ARKK')
NameTypeReqDescription
resultstringyes–

No examples provided.

get_fund_sector_weights ~57

Get sector allocation/weights for an ETF or mutual fund. Returns: Sector allocation percentages for the fund

NameTypeReqDescription
tickerstringyesFund ticker symbol (e.g., 'VOO', 'SPY', 'QQQ')
NameTypeReqDescription
resultstringyes–

No examples provided.

get_growth_estimates ~34

Get analyst growth estimates. Returns: Growth rate estimates for various periods

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_historical_comparison ~76

Compare historical price performance of multiple stocks. Returns: Performance comparison showing % returns for each ticker

NameTypeReqDescription
periodstring–Time period for comparison (default: 1y)
tickersstringyesComma or space-separated ticker symbols (e.g., 'AAPL,MSFT,GOOGL')
NameTypeReqDescription
resultstringyes–

No examples provided.

get_historical_data ~156

Get historical price data for a stock. Returns: Historical price data summary with statistics and returns

NameTypeReqDescription
intervalstring–Data interval - valid values: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo
periodstring–Time period - valid values: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_historical_price_on_date ~66

Get historical price for a specific date. Returns: Price on that date (or closest trading day)

NameTypeReqDescription
datestringyesDate in YYYY-MM-DD format (e.g., "2024-01-15")
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_income_statement ~61

Get income statement data. Returns: Income statement with revenue, expenses, and net income

NameTypeReqDescription
periodstring–'annual', 'quarterly', or 'ttm' (trailing twelve months)
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_industry_overview ~82

Get an industry overview: largest, best-performing and fastest-growing companies. Returns: Industry summary with top companies by size, YTD performance and growth

NameTypeReqDescription
industrystring–Industry key, e.g. semiconductors, software-infrastructure, biotechnology, banks-regional, oil-gas-integrated (see get_sector_overview for all keys)
NameTypeReqDescription
resultstringyes–

No examples provided.

get_insider_purchases ~37

Get insider purchases only (filtered for buys). Returns: Recent insider purchase transactions

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_insider_roster_holders ~42

Get insider roster (list of company insiders). Returns: List of company insiders and their positions

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_insider_transactions ~35

Get recent insider trading activity. Returns: Recent insider buy/sell transactions

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_institutional_holders ~43

Get major institutional holders and their ownership. Returns: List of institutional holders with shares owned and percentage ownership

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_ipo_calendar ~64

Get upcoming IPOs (exchange, expected date, price range, shares). Returns: Table of upcoming IPOs

NameTypeReqDescription
daysinteger–Look-ahead window in days (default 14)
limitinteger–Max IPOs (default 25)
NameTypeReqDescription
resultstringyes–

No examples provided.

get_isin ~42

Get International Securities Identification Number (ISIN) for a ticker. Returns: ISIN code and related identification information

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_key_ratios ~51

Get key financial ratios and valuation metrics. Returns: Comprehensive ratios including P/E, P/B, ROE, ROA, profit margins, debt ratios

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_major_holders ~43

Get major holders summary (institutions, insiders, public float). Returns: Summary of insider vs institutional ownership percentages

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_market_indices ~39

Get current prices for major market indices. Returns: Current values and changes for S&P 500, Nasdaq, Dow Jones, and other major indices

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultstringyes–

No examples provided.

get_market_movers ~132

Get today's market movers from Yahoo Finance screeners. Returns: Table of tickers with price, change %, volume and market cap

NameTypeReqDescription
categorystring–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…
countinteger–Number of results (1-50, default 10)
NameTypeReqDescription
resultstringyes–

No examples provided.

get_market_status ~34

Check if US stock markets are currently open. Returns: Market status (open/closed), current time, and market hours

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultstringyes–

No examples provided.

get_market_summary ~80

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

NameTypeReqDescription
regionstring–US, GB, DE, FR, JP, HK, IN, CA, AU, BR, EUROPE, ASIA (default US)
NameTypeReqDescription
resultstringyes–

No examples provided.

get_mutualfund_holders ~37

Get mutual fund holders. Returns: List of mutual funds holding the stock

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_options_chain ~59

Get options chain data (calls and puts). Returns: Options chain with top calls and puts by volume

NameTypeReqDescription
expirationstring–Specific expiration date (YYYY-MM-DD) or empty for nearest
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

get_options_expirations ~38

Get all available options expiration dates. Returns: List of all available options expiration dates

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
resultstringyes–

No examples provided.

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.

pypi · yfinance-ai

# add to Claude Code
claude mcp add lkcair-yfinance-ai -- uvx yfinance-ai
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.