universal-mcp-applications 0.1.19__py3-none-any.whl → 0.1.20__py3-none-any.whl

universal_mcp/applications/yahoo_finance/README.md

@@ -0,0 +1,17 @@
+# YahooFinanceApp MCP Server
+
+An MCP Server for Yahoo Finance data using the yfinance library.
+
+## 🛠️ Tool List
+
+This provides access to Yahoo Finance data including stock information, historical prices, news, and financial statements.
+
+| Tool | Description |
+|------|-------------|
+| `get_stock_info` | Gets real-time stock information including current price, market cap, financial ratios, and company details. Returns the complete raw data from Yahoo Finance for maximum flexibility. |
+| `get_stock_history` | Gets historical price data for a stock with OHLCV data, dividends, and stock splits. Returns complete DataFrame with all available historical data. |
+| `get_stock_news` | Gets latest news articles for a stock from Yahoo Finance. Returns raw list of news articles. |
+| `get_financial_statements` | Gets financial statements for a stock from Yahoo Finance. Returns dictionary with financial statement data for income, balance, cashflow, or earnings statements. |
+| `get_stock_recommendations` | Gets analyst recommendations for a stock from Yahoo Finance. Returns list of dictionaries with analyst recommendation data or upgrades/downgrades. |
+| `search` | Search Yahoo Finance for quotes, news, and research using yfinance Search. Returns dictionary containing all available search data. |
+| `lookup_ticker` | Look up ticker symbols by type using yfinance Lookup. Returns list of dictionaries with ticker lookup results filtered by security type (stock, etf, mutualfund, etc). | 

universal_mcp/applications/yahoo_finance/__init__.py

@@ -0,0 +1 @@
+from .app import YahooFinanceApp

universal_mcp/applications/yahoo_finance/app.py

