Skip to main content
Glama
Yahoo Finance MCP Server

Yahoo Finance MCP Server

by narumiruna

Yahoo Finance MCP 서버

PyPI version Python CI License: MIT

yfinance를 통해 AI 어시스턴트가 Yahoo Finance 데이터에 접근할 수 있도록 하는 Model Context Protocol (MCP) 서버입니다. AI 채팅에서 바로 주식 정보, 금융 뉴스, 섹터 순위를 조회하고 전문적인 금융 차트를 생성하세요.

기능

  • 주식 데이터 — 기업 정보, 재무, 가치 평가 지표, 배당금 및 거래 데이터

  • 재무제표 — 과거 데이터를 포함한 손익계산서 및 대차대조표 (EBIT, 투하자본 등)

  • 금융 뉴스 — 특정 티커에 대한 최근 뉴스 기사 및 보도 자료

  • 검색 — Yahoo Finance 전반의 주식, ETF 및 뉴스 검색

  • 섹터 순위 — 섹터별 상위 ETF, 뮤추얼 펀드, 기업, 성장주 및 우수 실적 기업

  • 가격 이력 — 마크다운 표 또는 전문 차트 형태의 과거 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"

거래량 가중 평균 가격(VWAP) 오버레이가 포함된 가격 차트

"volume_profile"

가격 수준별 거래량 분포가 포함된 캔들스틱 차트

반환값:

  • chart_type이 없는 경우: 날짜, 시가, 고가, 저가, 종가, 거래량, 배당금 및 주식 분할 열이 포함된 마크다운 표.

  • 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

린트 및 포맷

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