Каталог MCP
narumiruna/yfinance-mcp

narumiruna/yfinance-mcp

MCP сервер Yahoo Finance открывает AI-ассистентам доступ к биржевым данным: котировки, финансовая отчетность, новости, опционы и графики. Помогает финансовым аналитикам и разработчикам интегрироват...

README

15 инструментов

Версии

Установить сервер

Yahoo Finance MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to Yahoo Finance data via yfinance. Query stock information, financial news, sector rankings, and generate professional financial charts — all from your AI chat.

Features

Stock Data — Company info, financials, valuation metrics, dividends, and trading data
Financial Statements — Income statement and balance sheet with historical data (EBIT, Invested Capital, etc.)
Financial News — Recent news articles and press releases for any ticker
Search — Find stocks, ETFs, and news across Yahoo Finance
Sector Rankings — Top ETFs, mutual funds, companies, growth leaders, and top performers by sector
Price History — Historical OHLCV data as markdown tables or professional charts
Chart Generation — Candlestick, VWAP, and volume profile charts returned as WebP images
Options Data — Option chains with calls, puts, strike prices, IV, and expiration dates
Ownership Data — Major holders, institutional investors, mutual fund holders, and insider transactions

Инструменты были проиндексированы: 11.09.2026

yfinance_get_analyst_estimatesтолько чтениеидемпотентныйвнешний мир

Получает консенсус-прогнозы, тренды по EPS/выручке, пересмотры, рекомендации и историю прибыли.

Параметры

max_rowsinteger
Maximum rows per section. Use 0 to return all rows.
sectionsstring[] | null
Optional analyst sections: recommendations, earnings_estimate, revenue_estimate, eps_trend, eps_revisions, earnings_history, and growth_estimates. Omit to return all sections.
symbolstringобязательный
Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_analyst_price_targetsтолько чтениеидемпотентныйвнешний мир

Получает текущую цену и консенсус-прогнозы аналитиков для акции. Возвращает объект JSON с полями, предоставляемыми Yahoo Finance: - current: текущая рыночная цена - low: минимальный целевой уровень цены от аналитиков - high: максимальный целевой уровень цены от аналитиков - mean: средний целевой уровень цены от аналитиков - median: медианный целевой уровень цены от аналитиков Покрытие аналитиками и доступные поля различаются в зависимости от тикера.

Параметры

symbolstringобязательный
Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_financialsтолько чтениеидемпотентныйвнешний мир

Получает финансовые отчёты (отчёт о прибылях и убытках, баланс и отчёт о движении денежных средств) с историческими данными. Возвращает JSON с данными отчёта о прибылях и убытках, баланса и отчёта о движении денежных средств за несколько отчётных периодов. Используйте эти данные, чтобы анализировать динамику, рассчитывать коэффициенты или сравнивать периоды.

Параметры

frequencystring
Reporting frequency: 'annual' for yearly, 'quarterly' for quarterly, or 'ttm' for trailing twelve months
symbolstringобязательный
Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_fund_dataтолько чтениеидемпотентныйвнешний мир

Получает состав, портфельные активы, экспозиции, рейтинги и операционные детали ETF или взаимного фонда.

Параметры

max_rowsinteger
Maximum rows per tabular section. Use 0 to return all rows.
sectionsstring[] | null
Optional fund sections: description, fund_overview, fund_operations, asset_classes, top_holdings, equity_holdings, bond_holdings, bond_ratings, and sector_weightings. Omit to return all sections.
symbolstringобязательный
ETF or mutual fund ticker symbol (e.g., 'SPY', 'BND', 'VFIAX')

yfinance_get_holdersтолько чтениеидемпотентныйвнешний мир

Возвращает основных держателей, институциональных держателей, держателей взаимных фондов и данные инсайдеров. Возвращает JSON с: - major_holders: Агрегированная разбивка: процент инсайдеров, процент институционалов, процент институционалов от free float и количество институтов. - institutional_holders: Список институциональных инвесторов с количеством акций, датой отчёта, стоимостью и % изменения. - mutualfund_holders: Список держателей взаимных фондов с теми же полями. - insider_transactions: Последние инсайдерские сделки: количество акций, стоимость, тип сделки и дата. - insider_purchases: Сводка покупок/продаж инсайдеров за последние 6 месяцев. - insider_roster: Список известных инсайдеров по имени и должности. Используйте для анализа концентрации собственности, активности инсайдеров и интереса институционалов.

Параметры

max_rowsinteger
Maximum rows returned per holder section. Use 0 to return all rows.
symbolstringобязательный
Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_option_chainтолько чтениеидемпотентныйвнешний мир

Получает данные опционной цепочки (коллов и путов) для акции с доступными ценами страйков. Возвращает JSON с данными по коллам и/или путам для каждой даты экспирации. Поля JSON включают: - contractSymbol: Идентификатор опционного контракта - strike: Цена страйка - lastPrice: Последняя цена сделки - bid/ask: Цены спроса и предложения - volume: Объём торгов - openInterest: Открытый интерес - impliedVolatility: Подразумеваемая волатильность (IV) - inTheMoney: Опцион в деньгах (ITM) - contractSize: Размер контракта (REGULAR) - currency: Валюта (USD) Используйте это для анализа цен опционов, поверхностей IV и уровней страйков.

