Yahoo Finance MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YF_MCP_HOST | No | Bind host for HTTP transports (e.g., 0.0.0.0 for remote). | 127.0.0.1 |
| YF_MCP_PATH | No | URL path for HTTP transports (for sse, default is /sse). | /mcp |
| YF_MCP_PORT | No | Port for HTTP transports. | 8000 |
| YF_MCP_CACHE | No | Set to '1' to enable persistent result cache (off by default). | |
| YF_MCP_CACHE_DIR | No | Directory for the cache file (default is OS cache directory). | |
| YF_MCP_LOG_LEVEL | No | Log level: DEBUG, INFO, WARNING, ERROR, or CRITICAL. | INFO |
| YF_MCP_TRANSPORT | No | Transport 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.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| searchA | Search Yahoo Finance by company name, ticker symbol, or ISIN. Use this first to resolve a name or ISIN into a Yahoo |
| get_quoteB | Get the current price and key intraday figures for a Yahoo symbol. |
| 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 |
| get_historyA | Get historical OHLCV (open/high/low/close/volume) data for a symbol.
|
| get_company_infoB | 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. |
| get_financialsA | Get a financial statement for a Yahoo symbol.
|
| get_dividendsB | Get the dividend and stock-split history for a Yahoo symbol. |
| get_newsA | Get recent news headlines for a Yahoo symbol (up to Each article includes title, summary, publisher, publish time, and URL. |
| 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_optionsA | Get the option chain for a Yahoo symbol. Call without |
| 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, empty for ETFs, funds, and crypto. |
| 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, empty for ETFs, funds, and crypto. |
| 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, empty for ETFs, funds, and crypto. |
| 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, empty for ETFs, funds, and crypto. |
| 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, empty for ETFs, funds, and crypto. |
| get_sec_filingsA | Get recent SEC filings for a Yahoo symbol. Each entry has the filing date, type (e.g. |
| 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, empty for ETFs, funds, and crypto. |
| 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 |
| get_fund_dataA | 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_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 |
| 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 |
| 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
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 22 tools
Each tool targets a distinct piece of Yahoo Finance data: quotes, fund data, history, company info, financials, dividends, news, recommendations, options, earnings, estimates, upgrades/downgrades, holders, insider activity, SEC filings, calendar, shares, sector, industry, and market status. Despite some thematic overlap (e.g., earnings vs. calendar), every tool has a clear, non-overlapping purpose and descriptions make the differences explicit.
All 22 tools follow a consistent 'get_<noun>' pattern in snake_case. Even multi-word tool names (e.g., get_fund_data, get_company_info, get_upgrades_downgrades) adhere without deviation. This predictable structure makes the tool set easy to navigate.
With 22 tools, the server covers the broad scope of Yahoo Finance data without being bloated. Each tool serves a specific functional area (quotes, fundamentals, market data, etc.), and the count feels well-calibrated for the domain—neither too sparse nor excessive.
The tool set covers the vast majority of common Yahoo Finance use cases: quotes, historical data, financial statements, news, options, earnings, estimates, insider trading, SEC filings, sector/industry browsing, and market status. Minor gaps exist (e.g., no symbol-specific index constituents or currency data), but the surface is comprehensive for typical financial analysis tasks.