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

universal_mcp/applications/twitter/app.py

@@ -1,17 +1,17 @@
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
-from .api_segments.compliance_api import ComplianceApi
-from .api_segments.dm_conversations_api import DmConversationsApi
-from .api_segments.dm_events_api import DmEventsApi
-from .api_segments.likes_api import LikesApi
-from .api_segments.lists_api import ListsApi
-from .api_segments.openapi_json_api import OpenapiJsonApi
-from .api_segments.spaces_api import SpacesApi
-from .api_segments.trends_api import TrendsApi
-from .api_segments.tweets_api import TweetsApi
-from .api_segments.usage_api import UsageApi
-from .api_segments.users_api import UsersApi
+from universal_mcp.applications.twitter.api_segments.compliance_api import ComplianceApi
+from universal_mcp.applications.twitter.api_segments.dm_conversations_api import DmConversationsApi
+from universal_mcp.applications.twitter.api_segments.dm_events_api import DmEventsApi
+from universal_mcp.applications.twitter.api_segments.likes_api import LikesApi
+from universal_mcp.applications.twitter.api_segments.lists_api import ListsApi
+from universal_mcp.applications.twitter.api_segments.openapi_json_api import OpenapiJsonApi
+from universal_mcp.applications.twitter.api_segments.spaces_api import SpacesApi
+from universal_mcp.applications.twitter.api_segments.trends_api import TrendsApi
+from universal_mcp.applications.twitter.api_segments.tweets_api import TweetsApi
+from universal_mcp.applications.twitter.api_segments.usage_api import UsageApi
+from universal_mcp.applications.twitter.api_segments.users_api import UsersApi
 
 
 class TwitterApp(APIApplication):

universal_mcp/applications/unipile/README.md

@@ -9,20 +9,20 @@ This is automatically generated from OpenAPI schema for the UnipileApp API.
 
 | Tool | Description |
 |------|-------------|
