Skip to main content
Glama
benethos-hub

Yahoo Finance MCP Server

by benethos-hub

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

Capabilities

Features and capabilities supported by this server

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

Tools

Functions exposed to the LLM to take actions

NameDescription
searchA

Search Yahoo Finance by company name, ticker symbol, or ISIN.

Use this first to resolve a name or ISIN into a Yahoo symbol that the other tools accept. Returns up to limit matches (1-25), each with its symbol, name, exchange, and instrument type.

get_quoteA

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

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name. Do not build a symbol by appending an exchange suffix to an ISIN. If you only have a name or ISIN, call the search tool first and use the symbol it returns.

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. Symbols must be native Yahoo tickers (e.g. AAPL, SAP.DE), never ISINs, WKNs, or names.

get_historyA

Get historical OHLCV (open/high/low/close/volume) data for a symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. period accepts Yahoo values such as 1d, 5d, 1mo, 6mo, 1y, 5y, max. interval accepts e.g. 1m, 5m, 1h, 1d, 1wk, 1mo. Provide start (and optional end) as YYYY-MM-DD to query an explicit date range instead of period. Results are capped at the most recent 250 rows.

get_company_infoA

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

Returns name, sector/industry, location, employee count, and valuation metrics (market cap, P/E, beta, 52-week range, dividend yield) plus a business summary. symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first.

get_financialsA

Get a financial statement for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. statement is one of income (income statement), balance (balance sheet), or cashflow (cash flow statement). freq is annual, quarterly, or ttm (trailing twelve months, available for the income and cash-flow statements only). Each row is a line item; columns are reporting periods.

get_dividendsA

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

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first.

get_newsA

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

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. Each article includes title, summary, publisher, publish time, and URL.

get_recommendationsA

Get analyst recommendation trends and price targets for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. Returns the buy/hold/sell trend over recent months plus current/high/low/ mean/median analyst price targets when available.

get_optionsA

Get the option chain for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. 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.

get_earningsA

Get upcoming and historical earnings for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. Returns the earnings calendar (upcoming and past dates with EPS estimate, reported EPS, and surprise %) plus the recent earnings history. Equity-only; empty for ETFs, funds, and crypto.

get_estimatesA

Get forward analyst estimates for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. Returns earnings and revenue estimates, EPS trend and revisions, and growth estimates (small tables keyed by period). Equity-only; empty for ETFs, funds, and crypto.

get_upgrades_downgradesA

Get recent analyst rating changes (upgrades/downgrades) for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. Each entry is a firm's rating change with the from/to grade and action, most recent first. Equity-only; empty for ETFs, funds, and crypto.

get_holdersA

Get the ownership breakdown for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. Returns the high-level holder summary (insider/institutional percentages) plus the top institutional and mutual-fund holders. Equity-only; empty for ETFs, funds, and crypto.

get_insider_activityA

Get insider trading activity for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. Returns individual insider transactions, a 6-month purchases/sales summary, and the current insider roster. Equity-only; empty for ETFs, funds, and crypto.

get_sec_filingsA

Get recent SEC filings for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. Each entry has the filing date, type (e.g. 10-K, 10-Q, 8-K), title, the Yahoo EDGAR URL, and exhibit links. Equity-only; empty for ETFs, funds, and crypto.

get_calendarA

Get upcoming corporate-calendar events for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. Returns the next earnings date(s) with analyst estimate ranges and the next dividend / ex-dividend dates. Equity-only; empty for ETFs, funds, and crypto.

get_sharesA

Get the shares-outstanding history for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. AAPL, SAP.DE), never an ISIN, WKN, or company name; resolve those via search first. Each point is a date and the reported shares outstanding; only the most recent limit points are returned. Optionally bound the range with start / end (YYYY-MM-DD).

get_fund_dataA

Get fund/ETF profile data for a Yahoo symbol.

symbol must be a native Yahoo Finance ticker (e.g. SPY, VWRL.L), never an ISIN, WKN, or company name; resolve those via search first. 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_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. 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.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/benethos-hub/yahoo-finance-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server