yfinance-ai MCP server

Yahoo Finance for Claude, Cursor, VS Code and any MCP client, in 68 tools. Real-time quotes, history, financial statements, ratios and valuation history, analyst estimates and price targets, earnings, dividends, options, holders and insiders, funds and ETFs, crypto, forex, commodities, market movers, sectors and industries, and earnings, IPO, economic and split calendars.

Also available as
🦞 OpenClaw skill, thousands of downloads	`openclaw skills install @lkcair/stocks` (ClawHub, skill repo)
🌐 OpenWebUI tool, thousands of downloads	openwebui.com (source)
📑 SEC EDGAR filings, same family	sec-ai MCP server

Install: one command

Needs uv. No API key, no account, no Docker.

Claude Code

claude mcp add yfinance-ai -- uvx yfinance-ai@latest

VS Code

code --add-mcp '{"name":"yfinance-ai","type":"stdio","command":"uvx","args":["yfinance-ai@latest"]}'

Claude Desktop, Cursor, Windsurf and any other MCP client: add to the client's MCP config (claude_desktop_config.json, .cursor/mcp.json, ...)

{
  "mcpServers": {
    "yfinance-ai": {
      "command": "uvx",
      "args": [
        "yfinance-ai@latest"
      ]
    }
  }
}

@latest checks PyPI on each start, so you always run the newest release. Without uv: pip install yfinance-ai and use "command": "yfinance-ai" with no args.

Ask it anything

"Compare AAPL, MSFT and GOOGL on valuation and margins"
"What are analysts saying about NVIDIA? Price targets and recent upgrades"
"Is Apple buying back shares? Show shares outstanding over 5 years"
"Who reports earnings this week?" / "Economic calendar for this week" / "Upcoming IPOs"
"Top gainers today" / "Semiconductor industry: largest and fastest-growing companies"
"SPY top holdings and sector weights" / "Options chain for TSLA, nearest expiry"
"Bitcoin price" / "EUR/USD rate" / "Gold and oil today"

Why yfinance-ai

68 tools, more than four times the most-starred yfinance MCP servers (15 and 9 tools), covering everything above in one server.
Answers written for an AI: readable text with context, not raw dataframes.
Numbers checked at every release against independent sources: revenue, net income, assets and TTM figures against SEC XBRL filings, prices and ratios against a second Yahoo endpoint.
Every tool is read-only (MCP annotations), with retries, validation and rate limiting.
The same toolkit runs everywhere: MCP, OpenClaw and OpenWebUI, with thousands of downloads on ClawHub and OpenWebUI.
Built-in self-test: ask "run the yfinance self-test".

Tools (68)

Quotes and history

Tool	Parameters	What it does
`get_stock_price`	`ticker`	Get current stock price and key metrics for a ticker symbol
`get_stock_quote`	`ticker`	Get detailed quote with bid/ask, day range, and trading info
`get_fast_info`	`ticker`	Get fast-access ticker information (lightweight, quick response)
`get_historical_data`	`ticker, period="1y", interval="1d"`	Get historical price data for a stock
`get_historical_price_on_date`	`ticker, date`	Get historical price for a specific date
`download_multiple_tickers`	`tickers, period="1mo", interval="1d"`	Download historical data for multiple tickers at once (bulk operation)

Company

Tool	Parameters	What it does
`get_company_info`	`ticker`	Get detailed company information and business description
`get_company_overview`	`ticker`	Company overview with context for every metric
`get_company_officers`	`ticker`	Get company officers and key management
`get_isin`	`ticker`	Get International Securities Identification Number (ISIN) for a ticker

Financials

Tool	Parameters	What it does
`get_income_statement`	`ticker, period="annual"`	Get income statement data
`get_balance_sheet`	`ticker, period="annual"`	Get balance sheet data
`get_cash_flow`	`ticker, period="annual"`	Get cash flow statement data
`get_ttm_financials`	`ticker`	Get trailing-twelve-month (TTM) income statement and cash flow
`get_key_ratios`	`ticker`	Get key financial ratios and valuation metrics
`get_valuation_history`	`ticker`	Get valuation measures now and for the last quarters (market cap, EV, P/E, PEG, P/S, P/B, EV/EBITDA)
`get_financial_summary`	`ticker`	Get a comprehensive one-page financial summary of a stock
`get_shares_history`	`ticker, years=3`	Get shares outstanding over time (dilution or buybacks)

Earnings and estimates