-| `list_all_chats` | Lists all chats, with options to filter by unread status, pagination, date ranges, and account. |
-| `list_chat_messages` | Lists all messages from a specific chat, with pagination and filtering options. |
-| `send_chat_message` | Sends a message in a specific chat. |
-| `retrieve_chat` | Retrieves a specific chat by its Unipile or provider ID. |
-| `list_all_messages` | Lists all messages across all chats, with pagination and filtering options. |
-| `list_all_accounts` | Lists all linked accounts. |
-| `retrieve_account` | Retrieves a specific linked account by its ID. |
-| `list_user_posts` | Lists all posts for a given user or company identifier. |
-| `retrieve_own_profile` | Retrieves the profile of the user associated with the given Unipile account_id. |
-| `retrieve_profile` | Retrieves a specific user profile by its identifier. |
-| `retrieve_post` | Retrieves a specific post by its ID. |
-| `list_post_comments` | Lists all comments from a specific post. Can also list replies to a specific comment. |
-| `create_post` | Creates a new post on LinkedIn. |
-| `list_post_reactions` | Lists all reactions from a specific post or comment. |
-| `create_post_comment` | Adds a comment to a specific post. |
-| `add_reaction_to_post` | Adds a reaction to a post or comment. |
-| `search` | Performs a comprehensive search on LinkedIn for people, companies, posts, or jobs. |
+| `list_all_chats` | Retrieves a paginated list of all chat conversations across linked accounts. Supports filtering by unread status, date range, account provider, and specific account IDs, distinguishing it from functions listing messages within a single chat. |
+| `list_chat_messages` | Retrieves messages from a specific chat identified by `chat_id`. Supports pagination and filtering by date or sender. Unlike `list_all_messages`, which fetches from all chats, this function targets the contents of a single conversation. |
+| `send_chat_message` | Sends a text message to a specific chat conversation using its `chat_id`. This function creates a new message via a POST request, distinguishing it from read-only functions like `list_chat_messages`. It returns the API's response, which typically confirms the successful creation of the message. |
+| `retrieve_chat` | Retrieves a single chat's details using its Unipile or provider-specific ID. Requires an `account_id` when using a provider ID for context. This function is distinct from `list_all_chats`, which returns a collection, by targeting one specific conversation. |
+| `list_all_messages` | Retrieves a paginated list of messages from all chats associated with the account(s). Unlike `list_chat_messages` which targets a specific conversation, this function provides a global message view, filterable by sender, account, and date range. |
+| `list_all_accounts` | Retrieves a paginated list of all social media accounts linked to the Unipile service. This is crucial for obtaining the `account_id` required by other methods to specify which user account should perform an action, like sending a message or retrieving user-specific posts. |
+| `retrieve_linked_account` | Retrieves details for a specific account linked to Unipile using its ID. It fetches metadata about the connection itself (e.g., a linked LinkedIn account), differentiating it from `retrieve_user_profile` which fetches a user's profile from the external platform. |
+| `list_profile_posts` | Retrieves a paginated list of posts from a specific user or company profile using their provider ID. An authorizing `account_id` is required, and the `is_company` flag must specify the entity type, distinguishing this from `retrieve_post` which fetches a single post by its own ID. |
+| `retrieve_own_profile` | Retrieves the profile details for the user associated with the specified Unipile account ID. This function targets the API's 'me' endpoint to fetch the authenticated user's profile, distinct from `retrieve_user_profile` which fetches profiles of other users by their public identifier. |
+| `retrieve_user_profile` | Retrieves a specific LinkedIn user's profile using their public or internal ID, authorized via the provided `account_id`. Unlike `retrieve_own_profile`, which fetches the authenticated user's details, this function targets and returns data for any specified third-party user profile on the platform. |
+| `retrieve_post` | Fetches a specific post's details by its unique ID, requiring an `account_id` for authorization. Unlike `list_profile_posts`, which retrieves a collection of posts from a user or company profile, this function targets one specific post and returns its full object. |
+| `list_post_comments` | Fetches comments for a specific post using an `account_id` for authorization. Providing an optional `comment_id` retrieves threaded replies instead of top-level comments. This read-only operation contrasts with `create_post_comment`, which publishes new comments, and `list_content_reactions`, which retrieves 'likes'. |
+| `create_post` | Publishes a new top-level post from a specified account, including text, user mentions, and an external link. This function creates original content, distinguishing it from `create_post_comment` which adds replies to existing posts. |
+| `list_content_reactions` | Retrieves a paginated list of reactions for a given post or, optionally, a specific comment. This read-only operation uses the provided `account_id` for the request, distinguishing it from the `create_reaction` function which adds new reactions. |
+| `create_post_comment` | Publishes a comment on a specified post. By providing an optional `comment_id`, it creates a threaded reply to an existing comment instead of a new top-level one. This function's dual capability distinguishes it from `list_post_comments`, which only retrieves comments and their replies. |
+| `create_reaction` | Adds a specified reaction (e.g., 'like', 'love') to a LinkedIn post or, optionally, to a specific comment. This function performs a POST request to create the reaction, differentiating it from `list_content_reactions` which only retrieves existing ones. |
+| `search` | Performs a comprehensive LinkedIn search for people, companies, posts, or jobs using granular filters like keywords and location. Alternatively, it can execute a search from a direct LinkedIn URL. Supports pagination and targets either the classic or Sales Navigator API. |

universal_mcp/applications/whatsapp/README.md

@@ -9,15 +9,15 @@ This is automatically generated from OpenAPI schema for the WhatsappApp API.
 
 | Tool | Description |
 |------|-------------|