@@ -0,0 +1,258 @@
+import yfinance as yf
+from typing import Any
+from universal_mcp.applications.application import APIApplication
+from universal_mcp.integrations import Integration
+
+
+class YahooFinanceApp(APIApplication):
+    """
+    Application for interacting with Yahoo Finance data using yfinance library.
+    Provides tools to retrieve stock information, historical data, news, and financial statements.
+    """
+
+    def __init__(self, integration: Integration | None = None, **kwargs) -> None:
+        super().__init__(name="yahoo_finance", integration=integration, **kwargs)
+
+    def get_stock_info(self, symbol: str) -> dict[str, Any]:
+        """
+        Gets real-time stock information including current price, market cap, financial ratios, and company details.
+        
+        Args:
+            symbol: Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')
+        
+        Returns:
+            Complete dictionary with all available stock data fields from Yahoo Finance
+        
+        Raises:
+            ValueError: Invalid or empty symbol
+            KeyError: Stock symbol not found
+            ConnectionError: Network or API issues
+        
+        Tags:
+            stock, info, real-time, price, financials, company-data, important
+        """
+        if not symbol:
+            raise ValueError("Stock symbol cannot be empty")
+        
+        symbol = symbol.upper().strip()
+        ticker = yf.Ticker(symbol)
+        
+        info = ticker.info
+        if not info or info.get('regularMarketPrice') is None:
+            raise KeyError(f"Stock symbol '{symbol}' not found or invalid")
+        
+        return info
+
+    def get_stock_history(
+        self,
+        symbol: str,
+        period: str = "1mo",
+        interval: str = "1d",
+        start_date: str | None = None,
+        end_date: str | None = None
+    )-> Any:
+        """
+        Gets historical price data for a stock with OHLCV data, dividends, and stock splits.
+        
+        Args:
+            symbol: Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')
+            period: Time period ('1d', '5d', '1mo', '3mo', '6mo', '1y', '2y', '5y', '10y', 'ytd', 'max')
+            interval: Data interval ('1m', '2m', '5m', '15m', '30m', '60m', '90m', '1h', '1d', '5d', '1wk', '1mo', '3mo')
+            start_date: Start date in 'YYYY-MM-DD' format (overrides period)
+            end_date: End date in 'YYYY-MM-DD' format (used with start_date)
+        
+        Returns:
+            Complete DataFrame with Open, High, Low, Close, Volume, Dividends, Stock Splits columns
+        
+        Tags:
+            stock, history, ohlcv, price-data, time-series, important
+        """
+        if not symbol:
+            raise ValueError("Stock symbol cannot be empty")
+        
+        symbol = symbol.upper().strip()
+        ticker = yf.Ticker(symbol)
+        
+        return ticker.history(period=period, interval=interval, start=start_date, end=end_date)
+
+    def get_stock_news(self, symbol: str, limit: int = 10)-> list[Any]:
+        """
+        Gets latest news articles for a stock from Yahoo Finance.
+        
+        Args:
+            symbol: Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')
+            limit: Maximum number of articles to return (1-50). Defaults to 10
+        
+        Returns:
+            Raw list of news articles from Yahoo Finance
+        
+        Tags:
+            stock, news, articles, sentiment, important
+        """
+        if not symbol:
+            raise ValueError("Stock symbol cannot be empty")
+        
+        symbol = symbol.upper().strip()
+        ticker = yf.Ticker(symbol)
+        
+        news = ticker.news
+        return news[:limit] if news else []
+
+    def get_financial_statements(self, symbol: str, statement_type: str = "income") -> dict:
+        """
+        Gets financial statements for a stock from Yahoo Finance.
+        
+        Args:
+            symbol: Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')
+            statement_type: Type of statement ('income', 'balance', 'cashflow', 'earnings'). Defaults to 'income'
+        
+        Returns:
+            Dictionary with financial statement data
+        
+        Tags:
+            stock, financial-statements, earnings, important
+        """
+        if not symbol:
+            raise ValueError("Stock symbol cannot be empty")
+        
+        symbol = symbol.upper().strip()
+        ticker = yf.Ticker(symbol)
+        
+        if statement_type == "income":
+            df = ticker.income_stmt
+        elif statement_type == "balance":
+            df = ticker.balance_sheet
+        elif statement_type == "cashflow":
+            df = ticker.cashflow
+        elif statement_type == "earnings":
+            df = ticker.earnings
+        else:
+            df = ticker.income_stmt
+            
+        try:
+            return df.to_dict('dict')  # type: ignore
+        except:
+            return {}
+
+    def get_stock_recommendations(self, symbol: str, rec_type: str = "recommendations") -> list[dict]:
+        """
+        Gets analyst recommendations for a stock from Yahoo Finance.
+        
+        Args:
+            symbol: Stock ticker symbol (e.g., 'AAPL', 'GOOGL', 'MSFT')
+            rec_type: Type of recommendation data ('recommendations', 'upgrades_downgrades'). Defaults to 'recommendations'
+        
+        Returns:
+            List of dictionaries with analyst recommendation data
+        
+        Tags:
+            stock, recommendations, analyst-ratings, important
+        """
+        if not symbol:
+            raise ValueError("Stock symbol cannot be empty")
+        
+        symbol = symbol.upper().strip()
+        ticker = yf.Ticker(symbol)
+        
+        if rec_type == "upgrades_downgrades":
+            df = ticker.upgrades_downgrades
+        else:
+            df = ticker.recommendations
+            
+        try:
+            return df.to_dict('records')  # type: ignore
+        except:
+            return []
+
+    def search(self, query: str, max_results: int = 10, news_count: int = 5, include_research: bool = False) -> dict[str, Any]:
+        """
+        Search Yahoo Finance for quotes, news, and research using yfinance Search.
+        
+        Args:
+            query: Search query (company name, ticker symbol, or keyword)
+            max_results: Maximum number of quote results to return. Defaults to 10
+            news_count: Number of news articles to return. Defaults to 5
+            include_research: Whether to include research data. Defaults to False
+        
+        Returns:
+            Dictionary containing quotes, news, and optionally research data
+        
+        Tags:
+            search, quotes, news, research, important
+        """
+        if not query:
+            raise ValueError("Search query cannot be empty")
+        
+        search = yf.Search(query, max_results=max_results, news_count=news_count, include_research=include_research)
+        
+        result = {}
+        for attr in dir(search):
+            if not attr.startswith('_'): 
+                try:
+                    value = getattr(search, attr)
+                    if not callable(value):  
+                        result[attr] = value
+                except:
+                    continue
+                    
+        return result
+
+    def lookup_ticker(self, query: str, lookup_type: str = "all", count: int = 25) -> list[dict]:
+        """
+        Look up ticker symbols by type using yfinance Lookup.
+        
+        Args:
+            query: Search query for ticker lookup
+            lookup_type: Type of lookup ('all', 'stock', 'mutualfund', 'etf', 'index', 'future', 'currency', 'cryptocurrency'). Defaults to 'all'
+            count: Maximum number of results to return. Defaults to 25
+        
+        Returns:
+            List of dictionaries with ticker lookup results
+        
+        Tags:
+            lookup, ticker, symbols, important
+        """
+        if not query:
+            raise ValueError("Lookup query cannot be empty")
+        
+        try:
+            lookup = yf.Lookup(query)
+            
+            if lookup_type == "stock":
+                results = lookup.get_stock(count=count)
+            elif lookup_type == "mutualfund":
+                results = lookup.get_mutualfund(count=count)
+            elif lookup_type == "etf":
+                results = lookup.get_etf(count=count)
+            elif lookup_type == "index":
+                results = lookup.get_index(count=count)
+            elif lookup_type == "future":
+                results = lookup.get_future(count=count)
+            elif lookup_type == "currency":
+                results = lookup.get_currency(count=count)
+            elif lookup_type == "cryptocurrency":
+                results = lookup.get_cryptocurrency(count=count)
+            else:  # default to 'all'
+                results = lookup.get_all(count=count)
+            
+            try:
+                return results.to_dict('records')  # type: ignore
+            except:
+                return []
+                
+        except Exception as e:
+            return [{
+                "query": query,
+                "error": f"Lookup failed: {str(e)}"
+            }]
+
+    def list_tools(self):
+        return [
+            self.get_stock_info,
+            self.get_stock_history,
+            self.get_stock_news,
+            self.get_financial_statements,
+            self.get_stock_recommendations,
+            self.search,
+            self.lookup_ticker,
+        ]

