✓ Verified 💻 Development ✓ Enhanced Data

Yfinance Mcp Server

Access Yahoo Finance data — stock prices, history, financials, options, dividends, news, and market

Rating
4 (12 reviews)
Downloads
739 downloads
Version
1.0.0

Overview

Access Yahoo Finance data — stock prices, history, financials, options, dividends, news, and market screeners.

Complete Documentation

View Source →

YFinance MCP Server

Access 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.

Available Tools

Stock Data (7 tools)

#### tool_get_stock_price — Current Price & Trading Metrics

text
tool_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 Details

text
tool_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 Data

text
tool_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")
  • 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
#### tool_get_financials — Financial Statements
text
tool_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")
  • statement_type: income, balance_sheet, cash_flow, all
#### tool_get_recommendations — Analyst Ratings
text
tool_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 Chain

text
tool_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 History

text
tool_get_dividends(symbol: "JNJ")
tool_get_dividends(symbol: "BBCA.JK")
Returns: current yield, ex-date, payment rate, and historical dividend payments.

Market Analysis (3 tools)

#### tool_compare_stocks — Side-by-Side Comparison

text
tool_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 Movers

text
tool_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 Screener

text
tool_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:
  • sector: Technology, Healthcare, Financial Services, 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.

Search & News (2 tools)

#### tool_search_stocks — Find Tickers

text
tool_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 News

text
tool_get_news(symbol: "AAPL", max_items: 5)
tool_get_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:

MarketExamples
US StocksAAPL, 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)
ETFsSPY, QQQ, VTI, VOO, ARKK
CryptoBTC-USD, ETH-USD, SOL-USD
Indices^GSPC (S&P 500), ^IXIC (NASDAQ), ^JKSE (IDX)
ForexUSDIDR=X, EURUSD=X, GBPUSD=X

Common Usage Patterns

Investment Research

  • tool_search_stocks → find the ticker
  • tool_get_stock_info → understand the company
  • tool_get_financials → analyze fundamentals
  • tool_get_recommendations → check analyst sentiment
  • tool_get_history → review price trends

Portfolio Monitoring

  • tool_compare_stocks → compare your holdings
  • tool_get_stock_price → check current prices
  • tool_get_news → stay updated on each position

Market Discovery

  • tool_get_market_movers → find trending stocks
  • tool_screen_stocks → filter by criteria
  • tool_get_stock_info → deep dive on candidates

Installation

Quick Install (install.sh)

The included install.sh automates everything — uv setup, Python 3.12 venv, package install, mcporter config, and OpenClaw skill registration:

bash
# 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.sh

The installer will:

  • ✅ Check for pyproject.toml in the project directory
  • ✅ Install uv if not already present
  • ✅ Create a Python 3.12 virtual environment
  • ✅ Install yfinance-mcp-server + all dependencies
  • ✅ Verify all 12 tools load correctly
  • ✅ Add yfinance to your mcporter config (auto-detected)
  • ✅ Install SKILL.md to OpenClaw skills directory

Environment Variables

Customize the installer behavior with environment variables:

bash
# 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

Manual Install

bash
# 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

Verify

bash
# 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=AAPL

Installation

Terminal bash 

openclaw install yfinance-mcp-server
Copied!

💻Code Examples

#### `tool_get_stock_price` — Current Price & Trading Metrics

-toolgetstockprice--current-price--trading-metrics.txt
tool_get_stock_price(symbol: "AAPL")
tool_get_stock_price(symbol: "BBCA.JK")

#### `tool_get_history` — Historical OHLCV Data

-toolgethistory--historical-ohlcv-data.txt
tool_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")

#### `tool_get_financials` — Financial Statements

-toolgetfinancials--financial-statements.txt
tool_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")

#### `tool_get_options` — Options Chain

-toolgetoptions--options-chain.txt
tool_get_options(symbol: "AAPL")
tool_get_options(symbol: "TSLA", expiration: "2025-03-21")

#### `tool_get_dividends` — Dividend History

-toolgetdividends--dividend-history.txt
tool_get_dividends(symbol: "JNJ")
tool_get_dividends(symbol: "BBCA.JK")

#### `tool_compare_stocks` — Side-by-Side Comparison

-toolcomparestocks--side-by-side-comparison.txt
tool_compare_stocks(symbols: "AAPL,MSFT,GOOG")
tool_compare_stocks(symbols: "BBCA.JK BBRI.JK BMRI.JK")

#### `tool_get_market_movers` — Top Movers

-toolgetmarketmovers--top-movers.txt
tool_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 Screener

-toolscreenstocks--stock-screener.txt
tool_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")

#### `tool_search_stocks` — Find Tickers

-toolsearchstocks--find-tickers.txt
tool_search_stocks(query: "Apple", max_results: 5)
tool_search_stocks(query: "semiconductor ETF")
tool_search_stocks(query: "bank indonesia")

#### `tool_get_news` — Latest News

-toolgetnews--latest-news.txt
tool_get_news(symbol: "AAPL", max_items: 5)
tool_get_news(symbol: "TSLA")

Tags

#coding_agents-and-ides #data

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author rizkydwicmt
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install yfinance-mcp-server

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Acestep Lyrics Transcription

Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.

⚡ GPT-Optimized #ai_and-llms #api #script
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0