-| `search_contacts` | Search WhatsApp contacts by name or phone number. |
-| `list_messages` | Get WhatsApp messages matching specified criteria with optional context. |
-| `list_chats` | Get WhatsApp chats matching specified criteria. |
-| `get_chat` | Get WhatsApp chat metadata by JID. |
-| `get_direct_chat_by_contact` | Get WhatsApp chat metadata by sender phone number. |
-| `get_contact_chats` | Get all WhatsApp chats involving the contact. |
-| `get_last_interaction` | Get most recent WhatsApp message involving the contact. |
-| `get_message_context` | Get context around a specific WhatsApp message. |
-| `send_message` | Send a WhatsApp message to a person or group. For group chats use the JID. |
-| `send_file` | Send a file such as a picture, raw audio, video or document via WhatsApp to the specified recipient. For group messages use the JID. |
-| `send_audio_message` | Send any audio file as a WhatsApp audio message to the specified recipient. For group messages use the JID. If it errors due to ffmpeg not being installed, use send_file instead. |
-| `download_media` | Download media from a WhatsApp message and get the local file path. |
+| `search_contacts` | Searches for WhatsApp contacts by name or phone number. This function takes a query string, handles user authentication, and calls the underlying API to find and return a list of matching contacts. It serves as the primary method to look up contact information within the application. |
+| `search_messages` | Searches for and retrieves a paginated list of WhatsApp messages using various filters like date, sender, chat, or content query. It can optionally include surrounding contextual messages for each result, unlike `get_message_context` which targets a single message ID. |
+| `search_chats` | Retrieves a paginated list of WhatsApp chats, allowing filtering by a search query and sorting by activity or name. Unlike `get_chat`, which fetches a single known chat, this function provides broad search and discovery capabilities across multiple user conversations. |
+| `get_chat_by_jid` | Retrieves metadata for a specific WhatsApp chat (direct or group) using its unique JID. It can optionally include the most recent message. This precise JID-based lookup distinguishes it from `get_direct_chat_by_contact`, which uses a phone number, and `list_chats`, which performs a broader search. |
+| `get_direct_chat_by_phone_number` | Retrieves metadata for a direct (one-on-one) WhatsApp chat using a contact's phone number. Unlike `get_chat` which requires a JID, this provides a simpler way to find direct conversations. Returns a dictionary containing the chat's details, such as its JID and name. |
+| `list_chats_by_contact_jid` | Retrieves a paginated list of all WhatsApp chats, including direct messages and groups, that a specific contact participates in. The contact is identified by their unique JID. This differs from `get_direct_chat_by_contact` which only finds one-on-one chats. |
+| `get_last_message_by_jid` | Retrieves the content of the most recent message involving a specific contact, identified by their JID. It authenticates the user and returns the message directly as a string, offering a quick way to view the last communication without fetching full message objects or chat histories. |
+| `get_message_context` | Fetches the conversational context surrounding a specific WhatsApp message ID. It retrieves a configurable number of messages immediately preceding and following the target message. This provides a focused view of a dialogue, unlike `list_messages` which performs broader, filter-based searches. |
+| `send_text_message` | Authenticates the user and sends a text message to a specified WhatsApp recipient. The recipient can be an individual (via phone number) or a group (via JID). It returns a dictionary indicating the operation's success status and a corresponding message. |
+| `send_attachment` | Sends a media file (image, video, document, raw audio) as a standard attachment to a WhatsApp contact or group using their phone number or JID. Unlike `send_audio_message`, which creates a playable voice note, this function handles general file transfers. Returns a success status dictionary. |
+| `send_voice_message` | Sends a local audio file as a playable WhatsApp voice message, converting it to the required format. Unlike `send_file` which sends audio as a document attachment, this function formats the audio as a voice note. It can be sent to an individual contact or a group chat. |
+| `download_media_from_message` | Downloads media from a specific WhatsApp message, identified by its ID and chat JID. It saves the content to a local file and returns the file's path upon success. The function automatically handles user authentication before initiating the download. |

universal_mcp/applications/whatsapp/app.py

@@ -1,43 +1,43 @@
 from typing import Any
 
 import requests
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     WHATSAPP_API_BASE_URL,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     download_media as whatsapp_download_media,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     get_chat as whatsapp_get_chat,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     get_contact_chats as whatsapp_get_contact_chats,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     get_direct_chat_by_contact as whatsapp_get_direct_chat_by_contact,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     get_last_interaction as whatsapp_get_last_interaction,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     get_message_context as whatsapp_get_message_context,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     list_chats as whatsapp_list_chats,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     list_messages as whatsapp_list_messages,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     search_contacts as whatsapp_search_contacts,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     send_audio_message as whatsapp_audio_voice_message,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     send_file as whatsapp_send_file,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     send_message as whatsapp_send_message,
 )
 

universal_mcp/applications/whatsapp_business/README.md

@@ -9,26 +9,26 @@ This is automatically generated from OpenAPI schema for the WhatsappBusinessApp
 
 | Tool | Description |
 |------|-------------|
