Skip to main content
Glama
Yahoo Finance MCP Server

Yahoo Finance MCP Server

by narumiruna

Yahoo Finance MCPサーバー

PyPI version Python CI License: MIT

Model Context Protocol (MCP)サーバーであり、AIアシスタントがyfinanceを通じてYahoo Financeのデータにアクセスできるようにします。株価情報、金融ニュース、セクターランキングの照会や、プロフェッショナルな財務チャートの生成をすべてAIチャットから行えます。

機能

  • 株価データ — 企業情報、財務、評価指標、配当、取引データ

  • 財務諸表 — 過去データを含む損益計算書および貸借対照表(EBIT、投下資本など)

  • 金融ニュース — 各ティッカーの最新ニュース記事およびプレスリリース

  • 検索 — Yahoo Finance全体から株式、ETF、ニュースを検索

  • セクターランキング — セクター別のトップETF、投資信託、企業、成長リーダー、好調企業

  • 価格履歴 — Markdownテーブルまたはプロフェッショナルなチャートとしての過去のOHLCVデータ

  • チャート生成 — WebP画像として返されるローソク足、VWAP、出来高プロファイルチャート

Related MCP server: DuckDuckGo MCP Server

ツール

yfinance_get_ticker_info

企業情報、財務、取引指標、ガバナンスデータを含む包括的な株価データを取得します。

パラメータ

型

必須

説明

symbol

string

はい

株式ティッカーシンボル (例: AAPL, GOOGL, MSFT)

戻り値: 企業詳細、価格データ、評価指標、取引情報、配当、財務、パフォーマンス指標を含むJSONオブジェクト。

yfinance_get_ticker_news

特定の株式に関する最新のニュース記事やプレスリリースを取得します。

パラメータ

型

必須

説明

symbol

string

はい

株式ティッカーシンボル

戻り値: タイトル、要約、公開日、プロバイダー、URL、サムネイルを含むニュース項目のJSON配列。

Yahoo Financeで株式、ETF、ニュース記事を検索します。

パラメータ

型

必須

説明

query

string

はい

検索クエリ — 企業名、ティッカーシンボル、またはキーワード

search_type

string

はい

"all" (銘柄+ニュース)、"quotes" (株式/ETFのみ)、または "news" (記事のみ)

戻り値: search_typeに応じた一致する銘柄および/またはニュース結果。

yfinance_get_top

市場セクター内でトップランクの金融エンティティを取得します。

パラメータ

型

必須

説明

sector

string

はい

市場セクター (以下のサポートされているセクターを参照)

top_type

string

はい

"top_etfs", "top_mutual_funds", "top_companies", "top_growth_companies", または "top_performing_companies"

top_n

number

いいえ

返す結果の数 (デフォルト: 10, 最大: 100)

戻り値: 関連指標を含むトップエンティティのJSON配列。

サポートされているセクター

Basic Materials (素材), Communication Services (通信サービス), Consumer Cyclical (一般消費財), Consumer Defensive (生活必需品), Energy (エネルギー), Financial Services (金融サービス), Healthcare (ヘルスケア), Industrials (資本財), Real Estate (不動産), Technology (テクノロジー), Utilities (公益事業)

yfinance_get_price_history

過去の価格データを取得し、オプションでテクニカル分析チャートを生成します。

パラメータ

型

必須

説明

symbol

string

はい

株式ティッカーシンボル

period

string

いいえ

期間 — 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max (デフォルト: 1mo)

interval

string

いいえ

データの粒度 — 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo (デフォルト: 1d)

chart_type

string

いいえ

生成するチャート (表形式データの場合は省略)

チャートタイプ:

値

説明

"price_volume"

出来高バー付きローソク足チャート

"vwap"

出来高加重平均価格オーバーレイ付き価格チャート

"volume_profile"

価格レベル別の出来高分布付きローソク足チャート

戻り値:

  • chart_typeなし: 日付、始値、高値、安値、終値、出来高、配当、株式分割の列を含むMarkdownテーブル。

  • chart_typeあり: トークン効率化のためのBase64エンコードされたWebP画像。

yfinance_get_financials

過去データを含む財務諸表(損益計算書、貸借対照表、キャッシュフロー)を取得します。

パラメータ

型

必須

説明

symbol

string

はい

株式ティッカーシンボル

frequency

string

いいえ

"annual" (年次)、"quarterly" (四半期)、または "ttm" (直近12ヶ月)。デフォルト: "annual"

戻り値: 各報告期間の損益計算書、貸借対照表、キャッシュフローデータを含むJSONオブジェクト。

  • 損益計算書フィールド: EBIT、純利益、法人税等、税引前利益、支払利息、総収益、営業利益、EBITDA、正規化純利益

  • 貸借対照表フィールド: 株主資本、負債合計、現金および現金同等物、投下資本、純負債、資産合計、負債合計(非支配持分控除後)、有形資産純額、有形帳簿価額

  • キャッシュフローフィールド: 営業キャッシュフロー、フリーキャッシュフロー、設備投資、継続事業からの純利益、減価償却費、運転資本の増減、支払配当金

