yfinance-mcp-ts
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YFINANCE_HTTP3 | No | Enable HTTP/3 (impit only) | false |
| YFINANCE_TIMEOUT | No | Request timeout (ms) | 30000 |
| YFINANCE_PROXY_LIST | No | Newline-separated proxy URLs | |
| YFINANCE_HTTP_CLIENT | No | impit or axios | impit |
| YFINANCE_RETRY_ENABLED | No | Enable automatic retry | true |
| YFINANCE_RETRY_MAX_DELAY | No | Max retry delay (ms) | 60000 |
| YFINANCE_IGNORE_TLS_ERRORS | No | Ignore TLS certificate errors | false |
| YFINANCE_PROXY_COOLDOWN_MS | No | Cooldown before retrying unhealthy proxy (ms) | 300000 |
| YFINANCE_RETRY_MAX_RETRIES | No | Max retry attempts | 5 |
| YFINANCE_PROXY_MAX_FAILURES | No | Failures before marking proxy unhealthy | 3 |
| YFINANCE_RETRY_INITIAL_DELAY | No | Initial retry delay (ms) | 2000 |
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 | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_stock_priceA | Returns current price, change, market cap, and volume. Use for quick price checks; use get_stock_summary for valuation metrics. Text default; set format=json for structured data. |
| get_stock_summaryA | Returns valuation and trading metrics (P/E, yield, ranges, volume, bid/ask). Use for fundamental screening; use get_key_stats for advanced ratios. Text default; set format=json for structured data. |
| get_stock_profileA | Returns company profile (sector, industry, summary, governance). Use for company overview; set include_officers=true for executives. Text default; set format=json for structured data. |
| get_stock_historyB | Returns historical OHLCV data with auto-aggregation and stats. Use for price trends and technical analysis. Text default; set format=json for structured data. |
| get_financialsB | Returns financial statements with key metrics and YoY% changes. Default: summary mode (top metrics); use detail=full for all. Text default; set format=json for structured data. |
| get_optionsA | Returns option chain with ATM-anchored strike window. Default: nearest 3 expirations summary; use expiration param for specific chain. Text default; set format=json for structured data. |
| get_key_statsA | Returns advanced statistics (PEG, beta, EV ratios, margins, growth). Use for deep fundamental analysis beyond get_stock_summary. Text default; set format=json for structured data. |
| get_recommendationsA | Returns analyst consensus and 4-month recommendation trend. Use for sentiment analysis on a stock. Text default; set format=json for structured data. |
| get_earningsA | Returns EPS history with surprise %, next estimate, and revenue trend. Use for earnings analysis and surprise tracking. Text default; set format=json for structured data. |
| list_screenersA | Lists available stock screeners organized by category. Use to discover screener names before calling get_screener. Text default; set format=json for structured data. |
| get_screenerA | Runs a stock screener and returns top results as a compact table. Use list_screeners first to find screener names. Text default; set format=json for structured data. |
| get_screener_infoA | Returns detailed metadata about a specific screener including criteria. Use to understand what a screener filters before running it. Returns JSON. |
| get_earnings_calendarA | Returns upcoming earnings announcements with EPS estimates as a table. Use for tracking reporting dates across the market. Text default; set format=json for structured data. |
| get_iposB | Returns upcoming and recent IPO listings with pricing and deal details. Use for tracking new market listings. Text default; set format=json for structured data. |
| get_splitsA | Returns upcoming and recent stock splits with ratios. Use for tracking share split events. Text default; set format=json for structured data. |
| search_stocksA | Searches for stocks by company name or symbol. Use to find ticker symbols before calling other tools. Returns JSON. |
| get_market_summaryA | Returns major market indices with price, change, and percent change. Use for broad market overview. Text default; set format=json for structured data. |
| get_trendingB | Returns currently trending/most watched stock symbols. Use to find popular stocks before deeper analysis. Returns JSON. |
| get_currenciesA | Returns available currency pairs as a compact table. Use to find forex pair symbols. Text default; set format=json for structured data. |
| get_supported_countriesA | Returns list of supported countries for market data and screeners. Use to find valid country codes for other tools. Returns JSON. |
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 20 tools
Tools are mostly distinct with clear separation between price, summary, key stats, and financials; descriptions cross-reference each other to guide selection. However, several fundamental tools (get_stock_summary, get_key_stats, get_financials) have overlapping valuation concepts that require careful reading to disambiguate.
All tool names follow a consistent snake_case verb_noun pattern (get_, list_, search_) with no mixed conventions. The verb is predictable by action type, making the naming scheme easy to scan and remember.
At 20 tools, the set is on the heavy side for a single data-retrieval server, and some tools could be consolidated (e.g., stock summary, key stats, and financials). However, each tool maps to a distinct yfinance endpoint, so the count is defensible but borderline.
The surface covers a broad range of market data: prices, fundamentals, options, screeners, earnings, IPOs, currencies, and market overview. Minor gaps remain (dividends, news, holder data), but core workflows are well supported.