Параметры

expiration_datestring | null
Option expiration date in YYYY-MM-DD format. Use the 'yfinance_get_option_dates' tool to find available dates, or omit to fetch all available expiration dates.
option_typeenum
Which options to return: 'calls', 'puts', or 'all' (both calls and puts).
symbolstringобязательный
Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_option_datesтолько чтениеидемпотентныйвнешний мир

Запрашивает доступные даты истечения опционов для акции. Возвращает массив JSON с датами истечения в формате ГГГГ-ММ-ДД. Используйте эти даты с инструментом 'yfinance_get_option_chain', чтобы получить цепочку опционов на конкретную дату.

Параметры

symbolstringобязательный
Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_price_historyтолько чтениеидемпотентныйвнешний мир

Получает исторические данные о ценах и опционально генерирует графики технического анализа. Когда chart_type равен None, возвращает Markdown-таблицу со столбцами: - Дата: Торговая дата (индекс) - Цена открытия: Цена открытия - Максимум: Максимальная цена - Минимум: Минимальная цена - Цена закрытия: Цена закрытия - Объём: Объём торгов - Дивиденды: Выплаты дивидендов (если есть) - Сплиты акций: События дробления акций (если есть) Когда задан chart_type, возвращает изображение графика: - 'price_volume': Свечной график с гистограммой объёмов - 'vwap': Цена с наложением средневзвешенной по объёму цены - 'volume_profile': Распределение объёма по ценовым уровням Установите prepost=True, чтобы включить данные до начала и после окончания основной торговой сессии, если они доступны. Примечание: Не все комбинации периода и интервала допустимы. Минутные интервалы (1m, 5m и т.д.) работают только с короткими периодами (1d, 5d).

Параметры

chart_typeenum | null
Optional visualization: 'price_volume' (candlestick chart with volume bars), 'vwap' (Volume Weighted Average Price overlay), 'volume_profile' (volume distribution by price level). Omit for tabular data
intervalenum
Data granularity: '1m'/'5m'/'15m'/'30m' (minutes), '1h' (hour), '1d'/'5d' (days), '1wk' (week), '1mo'/'3mo' (months). Short intervals require short periods (e.g., '1m' interval only works with '1d'/'5d' period)
periodenum
Time range: '1d'/'5d' (days), '1mo'/'3mo'/'6mo' (months), '1y'/'2y'/'5y'/'10y' (years), 'ytd' (year-to-date), 'max' (all available data)
prepostboolean
Include pre-market and post-market data when available
symbolstringобязательный
Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_ticker_infoтолько чтениеидемпотентныйвнешний мир

Получает полные данные по акциям, включая информацию о компании, финансовые показатели, торговые метрики и корпоративное управление. Возвращает JSON-объект со следующими полями: - Компания: symbol, longName, sector, industry, longBusinessSummary, website, city, country - Цена: currentPrice, previousClose, open, dayHigh, dayLow, fiftyTwoWeekHigh, fiftyTwoWeekLow - Оценка: marketCap, enterpriseValue, trailingPE, forwardPE, priceToBook, pegRatio - Торговля: volume, averageVolume, averageVolume10days, bid, ask, bidSize, askSize - Дивиденды: dividendRate, dividendYield, exDividendDate, payoutRatio - Финансы: totalRevenue, revenueGrowth, earningsGrowth, profitMargins, operatingMargins - Производительность: beta, fiftyDayAverage, twoHundredDayAverage, trailingEps, forwardEps Примечание: доступные поля различаются в зависимости от типа ценной бумаги. Временные метки преобразуются в читаемые даты.

Параметры

symbolstringобязательный
Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_ticker_newsтолько чтениеидемпотентныйвнешний мир

Получает свежие новостные статьи и пресс-релизы для конкретной акции. Возвращает JSON-массив, где каждый элемент новости содержит: - id: Уникальный идентификатор статьи - content: Объект со следующими полями: - title: Заголовок статьи - summary: Краткое описание статьи - pubDate: Дата публикации (формат ISO 8601) - provider: Объект с полями displayName (например, "Yahoo Finance") и url - canonicalUrl: Объект с url статьи, site, region, lang - thumbnail: Объект с URL изображений и разрешениями - contentType: Тип контента (например, "STORY", "VIDEO") Используйте этот инструмент, чтобы отслеживать корпоративные объявления, рыночные настроения и актуальные новости.

Параметры

symbolstringобязательный
Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_topтолько чтениеидемпотентныйвнешний мир

Получает топ финансовых сущностей в секторе. Этот универсальный инструмент объединяет несколько рейтингов: - ETF и взаимные фонды, ориентированные на сектор - Крупнейшие компании по рыночной капитализации - Быстрорастущие компании по выручке/прибыли - Лучшие акции по росту котировок Возвращает JSON-данные с метриками для каждого типа сущностей.

Параметры