使用方法

uv経由 (推奨)

  1. uvをインストール

  2. MCPクライアント設定に以下を追加します:

{
  "mcpServers": {
    "yfmcp": {
      "command": "uvx",
      "args": ["yfmcp@latest"]
    }
  }
}

Docker経由

{
  "mcpServers": {
    "yfmcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
    }
  }
}

ソースから

  1. リポジトリをクローンし、依存関係をインストールします:

git clone https://github.com/narumiruna/yfinance-mcp.git
cd yfinance-mcp
uv sync
  1. MCPクライアント設定に以下を追加します:

{
  "mcpServers": {
    "yfmcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/yfinance-mcp",
        "yfmcp"
      ]
    }
  }
}

/path/to/yfinance-mcpを、クローンしたリポジトリの実際のパスに置き換えてください。

開発

前提条件

  • Python ≥ 3.12

  • uv パッケージマネージャー

セットアップ

uv sync --extra dev

Lint & Format

uv run ruff check .
uv run ruff format .

型チェック

uv run ty check src tests

テスト

uv run pytest -v -s --cov=src tests

デモチャットボット

専用リポジトリのデモチャットボットをご覧ください: yfinance-mcp-demo

貢献者

contrib.rocksを使用して作成されました。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。

Available Tools

15 tools
yfinance_get_analyst_estimatesB
Read-onlyIdempotent

Fetch consensus estimates, EPS/revenue trends, revisions, recommendations, and earnings history.

Inputs: symbol (required), max_rows, sections. Returns: result

yfinance_get_analyst_price_targetsA
Read-onlyIdempotent

Fetch the current price and analyst consensus price targets for a stock.

Returns a JSON object with the fields supplied by Yahoo Finance:
- current: Current market price
- low: Lowest analyst price target
- high: Highest analyst price target
- mean: Mean analyst price target
- median: Median analyst price target

Analyst coverage and available fields vary by symbol.

Inputs: symbol (required). Returns: result

yfinance_get_financialsA
Read-onlyIdempotent

Fetch financial statements (income statement, balance sheet, and cash flow) with historical data.

Returns JSON with income statement, balance sheet, and cash flow data across reporting periods.

Use the data to analyze trends, calculate ratios, or compare periods.

Inputs: symbol (required), frequency. Returns: result

yfinance_get_fund_dataA
Read-onlyIdempotent

Fetch ETF or mutual-fund composition, holdings, exposures, ratings, and operating details.

Inputs: symbol (required), max_rows, sections. Returns: result

yfinance_get_holdersA
Read-onlyIdempotent

Fetch major holders, institutional holders, mutual fund holders, and insider data.

Returns JSON with:
- major_holders: Aggregated breakdown including insider % held, institutional % held,
  institutional % float held, and institution count.
- institutional_holders: List of institutional investors with shares held, date reported,
  value, and % change.
- mutualfund_holders: List of mutual fund holders with same fields.
- insider_transactions: Recent insider transactions including shares, value, transaction
  type, and date.
- insider_purchases: Summary of insider buy/sell activity over the last 6 months.
- insider_roster: List of known insiders by name and position.

Use this to analyze ownership concentration, insider activity, and institutional interest.

Inputs: symbol (required), max_rows. Returns: result

yfinance_get_option_chainA
Read-onlyIdempotent

Fetch option chain data (calls and puts) for a stock with available strike prices.

Returns JSON with calls and/or puts data for each expiration date.

JSON fields include:
- contractSymbol: Option contract identifier
- strike: Strike price
- lastPrice: Last traded price
- bid/ask: Bid and ask prices
- volume: Trading volume
- openInterest: Open interest
- impliedVolatility: Implied volatility (IV)
- inTheMoney: Whether option is ITM
- contractSize: Contract size (REGULAR)
- currency: Currency (USD)

Use this to analyze options pricing, IV surfaces, and strike levels.

Inputs: symbol (required), option_type, expiration_date. Returns: result

yfinance_get_option_datesA
Read-onlyIdempotent

Fetch available option expiration dates for a stock.

Returns JSON array of expiration dates in YYYY-MM-DD format.

Use these dates with the 'yfinance_get_option_chain' tool to fetch
the options chain for a specific date.

Inputs: symbol (required). Returns: result

yfinance_get_price_historyA
Read-onlyIdempotent

Fetch historical price data and optionally generate technical analysis charts.

When chart_type is None, returns Markdown table with columns:
- Date: Trading date (index)
- Open: Opening price
- High: Highest price
- Low: Lowest price
- Close: Closing price
- Volume: Trading volume
- Dividends: Dividend payments (if any)
- Stock Splits: Split events (if any)

When chart_type is specified, returns a chart image:
- 'price_volume': Candlestick chart with volume bars
- 'vwap': Price with Volume Weighted Average Price overlay
- 'volume_profile': Volume distribution by price level

