narumiruna avatar

Yahoo Finance

narumiruna/yfinance-mcp

Wraps the yfinance Python library to give Claude direct access to Yahoo Finance data through six focused tools. Pull comprehensive stock info, recent news, and historical OHLCV data for any ticker. Search across Yahoo Finance's database of stocks and ETFs. Get sector rankings for top performers, growth companies, and funds. Generate professional candlestick charts with VWAP overlays and volume profiles returned as WebP images. Install via uvx for immediate access to real-time financial data without API keys or rate limits.

GitHub stars
208
tools
12
transport
STDIO
last updated
Aug 16, 2026

Tools

12 tools

Public tool metadata for what this MCP can expose to an agent.

yfinance_get_ticker_infoRetrieve comprehensive stock data including company info, financials, trading metrics, and governance data.

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

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

yfinance_get_analyst_estimatesFetch analyst consensus estimates, revision momentum, recommendations, growth estimates, and earnings history.

Fetch analyst consensus estimates, revision momentum, recommendations, growth estimates, and earnings history.

No parameter schema in public metadata yet.

yfinance_get_upgrades_downgradesFetch analyst upgrades, downgrades, initiations, reiterations, and price-target changes, newest first.

Fetch analyst upgrades, downgrades, initiations, reiterations, and price-target changes, newest first.

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

yfinance_searchSearch Yahoo Finance for stocks, ETFs, and news articles.

Search Yahoo Finance for stocks, ETFs, and news articles.

No parameter schema in public metadata yet.

yfinance_get_topGet top-ranked financial entities within a market sector.

Get top-ranked financial entities within a market sector.

No parameter schema in public metadata yet.

yfinance_screenRun Yahoo Finance screeners using either predefined screener keys or custom query trees.

Run Yahoo Finance screeners using either predefined screener keys or custom query trees.

No parameter schema in public metadata yet.

yfinance_screen_gappersRun a purpose-built custom screener for opening-session bullish gappers.

Run a purpose-built custom screener for opening-session bullish gappers.

No parameter schema in public metadata yet.

yfinance_get_price_historyFetch historical price data and optionally generate technical analysis charts.

Fetch historical price data and optionally generate technical analysis charts.

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

Sponsors

Readme

Yahoo Finance MCP Server

PyPI version Python CI License: MIT

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


View the full README on GitHub

Details

Repository
github.com/narumiruna/yfinance-mcp
Website
github.com/narumiruna/yfinance-mcp
Category
Data & Analytics
Package
yfmcp
Transport
STDIO
Registry
MCP registry, active

Related Data & Analytics MCP servers

View all
1zwldarren avatarZwldarren Akshare One Mcpzwldarren/akshare-one-mcpProvide access to Chinese stock market data including historical prices, real-time data, news, and…192stars
2jagan-shanmugam avatarOpenStreetMapjagan-shanmugam/open-streetmap-mcpAn OpenStreetMap MCP server implementation that enhances LLM capabilities with location-based services and geospatial data.191stars
3bonninr avatarFreeCADbonninr/freecad_mcpProvides programmatic access to FreeCAD data and script execution via an MCP server.183stars
4egebese avatarSEO Researchegebese/seo-research-mcpProvides SEO data (backlinks, keywords, traffic, and difficulty) via MCP integration with Ahrefs data sources.180stars
5faucetdb avatarFaucetfaucetdb/faucetSQL database to MCP tools and REST API: PostgreSQL, MySQL, SQL Server, Oracle, SQLite, Snowflake.170stars
6alphavantage avatarAlpha Vantage Mcpalphavantage/alpha_vantage_mcpReal-time financial market data: stocks, forex, crypto, commodities, and economic indicators168stars