sectorenumобязательный
Market sector (e.g., 'Technology', 'Healthcare', 'Financial Services')
top_ninteger
Number of top entities to retrieve per category/industry
top_typeenumобязательный
Type of entities to retrieve: 'top_etfs' (sector ETFs), 'top_mutual_funds' (sector mutual funds), 'top_companies' (largest by market cap), 'top_growth_companies' (fastest revenue/earnings growth), 'top_performing_companies' (best stock price performance)

yfinance_get_upgrades_downgradesтолько чтениеидемпотентныйвнешний мир

Получает апгрейды, даунгрейды, инициации и изменения целевых цен от аналитиков. Возвращает действия аналитиков, начиная с самых новых. Поля, которые предоставляет Yahoo Finance, могут включать: - GradeDate: дата и время действия аналитика - Firm: название аналитической фирмы - ToGrade и FromGrade: новый и предыдущий рейтинги - Action: рейтинговое действие, например апгрейд, даунгрейд, инициация или подтверждение - priceTargetAction: действие с целевой ценой, например Повышение, Понижение или Сохранение - currentPriceTarget и priorPriceTarget: новая и предыдущая целевые цены Доступные поля различаются в зависимости от символа и действия аналитика.

Параметры

max_rowsinteger
Maximum analyst actions to return, newest first. Use 0 to return all rows.
symbolstringобязательный
Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')

yfinance_screenтолько чтениеидемпотентныйвнешний мир

Запустить поиск по фильтру Yahoo Finance. Поддерживает предопределённые ключи фильтра Yahoo и пользовательские деревья запросов по акциям или фондам.

Параметры

countinteger | null
Rows to return for predefined queries. Yahoo maximum is 250.
offsetinteger | null
Result offset.
querystring | objectобязательный
Screener query. For query_type='predefined': string key like 'day_gainers'. For query_type='equity', 'fund', or 'etf': query tree object with {operator, operands} nodes.
query_typeenum
Query mode: 'predefined', 'equity', 'fund', or 'etf'.
sizeinteger | null
Rows to return for custom queries. Yahoo maximum is 250.
sort_ascboolean | null
Sort ascending if true, descending if false.
sort_fieldstring | null
Sort field, for example 'percentchange'.
user_idstring | null
Optional Yahoo user id.
user_id_typestring | null
Optional Yahoo user id type, commonly 'guid'.

yfinance_screen_gappersтолько чтениеидемпотентныйвнешний мир

Запускает пользовательский скринер акций, настроенный на акции, открывающиеся с гэпом.

Параметры

min_market_capinteger
Minimum intraday market cap in USD.
min_percent_changenumber
Minimum percent change from prior close, for example 3.0 for +3%.
min_pricenumber
Minimum current intraday price.
min_volumeinteger
Minimum intraday trading volume.
offsetinteger
Result offset for pagination.
regionstring
Yahoo screener region code, for example 'us'.
sizeinteger
Rows to return. Yahoo maximum is 250.
sort_ascboolean
Sort by percentchange ascending if true, descending if false.

yfinance_searchтолько чтениеидемпотентныйвнешний мир

Ищет акции, ETF и новости через Yahoo Finance. Возвращает JSON с результатами поиска в зависимости от search_type: - 'quotes': Массив ценных бумаг с полями: - symbol: Тикер - shortname/longname: Название компании - quoteType: Тип ценной бумаги (EQUITY, ETF, MUTUALFUND и т.д.) - exchange: Код биржи - sector: Сектор экономики - industry: Отрасль - score: Оценка релевантности поиска - 'news': Массив статей с полями: - uuid: Идентификатор статьи - title: Заголовок - publisher: Источник новости - link: Ссылка на статью - providerPublishTime: Время публикации в формате Unix timestamp - relatedTickers: Массив связанных тикеров - thumbnail: URL изображений - 'all': Объект с массивами 'quotes' и 'news' Используйте этот инструмент, чтобы найти тикеры, обнаружить связанные ценные бумаги или искать финансовые новости.

Параметры

querystringобязательный
Search query - company name, ticker symbol, or keywords
search_typeenumобязательный
Filter results: 'all' (quotes + news), 'quotes' (stocks/ETFs only), or 'news' (articles only)

Github Сайт сервера

Конфиг для установки сервера

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

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

FAQ

Для чего этот сервер?

Этот MCP-сервер подключает AI-ассистентов к данным Yahoo Finance — котировкам, новостям, отчётам и графикам. Вместо того чтобы вручную искать информацию по акциям или секторам, пользователь просто спрашивает AI, и тот сам запрашивает свежие данные через сервер. Экономит время на аналитику и скрининг рынка.

Что он умеет?

Сервер читает биржевую информацию по акциям и фондам: данные компаний, финансовые отчеты, состав ETF и взаимных фондов. Ищет бумаги, ETF и новости по запросу, выдает топы по секторам и запускает скринеры, включая поиск гэпов. Строит графики цен, свечи, VWAP и профиль объема. Показывает опционные цепочки с датами экспирации, аналитические апгрейды и даунгрейды, целевые цены и консенсус-прогнозы. Отдает сведения о крупных держателях и инсайдерских сделках.