Tool	Parameters	What it does
`get_earnings_dates`	`ticker`	Get upcoming and past earnings dates with estimates
`get_earnings_history`	`ticker`	Get historical earnings data with annual and quarterly figures
`get_earnings_calendar`	`ticker`	Get earnings calendar including next earnings date and dividend dates
`get_analyst_estimates`	`ticker`	Get analyst estimates for earnings, revenue, and EPS
`get_growth_estimates`	`ticker`	Get analyst growth estimates
`get_eps_trend`	`ticker`	Get EPS (Earnings Per Share) trend data showing how estimates have changed
`get_eps_revisions`	`ticker`	Get EPS revision data showing analyst estimate changes

Analysts

Tool	Parameters	What it does
`get_analyst_recommendations`	`ticker`	Get analyst recommendations and ratings
`get_analyst_price_targets`	`ticker`	Get detailed analyst price targets for a stock
`get_upgrades_downgrades`	`ticker, limit=20`	Get detailed analyst upgrades and downgrades history

Holders and insiders

Tool	Parameters	What it does
`get_institutional_holders`	`ticker`	Get major institutional holders and their ownership
`get_major_holders`	`ticker`	Get major holders summary (institutions, insiders, public float)
`get_mutualfund_holders`	`ticker`	Get mutual fund holders
`get_insider_transactions`	`ticker`	Get recent insider trading activity
`get_insider_purchases`	`ticker`	Get insider purchases only (filtered for buys)
`get_insider_roster_holders`	`ticker`	Get insider roster (list of company insiders)

Dividends and corporate actions

Tool	Parameters	What it does
`get_dividends`	`ticker, period="5y"`	Get dividend payment history and current metrics
`get_stock_splits`	`ticker`	Get stock split history
`get_corporate_actions`	`ticker`	Get all corporate actions (dividends + splits combined)
`get_capital_gains`	`ticker`	Get capital gains distributions (primarily for funds/ETFs)

Options

Tool	Parameters	What it does
`get_options_chain`	`ticker, expiration=""`	Get options chain data (calls and puts)
`get_options_expirations`	`ticker`	Get all available options expiration dates

Market-wide

Tool	Parameters	What it does
`get_market_status`		Check if US stock markets are currently open
`get_market_summary`	`region="US"`	Get a market overview for a region: open/closed status plus main indices, futures, bonds and FX
`get_market_indices`		Get current prices for major market indices
`get_market_movers`	`category="day_gainers", count=10`	Get today's market movers from Yahoo Finance screeners
`get_trending_tickers`	`count=10`	Get today's most active (trending) US tickers
`get_sector_performance`		Get performance of major market sectors
`get_sector_overview`	`sector="technology"`	Get a sector overview: size, weight, largest companies, industries and sector ETFs
`get_industry_overview`	`industry="semiconductors"`	Get an industry overview: largest, best-performing and fastest-growing companies

Calendars

Tool	Parameters	What it does
`get_upcoming_earnings`	`days=7, limit=25`	Get the market-wide earnings calendar (which companies report in the next N days)
`get_ipo_calendar`	`days=14, limit=25`	Get upcoming IPOs (exchange, expected date, price range, shares)
`get_economic_calendar`	`days=7, limit=30`	Get upcoming economic events (CPI, jobs, GDP, rate decisions) with expected and prior values
`get_splits_calendar`	`days=14, limit=25`	Get upcoming stock splits

Funds and ETFs

Tool	Parameters	What it does
`get_fund_overview`	`ticker`	Get overview data for an ETF or mutual fund
`get_fund_holdings`	`ticker, limit=25`	Get top holdings for an ETF or mutual fund
`get_fund_sector_weights`	`ticker`	Get sector allocation/weights for an ETF or mutual fund

Crypto, forex and commodities

Tool	Parameters	What it does
`get_crypto_price`	`symbol`	Get cryptocurrency price and market data
`get_forex_rate`	`pair`	Get foreign exchange (forex) rate for a currency pair
`get_commodity_price`	`commodity`	Get commodity/futures price data

Compare

Tool	Parameters	What it does
`compare_stocks`	`tickers`	Compare key metrics across multiple stocks
`get_peer_comparison`	`ticker, peers=null`	Compare a stock with its peers on key metrics
`get_historical_comparison`	`tickers, period="1y"`	Compare historical price performance of multiple stocks
`get_complete_analysis`	`ticker, peers=""`	Complete analysis of a stock, calling every relevant tool

