Skip to main content
Glama
Unofficial Yahoo Finance MCP Server

Unofficial Yahoo Finance MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
YF_MCP_HOSTNoBind host for HTTP transports (e.g., 0.0.0.0 for remote).127.0.0.1
YF_MCP_PATHNoURL path for HTTP transports (for sse, default is /sse)./mcp
YF_MCP_PORTNoPort for HTTP transports.8000
YF_MCP_CACHENoSet to '1' to enable persistent result cache (off by default).
YF_MCP_CACHE_DIRNoDirectory for the cache file (default is OS cache directory).
YF_MCP_LOG_LEVELNoLog level: DEBUG, INFO, WARNING, ERROR, or CRITICAL.INFO
YF_MCP_TRANSPORTNoTransport type: stdio, streamable-http, or sse.stdio

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Read-only access to Yahoo Finance market data. Three things decide whether a call succeeds, and two more decide whether its answer is read correctly.

Symbols. Every tool taking a symbol accepts a Yahoo ticker such as AAPL, SAP.DE or BTC-USD, or a plain ISIN such as US0378331005, which is looked up through Yahoo's search and replaced by its ticker before the call. Pass either through unchanged — a symbol should never be assembled or transformed. A company name is not a symbol: resolve it with search and pass back what that returns. German WKNs resolve nowhere, not even through search, so ask for a ticker, an ISIN or the company name instead. Four tools are the exceptions: get_sector, get_industry and get_market take a key, not a ticker, and screen takes filters and finds the symbols itself.

Missing data is normal. Analyst, holder, earnings, insider, filing and calendar data exist for equities only, and for an ETF, fund or crypto those tools answer with an error that says so, which does not mean the symbol is wrong. get_fund_data is the reverse and fails for anything that is not a fund. An empty field usually means the instrument has no such data, not that the call went wrong.

Rate limits. Yahoo throttles aggressively and unpredictably. A rate-limit error is temporary and says nothing about the arguments — wait and retry rather than changing the call.

Currencies are never converted. Every price, market cap and statement figure is in the instrument's own currency, reported as currency where the tool has it. Comparing AAPL with SAP.DE, or summing them, means mixing USD and EUR, and nothing in the data will flag that.

Results are capped, mostly in silence. Only get_history, get_quotes and get_options report a truncated flag, and screen reports the total number of matches. Every other tool quietly returns at most its top or most recent rows, so a short list is not evidence that the list is short. Where a tool takes a limit, raise it rather than concluding there is no more.

Data is delayed and may be incomplete. This is not investment advice.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
searchA

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.

get_quoteA

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

One symbol: currency, exchange, last price, previous close, open, day high/low, volume, market cap, 50- and 200-day averages and the 52-week range and change. To compare several symbols use get_quotes, for past prices get_history, for valuation and the business profile get_company_info. No timestamp comes with the price, and Yahoo may show it with the exchange's delay. A cryptocurrency's market cap is null here, get_company_info has it.

get_quotesA

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. A cryptocurrency's market cap is null here, get_company_info has it.

get_historyA

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_company_infoA

Get a company profile and key statistics for a Yahoo symbol.

Use it for what a company is and how it is valued. For the price right now use get_quote, for reported figures get_financials, for an ETF's or fund's holdings get_fund_data. 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_financialsA

Get a financial statement for a Yahoo symbol.

Use it for reported line items such as revenue, net income, debt or free cash flow. For reported EPS against the estimate use get_earnings, for forecasts get_estimates, for ratios such as P/E get_company_info. ETFs and funds have no statements, get_fund_data covers them. Each row is a line item and each column a reporting period, most recent first.

get_dividendsA

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

get_newsA

Get recent news headlines for a Yahoo symbol (up to limit, 1-50).

Each article includes title, summary, publisher, publish time, and URL. source is ticker for Yahoo's news on the symbol. When that has none, source is search for the articles Yahoo's search tags with it, which have no summary and are rarely found for symbols outside the US.

get_calendarA

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_sharesA

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_recommendationsA

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_earningsA

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. methodology applies to the history, the calendar has one basis only.

get_estimatesA

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. methodology applies to the three EPS tables, revenue and growth have one basis only.

get_upgrades_downgradesA

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.

get_holdersA

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.

get_insider_activityA

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_sec_filingsA

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.

get_optionsA

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_fund_dataA

Get fund/ETF profile data for a Yahoo symbol.

Returns the fund overview, key figures, asset-class and sector weightings, and the top holdings. The key figures are the expense ratio (with the category average), holdings turnover, total assets, and the returns year to date and averaged over three and five years. Ratios and returns are fractions, 0.0007 for 0.07%, and a figure Yahoo lacks is left out, which for European ETFs is often the returns and the size. Fund/ETF-only, raises for stocks and crypto, which have no fund data.

get_sectorA

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_industryA

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_marketA

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.

screenA

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.

server_statusA

Report this server's version, transport and uptime.

With details, also the yfinance version in use, and whether its last request reached Yahoo and how long ago, without asking Yahoo again. An answer holds for the moment it was given: after a restart or an update, call it again rather than rely on an earlier one.

Prompts

Interactive templates invoked by user choice

NameDescription
asset_analysisOne instrument in facts and own calculations: price, valuation, analysts.
compareSeveral instruments side by side over one period, on one basis.
earnings_previewWhat to expect from the next report of a company, and its record so far.
etf_profileWhat a fund or ETF holds, what it costs and how it did.
dividend_calendarDividends per position and month for a year, paid and forecast, by rules.
find_symbolThe Yahoo symbol for a company name or an ISIN, on the right exchange.

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.1/5.0

Scored across 24 tools

Disambiguation4/5

Nearly every tool targets a distinct resource: single quote vs. batch quotes, company profile vs. financial statements vs. analyst estimates are all explicitly separated, and descriptions cross-reference each other to steer selection. The only real overlap is around corporate events — get_calendar (next earnings/dividend dates), get_earnings (earnings calendar + history), and get_dividends (dividend history) partially cover the same ground, though the descriptions make the boundary workable.

Naming Consistency4/5

The dominant pattern is a clean `get_<noun>` convention (get_quote, get_history, get_financials, get_fund_data, get_sec_filings), which behaves predictably. The deviations — `search`, `screen`, and `server_status` — are bare verbs/status names rather than verb_noun, but they are few and still readable.

Tool Count4/5

24 tools is on the heavy side and sits at the upper edge of the comfortable band, but the breadth mirrors Yahoo Finance's actual data surface (quotes, statements, analysts, ownership, filings, options, funds, screening, sector browsing). Each tool maps to a distinct upstream dataset rather than duplicating another, so the count is defensible.

Completeness5/5

Coverage spans the full read-only lifecycle: symbol discovery (search), price and history, statements, earnings/estimates, analyst views, ownership and insider activity, SEC filings, options chains, fund/ETF profiles, dividends, news, and market/sector/industry browsing plus a screener. Only exotic gaps remain (e.g. no movers/trending endpoint, quote lacks a timestamp), and those are noted in the descriptions rather than leaving silent dead ends.

Maintenance

ActivityNo data
ResponsivenessOutdated data