{universal_mcp_applications-0.1.19.dist-info → universal_mcp_applications-0.1.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-applications
-Version: 0.1.19
+Version: 0.1.20
 Summary: A Universal MCP Application: universal_mcp_applications
 Project-URL: Homepage, https://github.com/universal-mcp/applications
 Project-URL: Repository, https://github.com/universal-mcp/applications
@@ -35,6 +35,7 @@ Requires-Dist: requests>=2.31.0
 Requires-Dist: resend>=2.10.0
 Requires-Dist: twilio>=9.8.0
 Requires-Dist: universal-mcp>=0.1.24rc21
+Requires-Dist: yfinance>=0.2.66
 Requires-Dist: youtube-transcript-api==1.2.2
 Provides-Extra: dev
 Requires-Dist: pre-commit; extra == 'dev'

{universal_mcp_applications-0.1.19.dist-info → universal_mcp_applications-0.1.20.dist-info}/RECORD

@@ -78,7 +78,7 @@ universal_mcp/applications/firecrawl/__init__.py,sha256=Sl2LuCKsNHoFf-3dGE31CYVG
 universal_mcp/applications/firecrawl/app.py,sha256=dh2G8y5-I4ITxV1vV916P4eaS0VqtMcnihOzHd1cYc4,22024
 universal_mcp/applications/fireflies/README.md,sha256=f6Yak4ys_bxau0n5nEakADderIAZ9vaSrOBR78ETN08,4083
 universal_mcp/applications/fireflies/__init__.py,sha256=SMEk3MeSk6aFzX8GX_NZwcjBvnEeTRQDlA1RZMrwKxA,30
-universal_mcp/applications/fireflies/app.py,sha256=VREgLSsCI0AdUsMK4htajxVUDIKwBWeSeiex3a9jNwY,19022
+universal_mcp/applications/fireflies/app.py,sha256=7hYnCdwd2eObJx7lUQYImhEpkcwTkyM-kKgYCyvkoVI,21610
 universal_mcp/applications/fpl/README.md,sha256=xI0BnOxetc0u2E198v8Zn08vIsupnyAWEjUu0dSLmXg,3930
 universal_mcp/applications/fpl/__init__.py,sha256=m9fC6hJ4EKM1KE12p2XFaUCFZU9p3v-5Nm9KFl-GyIk,24
 universal_mcp/applications/fpl/app.py,sha256=BE7IdfaO11PV9aG8u16M_A_42eCWCl_7tVGMhDo1LzE,55247
@@ -102,9 +102,9 @@ universal_mcp/applications/google_calendar/app.py,sha256=FCdAbTRBM5St4NyUgmjiZWW
 universal_mcp/applications/google_docs/README.md,sha256=KDy_X4SRELegE5sEdixAP0YeXZOXdADTX2D-tAUlCJM,4512
 universal_mcp/applications/google_docs/__init__.py,sha256=U0pWagxnj0VD-AcKNd8eS0orzaMmlUOgvW9vkYBNH40,31
 universal_mcp/applications/google_docs/app.py,sha256=xlnWvAs45FAbYJPU6wD8AqUGWqj7sUhIuUonyH2opKg,33575
-universal_mcp/applications/google_drive/README.md,sha256=69mzpKAiXrMqNIbZ3FL4udqjp9A0U-J3a3fUvyANNU0,15601
+universal_mcp/applications/google_drive/README.md,sha256=Kmg7LLaDW-7bnsgdVimwxc5SdUf2uA9Fv8zIMXVa-Uc,15393
 universal_mcp/applications/google_drive/__init__.py,sha256=DTyed4ADcCmALSyPT8whjXoosPXl3m-i8JrilPJ3ijU,32
-universal_mcp/applications/google_drive/app.py,sha256=u3eyZfV4Dkjj_lYe3vyaCgaPF-UNg8pH0EeLCtZDwmI,258417
+universal_mcp/applications/google_drive/app.py,sha256=TyEVncS5WYaYEqlhWL5F4WjqV2Az7ZXUBEw3QnDd3S4,258970
 universal_mcp/applications/google_gemini/README.md,sha256=MFeJU_xc3vTHdNqGC_dXNRv4ocSDYgHCs82RPXBeEn4,576
 universal_mcp/applications/google_gemini/__init__.py,sha256=KZWdPU74VKBBabLpAcPNEPRPLFk8v2i0ULnT4wVHM9U,33
 universal_mcp/applications/google_gemini/app.py,sha256=pp2T1nuLUy3yAEOWssBssY3Oudj3YG8ofC757QRJQhY,8743
@@ -116,7 +116,7 @@ universal_mcp/applications/google_searchconsole/__init__.py,sha256=PHuwQFk0_a-jb
 universal_mcp/applications/google_searchconsole/app.py,sha256=5fXhgYrFrKs3Mm9IZdCW4ylq2cj8BB1DxWp3a1oMblY,14272
 universal_mcp/applications/google_sheet/README.md,sha256=ZoKzozYSGDl1AxcVgWkJk2i5uLwB17UaUsVYqo9epqs,7772
 universal_mcp/applications/google_sheet/__init__.py,sha256=sl1VQKQMlYuzZGHUIyVsFvnar6APaIFb4Y_nl7TA0us,32
-universal_mcp/applications/google_sheet/app.py,sha256=qdj2k7ZcxKQ5-WDWECOmyb8VeQPrvK_GeS6tOkwUZvE,88464
+universal_mcp/applications/google_sheet/app.py,sha256=OQcjH9-nLopTbKdXf6hh_2oKWzM2hSISvjX7flOb9_A,88333
 universal_mcp/applications/google_sheet/helper.py,sha256=rC_2I4oKfd-rpj3UIWXGH4pZlMX1vI9kixryxBFymSY,11996
 universal_mcp/applications/hashnode/README.md,sha256=O_k8h3w3tVwigqRMSiYCl2XchoBM_p66sPLGFcexNQo,866
 universal_mcp/applications/hashnode/__init__.py,sha256=ty459WmLiNoGM4XZAKWNASp-0MCMBV15J3LstDbZWPw,29
@@ -179,9 +179,6 @@ universal_mcp/applications/posthog/app.py,sha256=-T0hOSxPT3qQEVG8IrRY0MVi0YI8yHH
 universal_mcp/applications/reddit/README.md,sha256=RzGOX8sFJldmLsrjFG1FHmWzL7RddZTylb-m8XjSKQI,6558
 universal_mcp/applications/reddit/__init__.py,sha256=JHA_BMVnuQyoDMbQt5dRNxKPrAxyZZL6zzQyNbvyjHs,27
 universal_mcp/applications/reddit/app.py,sha256=NZWx4cYcCOKzonIr9VrYsq7gYmEk-56QBa2ICG0hGGY,36394
-universal_mcp/applications/replicate/README.md,sha256=S7fDLNM1YpUj6zl_DMHOtYl4Lx88ouPBgbWZnCHvAxk,2387
-universal_mcp/applications/replicate/__init__.py,sha256=W3thUM5OFDKregi9E4EjzrcLY4ya_ZLMQKXAF2fiYV4,30
-universal_mcp/applications/replicate/app.py,sha256=QIHReOEnF3QUkSi0DME1jrBn24WC8r2hVQHtr7SryEo,21836
 universal_mcp/applications/resend/README.md,sha256=zfKzut3KCw9JlX3crspSjRsLZyoN9uly_yZWjWA4LUU,8409
 universal_mcp/applications/resend/__init__.py,sha256=4me7YQFrYTNvqbJawBrsrJlzyFRwXZA6u4E09IPWjlk,27
 universal_mcp/applications/resend/app.py,sha256=uqJYQhSBIfcDMi525muoxAPClr_0VDLpvlja9QPCdoA,35796
@@ -266,13 +263,16 @@ universal_mcp/applications/whatsapp_business/app.py,sha256=QOOil8SX3u6u5GUA-clWr
 universal_mcp/applications/wrike/README.md,sha256=S8wwVcYjwtNGLOFmUuyEfBz5xwGRnKULczbpR_wek-M,4718
 universal_mcp/applications/wrike/__init__.py,sha256=GCsgH0nXcCbF4TfkPK46XOS0LI6EQQtOgr2NIwHAGKw,26
 universal_mcp/applications/wrike/app.py,sha256=qc1ZfeIQyVr3AaMhKVV-nuz2fvrCJbDdgfcN0K_leFU,63638
+universal_mcp/applications/yahoo_finance/README.md,sha256=Pc_yxW2LFtkggzDxLNuwR7zpVhN9OalSG7ytRhrYO7w,1497
+universal_mcp/applications/yahoo_finance/__init__.py,sha256=ySX-_1nfnbrpeeUwkQG7ZJSz8_Fvu47T0I3wRhyEpIk,33
+universal_mcp/applications/yahoo_finance/app.py,sha256=ZmlgcIle0V8njCQf8d_Hm-JqW_Ixhp8f9HG5qigohXA,9424
 universal_mcp/applications/youtube/README.md,sha256=iK7wyIJrgA_Ai9GWdqMIsuIBQEr7srt5s_RiDeSDuU0,13502
 universal_mcp/applications/youtube/__init__.py,sha256=HuPQYpxmH_duCaVBXIE_fm-XzSIcqMjpn066tpUkKhQ,28
 universal_mcp/applications/youtube/app.py,sha256=t2nrMMq3Yl98gvPgqwAOjRH834ZJfEMj7_KhQ7SgxaA,76464
 universal_mcp/applications/zenquotes/README.md,sha256=FJyoTGRCaZjF_bsCBqg1CrYcvIfuUG_Qk616G1wjhF8,512
 universal_mcp/applications/zenquotes/__init__.py,sha256=IkASLYaZiHJXlkGwEMk1HgIq5GwEZp5GhAIiJyjBd3g,30
 universal_mcp/applications/zenquotes/app.py,sha256=S88JEoVFsyqow-56zcYPgRzhcz59AG_L_RdTFqtSwdA,1323
-universal_mcp_applications-0.1.19.dist-info/METADATA,sha256=jU9SX72X92CHcgjHEfIF4IWddaeBczhWAcuZBOntXPw,2886
-universal_mcp_applications-0.1.19.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-universal_mcp_applications-0.1.19.dist-info/licenses/LICENSE,sha256=NweDZVPslBAZFzlgByF158b85GR0f5_tLQgq1NS48To,1063
-universal_mcp_applications-0.1.19.dist-info/RECORD,,
+universal_mcp_applications-0.1.20.dist-info/METADATA,sha256=QRt8-3ntVGKJQaHGswLeOzElisGIfZpQymkuYKFEyE8,2918
+universal_mcp_applications-0.1.20.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+universal_mcp_applications-0.1.20.dist-info/licenses/LICENSE,sha256=NweDZVPslBAZFzlgByF158b85GR0f5_tLQgq1NS48To,1063
+universal_mcp_applications-0.1.20.dist-info/RECORD,,

universal_mcp/applications/replicate/README.md

@@ -1,18 +0,0 @@
-# ReplicateApp MCP Server
-
-An MCP Server for the ReplicateApp API.
-
-## 🛠️ Tool List
-
-This is automatically generated from OpenAPI schema for the ReplicateApp API.
-
-
-| Tool | Description |
-|------|-------------|
-| `run` | Executes a Replicate model synchronously, blocking until it completes and returns the final output. This abstracts the polling logic required by asynchronous jobs. If a model streams results, this function conveniently collects all items into a list before returning, unlike the non-blocking `submit_prediction` method. |
-| `submit_prediction` | Submits a model execution request to Replicate for non-blocking, asynchronous processing. It immediately returns a prediction ID for tracking, unlike the synchronous `run` method which waits for the final result. The returned ID can be used with `get_prediction` or `fetch_prediction_output` to monitor the job. |
-| `get_prediction` | Retrieves the full details and current state of a Replicate prediction by its ID. This function performs a non-blocking status check, returning the prediction object immediately. Unlike `fetch_prediction_output`, it does not wait for the job to complete and is used for monitoring progress. |
-| `await_prediction_result` | Retrieves the final output for a given prediction ID, waiting for the job to complete if it is still running. This function complements `submit_prediction` by blocking until the asynchronous task finishes, raising an error if the prediction fails or is canceled. |
-| `cancel_prediction` | Sends a request to cancel a running or queued Replicate prediction. It first checks the prediction's status, only proceeding if it is not already in a terminal state (e.g., succeeded, failed), and gracefully handles jobs that cannot be canceled. |
-| `upload_file` | Uploads a local file from a given path to Replicate's storage, returning a public URL. This URL is essential for providing file-based inputs to Replicate models via functions like `run` or `submit_prediction`. Fails if the file is not found or the upload encounters an error. |
-| `generate_image` | Generates images synchronously using a specified model, defaulting to SDXL. As a convenience wrapper around the generic `run` function, it simplifies image creation by exposing common parameters like `prompt` and `width`, and waits for the model to complete before returning the resulting image URLs. |

universal_mcp/applications/replicate/__init__.py

@@ -1 +0,0 @@
-from .app import ReplicateApp