Set prepost=True to include pre-market and post-market data when available.

Note: Not all period/interval combinations are valid. Minute intervals (1m, 5m, etc.)
only work with short periods (1d, 5d).

Inputs: symbol (required), period, prepost, interval, +1 more. Returns: result

yfinance_get_ticker_infoA
Read-onlyIdempotent

Retrieve comprehensive stock data including company information, financials, trading metrics and governance.

Returns JSON object with fields including:
- Company: symbol, longName, sector, industry, longBusinessSummary, website, city, country
- Price: currentPrice, previousClose, open, dayHigh, dayLow, fiftyTwoWeekHigh, fiftyTwoWeekLow
- Valuation: marketCap, enterpriseValue, trailingPE, forwardPE, priceToBook, pegRatio
- Trading: volume, averageVolume, averageVolume10days, bid, ask, bidSize, askSize
- Dividends: dividendRate, dividendYield, exDividendDate, payoutRatio
- Financials: totalRevenue, revenueGrowth, earningsGrowth, profitMargins, operatingMargins
- Performance: beta, fiftyDayAverage, twoHundredDayAverage, trailingEps, forwardEps

Note: Available fields vary by security type. Timestamps are converted to readable dates.

Inputs: symbol (required). Returns: result

yfinance_get_ticker_newsA
Read-onlyIdempotent

Fetch recent news articles and press releases for a specific stock.

Returns JSON array where each news item has:
- id: Unique article identifier
- content: Object containing:
    - title: Article headline
    - summary: Brief article summary
    - pubDate: Publication date (ISO 8601 format)
    - provider: Object with displayName (e.g., "Yahoo Finance") and url
    - canonicalUrl: Object with article url, site, region, lang
    - thumbnail: Object with image URLs and resolutions
    - contentType: Type of content (e.g., "STORY", "VIDEO")

Use this to track company announcements, market sentiment, and breaking news.

Inputs: symbol (required). Returns: result

yfinance_get_topA
Read-onlyIdempotent

Get top-ranked financial entities within a sector.

This unified tool provides access to various rankings:
- ETFs and mutual funds focused on the sector
- Largest companies by market capitalization
- Fastest-growing companies by revenue/earnings
- Best-performing stocks by price appreciation

Returns JSON data with relevant metrics for each entity type.

Inputs: sector (required), top_type (required), top_n. Returns: result

yfinance_get_upgrades_downgradesB
Read-onlyIdempotent

Fetch analyst upgrades, downgrades, initiations, and price target changes.

Returns analyst actions newest first. Fields supplied by Yahoo Finance can include:
- GradeDate: Date and time of the analyst action
- Firm: Analyst firm name
- ToGrade and FromGrade: New and previous ratings
- Action: Rating action, such as upgrade, downgrade, initiation, or reiteration
- priceTargetAction: Price target action, such as Raises, Lowers, or Maintains
- currentPriceTarget and priorPriceTarget: New and previous price targets

Available fields vary by symbol and analyst action.

Inputs: symbol (required), max_rows. Returns: result

yfinance_screenA
Read-onlyIdempotent

Run a Yahoo Finance screener query.

Supports predefined Yahoo screener keys and custom equity, mutual-fund, or ETF query trees.

Inputs: query (required), size, count, offset, +5 more. Returns: result

yfinance_screen_gappersA
Read-onlyIdempotent

Run a custom equity screener tuned for opening-session stock gappers.

Inputs: size, offset, region, sort_asc, +4 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool targets a distinct data domain: ticker info, analyst data, news, search, screening, price history, financials, options, and holders. Even the closely related analyst and screener tools are clearly separated by their specific outputs and descriptions.

    Naming Consistency4/5

    The tools consistently use the yfinance_ prefix and snake_case, with most following a yfinance_get_* pattern. A few exceptions like yfinance_search, yfinance_screen, and yfinance_screen_gappers break the pattern slightly but remain predictable and readable.

    Tool Count5/5

    At 15 tools, the set is at the upper edge of well-scoped but still appropriate for Yahoo Finance's broad data coverage. Each tool covers a meaningful financial data category without obvious redundancy.

    Completeness5/5

    The surface comprehensively covers the main Yahoo Finance data categories: quotes, financials, price history, options, holders, news, analyst activity, screening, rankings, and fund data. For a read-only financial data server, there are no significant dead ends or missing core operations.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server built with FastMCP framework that provides example tools including message echoing and server information retrieval. Supports both stdio and HTTP transports with Docker deployment capabilities.
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server built with FastMCP framework that provides example tools for echoing messages and retrieving server information. Supports both stdio and HTTP transports with Docker deployment capabilities.
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server with example tools including message echo functionality and server information retrieval. Built with FastMCP framework and supports both stdio and HTTP transports.
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server built with FastMCP framework that provides example tools including message echoing and server information retrieval. Supports both stdio and HTTP transports for integration with various MCP clients.
      -