yfinance-mcp-serverAccess Yahoo Finance data — stock prices, history, financials, options, dividends, news, and market screeners
Install via ClawdBot CLI:
clawdbot install rizkydwicmt/yfinance-mcp-serverAccess real-time and historical financial data from Yahoo Finance. This MCP server provides 12 tools covering stock prices, company fundamentals, analyst recommendations, options chains, dividends, market movers, and news.
tool_get_stock_price — Current Price & Trading Metricstool_get_stock_price(symbol: "AAPL")
tool_get_stock_price(symbol: "BBCA.JK")Returns: current price, change %, open, day high/low, volume, 52-week range, market cap, P/E, dividend yield, direction (▲/▼).
tool_get_stock_info — Company Detailstool_get_stock_info(symbol: "MSFT")Returns: sector, industry, full name, market cap, P/E, P/B, profit margins, revenue growth, analyst price targets, business description.
tool_get_history — Historical OHLCV Datatool_get_history(symbol: "AAPL", period: "1mo", interval: "1d")
tool_get_history(symbol: "BBCA.JK", period: "1y", interval: "1wk")
tool_get_history(symbol: "BTC-USD", period: "5y", interval: "1mo")1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3motool_get_financials — Financial Statementstool_get_financials(symbol: "AAPL", statement_type: "income", quarterly: false)
tool_get_financials(symbol: "MSFT", statement_type: "balance_sheet", quarterly: true)
tool_get_financials(symbol: "GOOG", statement_type: "all")income, balance_sheet, cash_flow, alltool_get_recommendations — Analyst Ratingstool_get_recommendations(symbol: "TSLA")Returns: recommendation trends (strongBuy, buy, hold, sell, strongSell), price targets (low, mean, median, high), and recent upgrades/downgrades.
tool_get_options — Options Chaintool_get_options(symbol: "AAPL")
tool_get_options(symbol: "TSLA", expiration: "2025-03-21")Returns: calls and puts with strike, last price, bid, ask, volume, open interest, implied volatility. Lists available expiration dates.
tool_get_dividends — Dividend Historytool_get_dividends(symbol: "JNJ")
tool_get_dividends(symbol: "BBCA.JK")Returns: current yield, ex-date, payment rate, and historical dividend payments.
tool_compare_stocks — Side-by-Side Comparisontool_compare_stocks(symbols: "AAPL,MSFT,GOOG")
tool_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.
tool_get_market_movers — Top Moverstool_get_market_movers(mover_type: "gainers")
tool_get_market_movers(mover_type: "losers")
tool_get_market_movers(mover_type: "most_active")tool_screen_stocks — Stock Screenertool_screen_stocks(sector: "Technology", min_market_cap: 1000000000)
tool_screen_stocks(max_pe_ratio: 15, min_dividend_yield: 0.03)
tool_screen_stocks(sector: "Healthcare", exchange: "NMS")All filters are optional and combinable:
Technology, Healthcare, Financial Services, Energy, etc.1000000000 = $1B)25)0.03 = 3%)NMS (NASDAQ), NYQ (NYSE), etc.tool_search_stocks — Find Tickerstool_search_stocks(query: "Apple", max_results: 5)
tool_search_stocks(query: "semiconductor ETF")
tool_search_stocks(query: "bank indonesia")Searches stocks, ETFs, mutual funds, indices by name, ticker, or keyword.
tool_get_news — Latest Newstool_get_news(symbol: "AAPL", max_items: 5)
tool_get_news(symbol: "TSLA")Returns: title, publisher, link, publish time, and thumbnail for each article.
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 |
tool_search_stocks → find the tickertool_get_stock_info → understand the companytool_get_financials → analyze fundamentalstool_get_recommendations → check analyst sentimenttool_get_history → review price trendstool_compare_stocks → compare your holdingstool_get_stock_price → check current pricestool_get_news → stay updated on each positiontool_get_market_movers → find trending stockstool_screen_stocks → filter by criteriatool_get_stock_info → deep dive on candidatesThe included install.sh automates everything — uv setup, Python 3.12 venv, package install, mcporter config, and OpenClaw skill registration:
# Clone the repository on your server
git clone https://github.com/rizkydwicmt/yfinance-mcp-server.git
cd yfinance-mcp-server
# Run the installer
chmod +x install.sh
./install.shThe installer will:
pyproject.toml in the project directoryuv if not already presentyfinance-mcp-server + all dependenciesyfinance to your mcporter config (auto-detected)SKILL.md to OpenClaw skills directoryCustomize the installer behavior with environment variables:
# Change project location
YFINANCE_PROJECT_DIR=/opt/mcp/yfinance ./install.sh
# Use a different Python version
YFINANCE_PYTHON_VERSION=3.11 ./install.sh
# Custom venv location
YFINANCE_VENV_DIR=/opt/venvs/yfinance ./install.sh
# Specify mcporter config path
MCPORTER_CONFIG=/etc/clawd/mcporter.json ./install.sh
# Custom OpenClaw directory
CLAWD_DIR=/opt/clawd ./install.sh
# Skip mcporter / skill steps
SKIP_MCPORTER=true ./install.sh
SKIP_SKILL=true ./install.sh# 1. Clone repository
git clone https://github.com/rizkydwicmt/yfinance-mcp-server.git
cd yfinance-mcp-server
# 2. Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# 3. Create venv + install
uv venv .venv --python 3.12
uv pip install -e . --python .venv/bin/python
# 4. Add to mcporter.json
# {"mcpServers": {"yfinance": {"command": "/path/to/.venv/bin/yfin-mcp"}}}
# 5. Install skill
mkdir -p ${CLAWD_DIR}/skills/yfinance
cp SKILL.md ${CLAWD_DIR}/skills/yfinance/SKILL.md# Check tools load
mcporter --config ${CLAWD_DIR}/config/mcporter.json list yfinance --schema
# Live test
mcporter --config ${CLAWD_DIR}/config/mcporter.json call yfinance.tool_get_stock_price symbol=AAPLGenerated Mar 1, 2026
An individual investor uses the skill to research stocks before investing. They search for tickers, analyze company fundamentals and financials, check analyst recommendations, and review historical price trends to make informed decisions.
A financial advisor monitors client portfolios by comparing multiple stocks, checking current prices and news, and screening for new investment opportunities based on criteria like sector and market cap to provide tailored advice.
A student or researcher analyzes market data for academic projects, using historical OHLCV data, financial statements, and market movers to study trends, volatility, or economic impacts across different sectors and regions.
A business analyst uses the skill to benchmark their company against competitors by comparing stock performance, financial metrics, and analyst ratings to identify strengths, weaknesses, and market positioning.
A trader develops and backtests trading strategies by accessing real-time and historical data, options chains, and market movers to identify patterns, assess risk, and optimize entry/exit points for stocks or crypto.
A company integrates this skill into a paid platform offering advanced analytics, personalized alerts, and portfolio tracking for retail investors, generating revenue through monthly or annual subscriptions.
A business licenses the skill's data access to other companies, such as fintech apps or news outlets, providing real-time financial data feeds and earning revenue through API usage fees or tiered pricing plans.
An app uses the skill to offer basic free features like stock prices and news, with premium upgrades for advanced tools like stock screening, detailed financials, and options data, driving revenue from in-app purchases.
💬 Integration Tip
Ensure proper error handling for invalid tickers or network issues, and cache frequently accessed data like stock prices to improve performance and reduce API calls.
Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.
Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.
Yahoo Finance (yfinance) powered stock analysis skill: quotes, fundamentals, ASCII trends, high-resolution charts (RSI/MACD/BB/VWAP/ATR), plus optional web a...
Become an autonomous prediction market trader on Polymarket with AI-powered analysis and a performance-backed token on Base. Trade real markets, build a track record, and let the buyback flywheel run.
Get cryptocurrency token price and generate candlestick charts via CoinGecko API or Hyperliquid API. Use when user asks for token price, crypto price, price chart, or cryptocurrency market data.
Trade and monitor Hyperliquid perpetual futures. Check balances, view positions with P&L, place/cancel orders, execute market trades. Use when the user asks about Hyperliquid trading, portfolio status, crypto positions, or wants to execute trades on Hyperliquid.