Yfinance

YFinance MCP Server

访问 real-time and historical financial data from Yahoo Finance. This MCP server provides 12 工具s covering stock prices, company fundamentals, analyst recommendations, options chAIns, dividends, market movers, and news.

AvAIlable 工具s Stock Data (7 工具s) 工具_获取_stock_price — Current Price & Trading 指标 工具_获取_stock_price(symbol: "AAPL") 工具_获取_stock_price(symbol: "BBCA.JK")

Returns: current price, change %, open, day high/low, volume, 52-week range, market cap, P/E, dividend yield, direction (▲/▼).

工具_获取_stock_信息 — Company DetAIls 工具_获取_stock_信息(symbol: "MSFT")

Returns: sector, industry, full name, market cap, P/E, P/B, profit margins, revenue growth, analyst price tar获取s, business description.

工具_获取_历史 — Historical OHLCV Data 工具_获取_历史(symbol: "AAPL", period: "1mo", interval: "1d") 工具_获取_历史(symbol: "BBCA.JK", period: "1y", interval: "1wk") 工具_获取_历史(symbol: "BTC-USD", period: "5y", interval: "1mo")

period: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max interval: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo 工具_获取_financials — Financial 状态ments 工具_获取_financials(symbol: "AAPL", 状态ment_type: "income", quarterly: false) 工具_获取_financials(symbol: "MSFT", 状态ment_type: "balance_sheet", quarterly: true) 工具_获取_financials(symbol: "GOOG", 状态ment_type: "all")

状态ment_type: income, balance_sheet, cash_flow, all 工具_获取_recommendations — Analyst Ratings 工具_获取_recommendations(symbol: "TSLA")

Returns: recommendation trends (strongBuy, buy, hold, sell, strongSell), price tar获取s (low, mean, median, high), and recent 升级s/降级s.

工具_获取_options — Options ChAIn 工具_获取_options(symbol: "AAPL") 工具_获取_options(symbol: "TSLA", expiration: "2025-03-21")

Returns: calls and puts with strike, last price, bid, ask, volume, open interest, implied volatility. 列出s avAIlable expiration dates.

工具_获取_dividends — Dividend 历史 工具_获取_dividends(symbol: "JNJ") 工具_获取_dividends(symbol: "BBCA.JK")

Returns: current yield, ex-date, payment rate, and historical dividend payments.

Market Analysis (3 工具s) 工具_compare_stocks — Side-by-Side Comparison 工具_compare_stocks(symbols: "AAPL,MSFT,GOOG") 工具_compare_stocks(symbols: "BBCA.JK BBRI.JK BMRI.JK")

Compares up to 10 stocks on: price, change %, market cap, P/E, dividend yield, margins, revenue growth, analyst rating. Symbols can be comma or space separated.

工具_获取_market_movers — Top Movers 工具_获取_market_movers(mover_type: "gAIners") 工具_获取_market_movers(mover_type: "losers") 工具_获取_market_movers(mover_type: "most_active")

工具_screen_stocks — Stock Screener 工具_screen_stocks(sector: "Techno记录y", min_market_cap: 1000000000) 工具_screen_stocks(max_pe_ratio: 15, min_dividend_yield: 0.03) 工具_screen_stocks(sector: "健康care", exchange: "NMS")

All 过滤器s are optional and combinable:

sector: Techno记录y, 健康care, Financial 服务s, Energy, etc. min_market_cap: in USD (e.g., 1000000000 = $1B) max_pe_ratio: max trAIling P/E (e.g., 25) min_dividend_yield: as decimal (e.g., 0.03 = 3%) exchange: NMS (NASDAQ), NYQ (NYSE), etc. 搜索 & News (2 工具s) 工具_搜索_stocks — Find Tickers 工具_搜索_stocks(查询: "应用le", max_结果s: 5) 工具_搜索_stocks(查询: "semiconductor ETF") 工具_搜索_stocks(查询: "bank indonesia")

搜索es stocks, ETFs, mutual funds, indices by name, ticker, or keyword.

工具_获取_news — Latest News 工具_获取_news(symbol: "AAPL", max_items: 5) 工具_获取_news(symbol: "TSLA")

Returns: title, publisher, link, publish time, and thumbnAIl for each article.

Supported Markets

This server works with any ticker supported by Yahoo Finance:

Market Examples US Stocks AAPL, MSFT, GOOG, TSLA, AMZN Indonesia (IDX) BBCA.JK, BBRI.JK, TLKM.JK, BMRI.JK Japan (TSE) 7203.T (Toyota), 6758.T (Sony) UK (LSE) SHEL.L, AZN.L, HSBA.L Hong Kong (HKEX) 0700.HK (Tencent), 9988.HK (Alibaba) ETFs SPY, QQQ, VTI, VOO, ARKK Crypto BTC-USD, ETH-USD, SOL-USD Indices ^GSPC (S&P 500), ^IXIC (NASDAQ), ^JKSE (IDX) Forex USDIDR=X, EURUSD=X, GBPUSD=X Common Usage Patterns Investment Re搜索 工具_搜索_stocks → find the ticker 工具_获取_stock_信息 → understand the company 工具_获取_financials → analyze fundamentals 工具_获取_recommendations → 检查 analyst sentiment 工具_获取_历史 → review price trends Portfolio 监控ing 工具_compare_stocks → compare your holdings 工具_获取_stock_price → 检查 current prices 工具_获取_news → stay 更新d on each position Market Discovery 工具_获取_market_movers → find trending stocks 工具_screen_stocks → 过滤器 by criteria 工具_获取_stock_信息 → deep dive on candidates 安装ation Quick 安装 (安装.sh)

The included 安装.sh automates everything — uv 设置up, Python 3.12 venv, package 安装, mcporter config, and OpenClaw 技能 registration:

# Clone the 仓库 on your server git clone https://github.com/rizkydwicmt/yfinance-mcp-server.git cd yfinance-mcp-server

# 运行 the 安装er chmod +x in