A Model Context Protocol (MCP) server that provides AI assistants with access to Yahoo Finance data via . Query stock information, financial news, sector rankings, and generate professional financial charts — all from your AI chat.
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.
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
symbol
string
Yes
Stock ticker symbol
symbol must be nonempty and contain only ASCII letters, digits, or ., -, ^, =, &, _.
Invalid input returns INVALID_PARAMS without echoing the input or calling Yahoo Finance.
Accepted formats include BRK.B, 2330.TW, ^GSPC, EURUSD=X, ES=F, and BTC-USD.
This format check does not verify that a ticker exists.
Returns: JSON array of news items with title, summary, publication date, provider, URL, and thumbnail.
yfinance_search
Search Yahoo Finance for stocks, ETFs, and news articles.
Parameter
Type
Required
Description
query
string
Yes
Search query — company name, ticker symbol, or keywords
"top_etfs", "top_mutual_funds", "top_companies", "top_growth_companies", or "top_performing_companies"
top_n
number
No
Number of results to return (default: 10, max: 100)
Returns: JSON array of top entities with relevant metrics.
Supported Sectors
Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, Utilities
yfinance_screen
Run Yahoo Finance screeners using either predefined screener keys or custom query trees.
Parameter
Type
Required
Description
query
string/object
Yes
For query_type="predefined": screener key such as "day_gainers". For query_type="equity", "fund", or "etf": custom query tree with {operator, operands} nodes
query_type
string
No
"predefined" (default), "equity", "fund", or "etf"
offset
number
No
Result offset
size
number
No
Rows for custom queries; Yahoo maximum is 250
count
number
No
Rows for predefined queries; Yahoo maximum is 250
sort_field
string
No
Sort field, for example "percentchange"
sort_asc
boolean
No
Sort ascending if true, descending if false
user_id
string
No
Optional Yahoo user identifier
user_id_type
string
No
Optional Yahoo user ID type, commonly "guid"
Returns: JSON screener response from Yahoo Finance, typically including quote rows and metadata.
Returns: JSON object with income statement, balance sheet, and cash flow data for each reporting period.
Income Statement fields: EBIT, Net Income, Tax Provision, Pretax Income, Interest Expense, Total Revenue, Operating Income, EBITDA, Normalized Income
Balance Sheet fields: Stockholders Equity, Total Debt, Cash And Cash Equivalents, Invested Capital, Net Debt, Total Assets, Total Liabilities Net Minority Interest, Net Tangible Assets, Tangible Book Value
Cash Flow fields: Operating Cash Flow, Free Cash Flow, Capital Expenditure, Net Income From Continuing Operations, Depreciation And Amortization, Change In Working Capital, Cash Dividends Paid
yfinance_get_holders
Fetch major holders, institutional holders, mutual fund holders, and insider data.
Parameter
Type
Required
Description
symbol
string
Yes
Stock ticker symbol (e.g. AAPL, MSFT)
max_rows
number
No
Maximum rows returned per holder section. Default: 10. Use 0 to return all rows
Returns: JSON object with:
major_holders — Aggregated breakdown where each row has an index label (e.g. insidersPercentHeld, institutionsPercentHeld, institutionsFloatPercentHeld, institutionsCount) and a Value
institutional_holders — Institutional investors; records typically include fields such as Date Reported, Holder, Shares, Value, pctChange, pctHeld
mutualfund_holders — Mutual fund holders; records typically include fields similar to institutional holders
insider_transactions — Recent insider trades; records typically include fields such as Shares, Value, Insider, Position, Transaction, Start Date, Ownership
insider_purchases — Six-month summary where each row describes a category (Purchases, Sales, Net Shares, etc.); records typically include fields such as Insider Purchases Last 6m, Shares, Trans
insider_roster — Known insiders; records typically include fields such as Name, Position, Shares Owned Directly, Most Recent Transaction, Latest Transaction Date
_metadata — Row limit metadata with max_rows and per-section total_rows, returned_rows, and truncated
Holder sections are limited to 10 rows by default to keep responses concise. Pass max_rows: 0 when you need the complete holder datasets. Field names for holder-related datasets are provided by yfinance and may vary by ticker, data availability, and yfinance version.
yfinance_get_fund_data
Fetch ETF or mutual-fund portfolio composition and operating details.
Parameter
Type
Required
Description
symbol
string
Yes
ETF or mutual-fund ticker symbol (for example SPY, BND, or VFIAX)
sections
array
No
Any of description, fund_overview, fund_operations, asset_classes, top_holdings, equity_holdings, bond_holdings, bond_ratings, or sector_weightings. Omit for all sections
max_rows
number
No
Maximum rows per tabular section. Default: 25. Use 0 for all rows
Returns: Available fund sections plus _metadata with row limits, per-section truncation, unavailable sections, and failed sections. The mix of sections depends on the fund; for example, equity funds and bond funds expose different portfolio breakdowns.
yfinance_get_option_dates
Fetch available option expiration dates for a stock.
Parameter
Type
Required
Description
symbol
string
Yes
Stock ticker symbol (e.g. AAPL, MSFT)
Returns: JSON array of expiration dates in YYYY-MM-DD format.
yfinance_get_option_chain
Fetch option chain data (calls and puts) for a stock with available strike prices.
Parameter
Type
Required
Description
symbol
string
Yes
Stock ticker symbol
expiration_date
string
No
Option expiration date in YYYY-MM-DD format. Omit to fetch all dates.
option_type
string
No
"calls", "puts", or "all" (default: "all")
Returns: JSON object keyed by expiration date, with calls and/or puts data including:
Replace /path/to/yfinance-mcp with the actual path to your cloned repository.
Testing with Codex CLI
This repository includes .codex/config.toml, which registers the local yfmcp MCP server for Codex CLI using uv run yfmcp. After cloning the repository and running uv sync, open Codex CLI from the repository root and try prompts such as:
Show VOO ticker info
Show VOO price history for the last 5 days
Find the ticker symbol for Toyota
Get AAPL option expiration dates
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Sorular
Yfinance nasıl kurulur?
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Yfinance için API anahtarı gerekiyor mu?
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.