# Send Yfinance to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "yfinance-mcp-server",
    "name": "Yfinance",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/rizkydwicmt/yfinance-mcp-server",
    "canonicalUrl": "https://clawhub.ai/rizkydwicmt/yfinance-mcp-server",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/yfinance-mcp-server",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yfinance-mcp-server",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "install.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "yfinance-mcp-server",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-11T08:25:01.331Z",
      "expiresAt": "2026-05-18T08:25:01.331Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yfinance-mcp-server",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yfinance-mcp-server",
        "contentDisposition": "attachment; filename=\"yfinance-mcp-server-0.1.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "yfinance-mcp-server"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/yfinance-mcp-server"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/yfinance-mcp-server",
    "downloadUrl": "https://openagent3.xyz/downloads/yfinance-mcp-server",
    "agentUrl": "https://openagent3.xyz/skills/yfinance-mcp-server/agent",
    "manifestUrl": "https://openagent3.xyz/skills/yfinance-mcp-server/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/yfinance-mcp-server/agent.md"
  }
}
```
## Documentation

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

### Stock Data (7 tools)

tool_get_stock_price — Current Price & Trading Metrics

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

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

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

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

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

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

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

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

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

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

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

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:

MarketExamplesUS StocksAAPL, MSFT, GOOG, TSLA, AMZNIndonesia (IDX)BBCA.JK, BBRI.JK, TLKM.JK, BMRI.JKJapan (TSE)7203.T (Toyota), 6758.T (Sony)UK (LSE)SHEL.L, AZN.L, HSBA.LHong Kong (HKEX)0700.HK (Tencent), 9988.HK (Alibaba)ETFsSPY, QQQ, VTI, VOO, ARKKCryptoBTC-USD, ETH-USD, SOL-USDIndices^GSPC (S&P 500), ^IXIC (NASDAQ), ^JKSE (IDX)ForexUSDIDR=X, EURUSD=X, GBPUSD=X

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

### Quick Install (install.sh)

The 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.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:

# 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

# 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

# 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: rizkydwicmt
- Version: 0.1.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-11T08:25:01.331Z
- Expires at: 2026-05-18T08:25:01.331Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/yfinance-mcp-server)
- [Send to Agent page](https://openagent3.xyz/skills/yfinance-mcp-server/agent)
- [JSON manifest](https://openagent3.xyz/skills/yfinance-mcp-server/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/yfinance-mcp-server/agent.md)
- [Download page](https://openagent3.xyz/downloads/yfinance-mcp-server)