News and filings

Tool	Parameters	What it does
`get_stock_news`	`ticker, limit=10`	Get recent news articles about a stock
`get_sec_filings`	`ticker`	Get recent SEC filings (10-K, 10-Q, 8-K, etc.)

Utility

Tool	Parameters	What it does
`search_ticker`	`query`	Search for ticker symbols by company name or keyword
`validate_ticker`	`ticker`	Validate if a ticker symbol exists and is tradeable
`get_api_status`		Get API status and usage information
`run_self_test`	`ticker="SPY"`	Run comprehensive self-test of the yfinance-ai tools (64 checks)

License

MIT. Data comes from Yahoo Finance through yfinance and may be delayed. Not affiliated with Yahoo. For research and education, not investment advice.

Metadata

Release files for yfinance-ai 5.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for yfinance-ai 5.0.1
File	Size	Uploaded	Provenance
yfinance_ai-5.0.1.tar.gz	51.5 kB	Oct 21, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for yfinance-ai 5.0.1
File	Interpreter	ABI	Platform	Reset
yfinance_ai-5.0.1-py3-none-any.whl 53.5 kB Oct 21, 2026 With provenance	Python 3	none	any	Details

Total release size: 105.0 kB

Release files / yfinance_ai-5.0.1.tar.gz

Download URL	yfinance_ai-5.0.1.tar.gz
Size	51.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`297a6ab75d6b94bcea60434c4edb26b802b7feb3e21880fad9e37125fbc71364`
BLAKE2b-256 checksum How to use checksums	`17c511a1ce1293a033592477503adc1a1af88b6305656eac9e6e2e5fff7e30b6`
Upload date	Oct 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lkcair/yfinance-ai-mcp
Publishing commit: github.com/lkcair/yfinance-ai-mcp/tree/eb93e940a0a2290676aa609d30b8a5d9dbeb1a4d

Workflow

Publishing configuration: github.com/lkcair/yfinance-ai-mcp/blob/eb93e940a0a2290676aa609d30b8a5d9dbeb1a4d/.github/workflows/publish.yml
Publishing logs: github.com/lkcair/yfinance-ai-mcp/actions/runs/39539923656/attempts/1

Artifact

Subject: yfinance_ai-5.0.1.tar.gz
SHA-256 checksum: 297a6ab75d6b94bcea60434c4edb26b802b7feb3e21880fad9e37125fbc71364 Verifying attestations

Release files / yfinance_ai-5.0.1-py3-none-any.whl

Download URL	yfinance_ai-5.0.1-py3-none-any.whl
Size	53.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`48f124c151efea19f18a5415e9674d17574315b4a41c8ca8bf014988436fa7f2`
BLAKE2b-256 checksum How to use checksums	`523e68e5cc86a7d007068e91a5ded907c5412759c7f96c34c52767629d7ac682`
Upload date	Oct 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lkcair/yfinance-ai-mcp
Publishing commit: github.com/lkcair/yfinance-ai-mcp/tree/eb93e940a0a2290676aa609d30b8a5d9dbeb1a4d

Workflow

Publishing configuration: github.com/lkcair/yfinance-ai-mcp/blob/eb93e940a0a2290676aa609d30b8a5d9dbeb1a4d/.github/workflows/publish.yml
Publishing logs: github.com/lkcair/yfinance-ai-mcp/actions/runs/39539923656/attempts/1

Artifact

Subject: yfinance_ai-5.0.1-py3-none-any.whl
SHA-256 checksum: 48f124c151efea19f18a5415e9674d17574315b4a41c8ca8bf014988436fa7f2 Verifying attestations

Security for yfinance-ai 5.0.1

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for yfinance_ai-5.0.1.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lkcair/yfinance-ai-mcp
Publishing commit: github.com/lkcair/yfinance-ai-mcp/tree/eb93e940a0a2290676aa609d30b8a5d9dbeb1a4d

Workflow

Publishing configuration: github.com/lkcair/yfinance-ai-mcp/blob/eb93e940a0a2290676aa609d30b8a5d9dbeb1a4d/.github/workflows/publish.yml
Publishing logs: github.com/lkcair/yfinance-ai-mcp/actions/runs/39539923656/attempts/1

Artifact

Subject: yfinance_ai-5.0.1.tar.gz
SHA-256 checksum: 297a6ab75d6b94bcea60434c4edb26b802b7feb3e21880fad9e37125fbc71364 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.