Yahoo Finance MCP Server
MCP-сервер Yahoo Finance
Сервер Model Context Protocol (MCP), который предоставляет ИИ-ассистентам доступ к данным Yahoo Finance через yfinance. Запрашивайте биржевую информацию, финансовые новости, рейтинги секторов и создавайте профессиональные финансовые графики — всё прямо из вашего ИИ-чата.
Возможности
Биржевые данные — информация о компании, финансовые показатели, метрики оценки, дивиденды и торговые данные
Финансовая отчетность — отчет о прибылях и убытках и бухгалтерский баланс с историческими данными (EBIT, инвестированный капитал и т. д.)
Финансовые новости — последние новостные статьи и пресс-релизы для любого тикера
Поиск — поиск акций, ETF и новостей на Yahoo Finance
Рейтинги секторов — лучшие ETF, взаимные фонды, компании, лидеры роста и наиболее эффективные компании по секторам
История цен — исторические данные OHLCV в виде таблиц Markdown или профессиональных графиков
Создание графиков — свечные графики, VWAP и профиль объема, возвращаемые в виде изображений WebP
Related MCP server: DuckDuckGo MCP Server
Инструменты
yfinance_get_ticker_info
Получение исчерпывающих биржевых данных, включая информацию о компании, финансовые показатели, торговые метрики и данные об управлении.
Параметр | Тип | Обязательный | Описание |
| string | Да | Тикер акции (например, |
Возвращает: JSON-объект с деталями компании, ценовыми данными, метриками оценки, торговой информацией, дивидендами, финансовыми показателями и индикаторами эффективности.
yfinance_get_ticker_news
Получение последних новостных статей и пресс-релизов для конкретной акции.
Параметр | Тип | Обязательный | Описание |
| string | Да | Тикер акции |
Возвращает: JSON-массив новостных элементов с заголовком, кратким содержанием, датой публикации, источником, URL и миниатюрой.
yfinance_search
Поиск акций, ETF и новостных статей на Yahoo Finance.
Параметр | Тип | Обязательный | Описание |
| string | Да | Поисковый запрос — название компании, тикер или ключевые слова |
| string | Да |
|
Возвращает: Соответствующие котировки и/или результаты новостей в зависимости от search_type.
yfinance_get_top
Получение списка лучших финансовых организаций в рамках рыночного сектора.
Параметр | Тип | Обязательный | Описание |
| string | Да | Рыночный сектор (см. поддерживаемые сектора ниже) |
| string | Да |
|
| number | Нет | Количество возвращаемых результатов (по умолчанию: |
Возвращает: JSON-массив лучших организаций с соответствующими метриками.
Поддерживаемые сектора
Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, Utilities
yfinance_get_price_history
Получение исторических ценовых данных и (опционально) создание графиков технического анализа.
Параметр | Тип | Обязательный | Описание |
| string | Да | Тикер акции |
| string | Нет | Временной диапазон — |
| string | Нет | Гранулярность данных — |
| string | Нет | График для создания (пропустите для табличных данных) |
Типы графиков:
Значение | Описание |
| Свечной график с полосами объема |
| Ценовой график с наложением средневзвешенной по объему цены |
| Свечной график с распределением объема по ценовым уровням |
Возвращает:
Без
chart_type: Таблица Markdown со столбцами Date, Open, High, Low, Close, Volume, Dividends и Stock Splits.С
chart_type: Изображение WebP в кодировке Base64 для эффективного использования токенов.
yfinance_get_financials
Получение финансовой отчетности (отчет о прибылях и убытках, бухгалтерский баланс и отчет о движении денежных средств) с историческими данными.
Параметр | Тип | Обязательный | Описание |
| string | Да | Тикер акции |
| string | Нет |
|
Возвращает: JSON-объект с данными отчета о прибылях и убытках, бухгалтерского баланса и движения денежных средств для каждого отчетного периода.
Поля отчета о прибылях и убытках: EBIT, чистая прибыль, резерв на уплату налогов, прибыль до налогообложения, процентные расходы, общая выручка, операционная прибыль, EBITDA, нормализованная прибыль
Поля бухгалтерского баланса: Собственный капитал, общий долг, денежные средства и их эквиваленты, инвестированный капитал, чистый долг, общие активы, общие обязательства за вычетом доли меньшинства, чистые материальные активы, материальная балансовая стоимость
Поля отчета о движении денежных средств: Операционный денежный поток, свободный денежный поток, капитальные затраты, чистая прибыль от продолжающейся деятельности, амортизация, изменение оборотного капитала, выплаченные денежные дивиденды
Использование
Через uv (рекомендуется)
Добавьте следующее в конфигурацию вашего MCP-клиента:
{
"mcpServers": {
"yfmcp": {
"command": "uvx",
"args": ["yfmcp@latest"]
}
}
}Через Docker
{
"mcpServers": {
"yfmcp": {
"command": "docker",
"args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
}
}
}Из исходного кода
Клонируйте репозиторий и установите зависимости:
git clone https://github.com/narumiruna/yfinance-mcp.git
cd yfinance-mcp
uv syncДобавьте следующее в конфигурацию вашего 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 toolsyfinance_get_analyst_estimatesBRead-onlyIdempotent
Fetch consensus estimates, EPS/revenue trends, revisions, recommendations, and earnings history.
Inputs: symbol (required), max_rows, sections. Returns: result
yfinance_get_analyst_price_targetsARead-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_financialsARead-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_dataARead-onlyIdempotent
Fetch ETF or mutual-fund composition, holdings, exposures, ratings, and operating details.
Inputs: symbol (required), max_rows, sections. Returns: result
yfinance_get_holdersARead-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_chainARead-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_datesARead-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_historyARead-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_infoARead-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_newsARead-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_topARead-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_downgradesBRead-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_screenARead-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_gappersARead-onlyIdempotent
Run a custom equity screener tuned for opening-session stock gappers.
Inputs: size, offset, region, sort_asc, +4 more. Returns: result
yfinance_searchARead-onlyIdempotent
Search Yahoo Finance for stocks, ETFs, and news articles.
Returns JSON with search results based on search_type:
- 'quotes': Array of securities with:
- symbol: Ticker symbol
- shortname/longname: Company name
- quoteType: Security type (EQUITY, ETF, MUTUALFUND, etc.)
- exchange: Exchange code
- sector: Business sector
- industry: Industry classification
- score: Search relevance score
- 'news': Array of articles with:
- uuid: Article identifier
- title: Headline
- publisher: News source
- link: Article URL
- providerPublishTime: Unix timestamp
- relatedTickers: Array of related symbols
- thumbnail: Image URLs
- 'all': Object with both 'quotes' and 'news' arrays
Use this to find ticker symbols, discover related securities, or search financial news.
Inputs: query (required), search_type (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for Financial Modeling Prep API with 250+ financial data tools
MCP server for stocksense-ai documentation, generated by doc2mcp.
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
A simple MCP server built with FastMCP and python
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceA 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.-
- -licenseNot gradedqualityNot gradedmaintenanceA 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.-
- -licenseNot gradedqualityNot gradedmaintenanceA 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.-
- -licenseNot gradedqualityNot gradedmaintenanceA 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.-