-| `get_analytics` | Retrieves details of a specified WhatsApp Business Account (WABA) with customizable fields using the GET method. |
-| `get_credit_lines` | Retrieves the extended credit lines available for a specified business account using its ID. |
-| `get_business_account` | Retrieves information about a business account using the specified API version and business account ID, optionally filtering the response fields via a query parameter. |
-| `get_commerce_settings` | Retrieves the commerce settings configured for a specific WhatsApp Business phone number. |
-| `set_or_update_commerce_settings` | Updates WhatsApp Business commerce settings (cart availability and catalog visibility) for a specific business phone number. |
-| `upload_file` | Uploads a file using the specified API version and application ID, with optional query parameters for file length and type, and returns a successful status message upon completion. |
-| `resume_session` | Initiates a session using the provided SESSION_ID and file offset specified in the header, supporting further session-related operations via the POST method at the "/{api-version}/<SESSION_ID>" endpoint. |
-| `get_business_phone_number` | Retrieves details for a specific business phone number ID using query parameters to specify returned fields. |
-| `get_all_business_phone_numbers` | Retrieves a list of phone numbers associated with a specific WhatsApp Business Account (WABA), allowing for filtering and customization of the response fields. |
-| `get_qr_code` | Retrieves a message linked to a specific QR code for a business phone number using the GET method via the API. |
-| `delete_qr_code` | Deletes a specific WhatsApp Business QR code using the provided QR code ID and returns a success message if the operation is completed successfully. |
-| `get_all_qr_codes_default_fields` | Retrieves a list of message QR code deep links associated with a business phone number, filtered by specified fields and QR code identifiers. |
-| `create_qr_code` | Creates a WhatsApp Business QR code with a predefined message and returns the generated code details. |
-| `get_template_by_id_default_fields` | Retrieves a template using the specified template ID from the API version path. |
-| `edit_template` | Creates or processes a resource using the specified template ID based on the API version and returns a successful status upon completion. |
-| `get_template_by_name_default_fields` | Retrieves a list of WhatsApp message templates associated with a specific WhatsApp Business Account using the "GET" method, allowing filtering by template name. |
-| `create_message_template` | Creates a new WhatsApp message template for a business account, allowing businesses to send standardized messages to customers. |
-| `delete_template_by_name` | Deletes WhatsApp message templates by name (all languages) or specific ID using query parameters and returns a success status. |
-| `get_subscribed_apps` | Retrieves a list of apps subscribed to webhooks for a WhatsApp Business Account using the GET method. |
-| `subscribe_app_to_waba_swebhooks` | Subscribes an app to webhooks for a WhatsApp Business Account (WABA) using the POST method at the `/subscribed_apps` endpoint, allowing the app to receive updates and notifications from the WABA. |
-| `unsubscribe_apps_by_waba_id` | Unsubscribes an app from webhook notifications for a WhatsApp Business Account. |
-| `get_all_shared_wabas` | Retrieves information about WhatsApp Business accounts associated with a business client, using the specified business account ID and API version. |
-| `get_all_owned_wabas` | Retrieves a list of WhatsApp Business Accounts owned by or shared with the specified business account using a GET request to the given endpoint. |
+| `get_whatsapp_business_account` | Fetches customizable data, primarily analytics, for a specific WhatsApp Business Account (WABA) using its ID. The `fields` parameter allows detailed queries, including date ranges and granularity for metrics like message volume, to refine the returned data. |
+| `get_business_account_credit_lines` | Retrieves the extended credit lines for a specified business account ID. This function fetches billing information by querying the `/extendedcredits` endpoint, returning financial details such as available credit for platform services. |
+| `get_business_account` | Fetches details for a specific Meta Business Account using its ID. This function retrieves the core account object, unlike others that get associated resources like owned/shared WhatsApp Business Accounts (WABAs) or credit lines for the same ID. The response payload can be customized using the 'fields' parameter. |
+| `get_commerce_settings` | Retrieves the commerce settings, such as cart availability and catalog visibility, for a specific WhatsApp Business phone number. This function reads the current configuration, contrasting with `set_or_update_commerce_settings` which modifies them. |
+| `update_commerce_settings` | Updates the commerce settings for a specific business phone number by enabling or disabling cart functionality and catalog visibility. This function differentiates from `get_commerce_settings` by using a POST request to modify data, rather than retrieving it. |
+| `create_upload_session` | Initiates a resumable upload session by providing file metadata (size, type). This function creates an upload session ID and is the first of a two-step process for uploading media, preceding the actual data transfer performed by `resume_session`. |
+| `upload_file_to_session` | Continues a media file upload by sending file data to an existing session. This function is the second step in the upload process, following `upload_file`, which creates the session and provides the required session ID. |
+| `get_business_phone_number` | Retrieves details for a specific WhatsApp Business phone number by its unique ID. The optional `fields` parameter allows for customizing the response to include only desired data, differentiating it from `get_all_business_phone_numbers`, which retrieves a list of all numbers for a WABA. |
+| `list_waba_phone_numbers` | Fetches a list of phone numbers for a specified WhatsApp Business Account (WABA). This function allows for result filtering and customizable field selection, distinguishing it from `get_business_phone_number` which retrieves a single number by its unique ID. |
+| `get_qr_code_by_id` | Retrieves the details of a single QR code, such as its pre-filled message, by its unique ID for a specific business phone number. It fetches a specific code, distinguishing it from `get_all_qr_codes_default_fields` which retrieves a list of codes. |
+| `delete_qr_code_by_id` | Deletes a specific WhatsApp message QR code by its ID for a given business phone number. The function sends a DELETE request to the Graph API's `message_qrdls` endpoint to remove the specified QR code. |
+| `list_qr_codes` | Retrieves a list of QR codes for a business phone number. This function allows optional filtering by a specific QR code identifier and customization of the fields returned in the response, such as the image format. |
+| `create_qr_code` | Generates a WhatsApp Business QR code for a specific phone number. This function allows setting a prefilled message for user convenience and can optionally include a custom identifier. It returns the details of the newly created QR code upon successful generation. |
+| `get_template_by_id` | Retrieves a specific WhatsApp message template by its unique identifier. Unlike `get_template_by_name`, which searches within a business account, this function directly fetches a single template resource. Note: The function signature is missing the required `template_id` parameter to build a valid URL. |
+| `update_template_by_id` | Updates an existing WhatsApp message template, identified by its ID within the request URL. This function modifies the template's category, components, language, and name by submitting new data via a POST request, returning the API response upon successful completion. |
+| `get_message_templates` | Retrieves message templates for a specific WhatsApp Business Account (WABA). It can list all templates or, if a name is provided, filter for an exact match. This differs from `get_template_by_id_default_fields`, which fetches a single template by its unique ID. |
+| `create_message_template` | Creates a new message template for a specified WhatsApp Business Account (WABA). This function sends a POST request with the template's name, language, category, and structural components, enabling the creation of standardized, reusable messages. |
+| `delete_message_template` | Deletes a message template from a WhatsApp Business Account. Templates can be targeted for deletion by providing either a template name, which deletes all language versions, or a specific template ID (`hsm_id`). |
+| `get_subscribed_apps` | Retrieves a list of all applications subscribed to receive webhook notifications for a given WhatsApp Business Account (WABA). This function provides a read-only view of current webhook subscriptions, complementing the functions for subscribing and unsubscribing apps. |
+| `subscribe_app_to_webhooks` | Subscribes an application to a specific WhatsApp Business Account's (WABA) webhooks using its ID. This enables the app to receive real-time event notifications, differentiating it from functions that list or remove subscriptions. |
+| `unsubscribe_app_from_waba` | Removes the webhook subscription for the calling app from a specified WhatsApp Business Account (WABA), stopping it from receiving notifications. This function complements `get_subscribed_apps` and `subscribe_app_to_waba_swebhooks` by handling the deletion of a subscription. |
+| `get_all_client_wabas` | Retrieves all client WhatsApp Business Accounts (WABAs) associated with a specific business account ID. It's used by Solution Partners to list WABAs they manage for other businesses, distinguishing them from accounts they directly own (`get_all_owned_wabas`). |
+| `get_all_owned_wabas` | Retrieves a list of all WhatsApp Business Accounts (WABAs) directly owned by a specified business account. This is distinct from `get_all_shared_wabas`, which fetches WABAs shared with clients, providing specific access to owned assets instead of associated ones. |

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,
+        ]