benethos-yahoo-finance-mcp

Get upcoming corporate-calendar events for a Yahoo symbol. Returns the next earnings date(s) with analyst estimate ranges and the next dividend / ex-dividend dates. Equity-only: an ETF, fund or crypto symbol answers with an error that says so.

Get a company profile and key statistics for a Yahoo symbol. Returns name, sector/industry, location, employee count, and valuation metrics (market cap, trailing and forward P/E, P/B, beta, 52-week range, dividend yield) plus a business summary. For an ISIN, `resolved_symbol` names the ticker it stands for.

Get the dividend and stock-split history for a Yahoo symbol.

Get upcoming and historical earnings for a Yahoo symbol. Returns the earnings calendar (upcoming and past dates with EPS estimate, reported EPS, and surprise %) plus the recent earnings history. Equity-only: an ETF, fund or crypto symbol answers with an error that says so.

Get forward analyst estimates for a Yahoo symbol. Returns earnings and revenue estimates, EPS trend and revisions, and growth estimates (small tables keyed by period). Equity-only: an ETF, fund or crypto symbol answers with an error that says so.

Get a financial statement for a Yahoo symbol. Each row is a line item and each column a reporting period, most recent first.

Get fund/ETF profile data for a Yahoo symbol. Returns the fund overview, asset-class and sector weightings, and the top holdings. Fund/ETF-only, raises for stocks and crypto, which have no fund data.

Get historical OHLCV (open/high/low/close/volume) data for a symbol. Query a look-back `period` or an explicit `start`/`end` range. Results are capped at the most recent 250 rows, with `truncated` set when cut.

Get the ownership breakdown for a Yahoo symbol. Returns the high-level holder summary (insider/institutional percentages) plus the top institutional and mutual-fund holders. Equity-only: an ETF, fund or crypto symbol answers with an error that says so.

Browse an industry by its Yahoo key (not a ticker symbol). Returns the industry overview, its parent sector, top companies, and the top-performing and top-growth companies. Discover valid industry keys from the `industries` list returned by `get_sector`. This takes an industry key like `semiconductors` — not a ticker symbol.

Get insider trading activity for a Yahoo symbol. Returns individual insider transactions, a 6-month purchases/sales summary, and the current insider roster. Equity-only: an ETF, fund or crypto symbol answers with an error that says so.

Get the trading status and headline index summary for a market. Answers questions like whether the market is open, when it opens or closes next, and how the major indices are doing. Takes a market key such as `US` or `EUROPE` — not a ticker symbol. `status` (open/closed plus the next open and close times) is only available for `US` and is `null` for every other key, which is an upstream limitation rather than an error. The index summary, with price, previous close and change, works for all keys.

Get recent news headlines for a Yahoo symbol (up to `limit`, 1-10). Each article includes title, summary, publisher, publish time, and URL.

Get the option chain for a Yahoo symbol. Call without `expiration` to list available expiration dates. Call with an `expiration` (`YYYY-MM-DD` from that list) to get the calls and puts for that date, up to 60 strikes each centred on the current price, with `truncated` set when a wider chain was cut. Yahoo carries chains for US-listed instruments only, so a non-US symbol has none and that says nothing about the symbol.

Get the current price and key intraday figures for a Yahoo symbol.

Get compact current quotes for several Yahoo symbols in one call. Use this to compare or fetch prices for multiple tickers at once. Each symbol is looked up individually and returns currency, last price, previous close, open, day high/low, and market cap. Symbols that return no data are listed under `not_found` rather than failing the whole call, and `truncated` is set when more than 50 were passed.

Get analyst recommendation trends and price targets for a Yahoo symbol. Returns the buy/hold/sell trend over recent months plus current/high/low/ mean/median analyst price targets when available.

Get recent SEC filings for a Yahoo symbol. Each entry has the filing date, type (e.g. `10-K`, `10-Q`, `8-K`), title, the Yahoo EDGAR URL, and exhibit links. Only issuers registered with the U.S. SEC file there, so a non-US symbol has none, and neither do ETFs, funds or crypto. An empty result says nothing about the symbol.

Browse a market sector by its Yahoo key (not a ticker symbol). Returns the sector overview (company count, market cap/weight, description), its top companies, ETFs, and mutual funds, and the constituent industries. Each industry's `key` can be passed to `get_industry` to drill down, or to `screen` as its `industry` filter. This takes a sector key like `technology` or `healthcare` — not a ticker.

Get the shares-outstanding history for a Yahoo symbol. Each point is a date and the reported shares outstanding. Only the most recent `limit` points are returned. Without `start` the series covers the last 18 months, so pass one for anything older.

Get recent analyst rating changes (upgrades/downgrades) for a Yahoo symbol. Each entry is a firm's rating change with the from/to grade and action, most recent first. Equity-only: an ETF, fund or crypto symbol answers with an error that says so.

Find stocks by criteria, e.g. dividend payers in a region or cheap large caps. Fields are these aliases, or a raw Yahoo screener field name: - market: market_cap, price, change_percent, change_52w_percent, volume, avg_volume_3m, beta - valuation: pe_ratio, peg_ratio, price_to_book, price_to_sales, ev_to_ebitda - dividend: dividend_yield, forward_dividend_yield, dividend_growth_years - profitability and growth: return_on_equity, return_on_assets, net_margin, revenue, revenue_growth, eps_growth - balance sheet: debt_to_equity, current_ratio - ownership: insider_percent, institutional_percent, short_percent_of_float - esg_score - categories, eq or is-in only: region (country code, 'us', 'de'), exchange (Yahoo code, 'NMS', 'GER'), sector ('Technology'), industry (a key or name from get_sector) Percentages are in percent, 3 means 3 %. A loss makes pe_ratio negative, so pair lt with gt 0. region is where a stock is listed, not where the company sits, so 'de' includes foreign companies traded in Germany, and a company appears once per listing. Preferred shares are listings too (on US exchanges symbols like JPM-PD), carrying the common stock's eps and market cap, so their pe_ratio means nothing. Returns total (all matches) and one row per match with price, valuation and dividend figures. A row's dividend_yield can be missing or differ markedly from the filter, which holds for Yahoo's screener data, not for that column. The other filters' figures are not in the rows: get_company_info adds beta and forward P/E, get_holders the ownership shares, get_financials the statements behind margins, growth and debt.

Search Yahoo Finance by company name, ticker symbol, or ISIN. Use this to turn a company name into a Yahoo `symbol` that the other tools accept. They take an ISIN directly. Returns up to `limit` matches (1-25), each with its symbol, name, exchange, instrument type, sector and industry.