yfinance

yfinance

Stock price server powered by Yahoo Finance, integrated with MCP for real-time data and analysis.

36
Stars
16
Forks
0
Releases

Overview

This MCP server sets up a stock price server powered by the Yahoo Finance (YFinance) API and is built for seamless integration with MCP (Model Control Protocol). It enables AI agents or clients to retrieve real-time stock data, manage a watchlist, perform full stock analysis, and run comprehensive technical indicators. The server supports watchlists, real-time-ish price updates, technical summaries, a full-featured dashboard, and trend plus momentum indicators, all aimed at helping dashboards and AI agents deliver informed analyses. It exposes tools via MCP such as add_to_watchlist, get_stock_price, analyze_stock, get_technical_summary, get_watchlist_prices, get_trend_analysis, get_volatility_analysis, and compare_stocks. Step-by-step setup uses uv to manage the Python environment, followed by uv run main.py to start the server. The MCP Server Inspector provides an interactive UI to view tools and test inputs/outputs. The README also includes an example mcp.config.json entry to register the server, and guidance to restart interfaces like Claude Desktop to reload the MCP configuration. Overall, it empowers intelligent financial applications with reliable stock data and analytics.

Details

Owner
Adity-star
Language
Python
License
MIT License
Updated
2025-12-07

Features

add_to_watchlist

Add a stock ticker to your personal watchlist.

analyze_stock

Perform a 1-month technical trend analysis (RSI, MACD, MAs).

get_technical_summary

Generate a comprehensive technical summary including indicators & signals.

get_watchlist_prices

Fetch the most recent prices for all watchlisted tickers.

get_trend_analysis

Analyze recent trend shifts, patterns, and divergences.

get_stock_price

Retrieve the current price for a given ticker symbol.

get_volatility_analysis

Calculate historical volatility and ATR metrics.

compare_stocks

Compare two stock prices to assess relative performance.

Audience

ai agentsPowering stock-focused autonomous agents with real-time data and analyses.
dashboard developersIntegrate stock data into dashboards with real-time updates and indicators.
investorsUse watchlists, prices, and technical analytics for trading decisions.
researchersAnalyze volatility, trends, and relative stock performance.

Tags

stockyfinancemcpwatchlistreal-timetechnical-analysisvolatilityindicatorsdashboardai-agents