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

universal_mcp/applications/scraper/app.py

@@ -1,13 +1,16 @@
 import os
 from dotenv import load_dotenv
+
 load_dotenv()
 
 from typing import Any
 
 from universal_mcp.applications.application import APIApplication
-from universal_mcp.agentr.integration import AgentrIntegration
 from universal_mcp.applications.unipile import UnipileApp
 from typing import Any, Optional
+from universal_mcp.integrations import Integration
+from loguru import logger
+
 
 class ScraperApp(APIApplication):
     """
@@ -15,7 +18,7 @@ class ScraperApp(APIApplication):
     Provides a simplified interface for LinkedIn search operations.
     """
 
-    def __init__(self, **kwargs: Any) -> None:
+    def __init__(self, integration: Integration, **kwargs: Any) -> None:
         """
         Initialize the ScraperApp.
 
@@ -24,17 +27,16 @@ class ScraperApp(APIApplication):
                          It is expected that the integration provides the necessary credentials
                          for LinkedIn API access.
         """
-        super().__init__(name="scraper", **kwargs)
+        super().__init__(name="scraper", integration=integration, **kwargs)
         if self.integration:
             credentials = self.integration.get_credentials()
-            api_key = credentials.get("SCRAPER_API")
-            self.account_id = credentials.get("ACCOUNT_ID")
-            self.integration = AgentrIntegration(name="unipile", api_key=api_key, base_url="https://staging-agentr-306776579029.asia-southeast1.run.app/")
+            self.account_id = credentials.get("account_id")
             self._unipile_app = UnipileApp(integration=self.integration)
         else:
+            logger.warning(f"Integration not found")
             self.account_id = None
             self._unipile_app = None
-        
+
     def linkedin_post_search(
         self,
         category: str = "posts",
@@ -48,7 +50,7 @@ class ScraperApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Performs a general LinkedIn search for posts using keywords and filters like date and content type. It supports pagination and can utilize either the 'classic' or 'sales_navigator' API, searching broadly across the platform rather than fetching posts from a specific user's profile.
-        
+
         Args:
             category: Type of search to perform (defaults to "posts").
             api: Which LinkedIn API to use - "classic" or "sales_navigator".
@@ -58,17 +60,17 @@ class ScraperApp(APIApplication):
             sort_by: How to sort the results, e.g., "relevance" or "date".
             date_posted: Filter posts by when they were posted.
             content_type: Filter by the type of content in the post. Example: "videos", "images", "live_videos", "collaborative_articles", "documents"
-        
+
         Returns:
             A dictionary containing search results and pagination details.
-        
+
         Raises:
             httpx.HTTPError: If the API request fails.
-        
+
         Tags:
             linkedin, search, posts, api, scrapper, important
         """
-        
+
         return self._unipile_app.search(
             account_id=self.account_id,
             category=category,
@@ -89,22 +91,22 @@ class ScraperApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches a paginated list of all LinkedIn posts from a specific user or company profile using their unique identifier. This function retrieves content directly from a profile, unlike `linkedin_post_search` which finds posts across LinkedIn based on keywords and other filters.
-        
+
         Args:
             identifier: The entity's provider internal ID (LinkedIn ID).starts with ACo for users, while for companies it's a series of numbers.
             cursor: Pagination cursor for the next page of entries.
             limit: Number of items to return (1-100, though spec allows up to 250).
-        
+
         Returns:
             A dictionary containing a list of post objects and pagination details.
-        
+
         Raises:
             httpx.HTTPError: If the API request fails.
-        
+
         Tags:
             linkedin, post, list, user_posts, company_posts, content, api, important
         """
-        
+
         return self._unipile_app.list_profile_posts(
             identifier=identifier,
             account_id=self.account_id,
@@ -118,27 +120,26 @@ class ScraperApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves a specific LinkedIn user's profile by their unique identifier, which can be an internal provider ID or a public username. This function simplifies data access by delegating the actual profile retrieval request to the integrated Unipile application, distinct from functions that list posts or comments.
-        
+
         Args:
             identifier: Can be the provider's internal id OR the provider's public id of the requested user.
                        For example, for https://www.linkedin.com/in/manojbajaj95/, the identifier is "manojbajaj95".
-        
+
         Returns:
             A dictionary containing the user's profile details.
-        
+
         Raises:
             httpx.HTTPError: If the API request fails.
-        
+
         Tags:
             linkedin, user, profile, retrieve, get, api, important
         """
-        
+
         return self._unipile_app.retrieve_user_profile(
             identifier=identifier,
             account_id=self.account_id,
         )
 
- 
     def linkedin_list_post_comments(
         self,
         post_id: str,
@@ -148,23 +149,23 @@ class ScraperApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches comments for a specified LinkedIn post. If a `comment_id` is provided, it retrieves replies to that comment instead of top-level comments. This function supports pagination and specifically targets comments, unlike others in the class that search for or list entire posts.
-        
+
         Args:
             post_id: The social ID of the post. Example rn:li:activity:7342082869034393600
             comment_id: If provided, retrieves replies to this comment ID instead of top-level comments.
             cursor: Pagination cursor.
             limit: Number of comments to return.
-        
+
         Returns:
             A dictionary containing a list of comment objects and pagination details.
-        
+
         Raises:
             httpx.HTTPError: If the API request fails.
-        
+
         Tags:
             linkedin, post, comment, list, content, api, important
         """
-        
+
         return self._unipile_app.list_post_comments(
             post_id=post_id,
             account_id=self.account_id,
@@ -173,11 +174,10 @@ class ScraperApp(APIApplication):
             limit=limit,
         )
 
-    
     def list_tools(self):
         """
         Returns a list of available tools/functions in this application.
-        
+
         Returns:
             A list of functions that can be used as tools.
         """
@@ -186,4 +186,4 @@ class ScraperApp(APIApplication):
             self.linkedin_list_profile_posts,
             self.linkedin_retrieve_profile,
             self.linkedin_list_post_comments,
-            ]
+        ]

universal_mcp/applications/semrush/README.md

@@ -42,3 +42,6 @@ This is automatically generated from OpenAPI schema for the SemrushApp API.
 | `referring_domains` | Get domains pointing to the queried domain, root domain, or URL. |
 | `referring_domains_by_country` | Get referring domain distribution by country based on IP addresses. |
 | `related_keywords` | Get extended list of related keywords, synonyms, and variations relevant to a queried term. |
+| `tlds_distribution` | Get referring domain distribution by top-level domain (e.g., .com, .org, .net). |
+| `url_organic_search_keywords` | Get keywords that bring users to a URL via Google's top 100 organic search results. |
+| `url_paid_search_keywords` | Get keywords that bring users to a URL via Google's paid search results. |

universal_mcp/applications/serpapi/README.md

@@ -9,6 +9,6 @@ This is automatically generated from OpenAPI schema for the SerpapiApp API.
 
 | Tool | Description |
 |------|-------------|
-| `search` | Performs a search using the SerpApi service and returns formatted search results. |
-| `google_maps_search` | Performs a Google Maps search using the SerpApi service and returns formatted search results. |
-| `get_google_maps_reviews` | Retrieves Google Maps reviews for a specific place using the SerpApi service. |
+| `web_search` | Performs a general web search via SerpApi, defaulting to the 'google_light' engine. It accepts custom parameters, retrieves organic results, and formats them into a string with titles, links, and snippets. It also handles API authentication and raises `NotAuthorizedError` for credential-related issues. |
+| `google_maps_search` | Executes a Google Maps search via SerpApi using a query, coordinates, or place ID. It enhances the results by adding a `google_maps_url` to each location, distinguishing it from `get_google_maps_reviews` which retrieves reviews for a known place. |
+| `get_google_maps_reviews` | Fetches Google Maps reviews for a specific location via SerpApi using its unique `data_id`. This function uses the `google_maps_reviews` engine, unlike `google_maps_search` which finds locations. Results can be returned in a specified language, defaulting to English. |

universal_mcp/applications/sharepoint/README.md

@@ -0,0 +1,17 @@
+# SharepointApp MCP Server
+
+An MCP Server for the SharepointApp API.
+
+## 🛠️ Tool List
+
+This is automatically generated from OpenAPI schema for the SharepointApp API.
+
+
+| Tool | Description |
+|------|-------------|
+| `list_folders` | Retrieves a list of immediate subfolder names within a specified SharePoint directory. If no path is provided, it defaults to the root drive. This function is distinct from `list_files`, as it exclusively lists directories, not files. |
+| `create_folder_and_list` | Creates a new folder with a given name inside a specified parent directory (or the root). It then returns an updated list of all folder names within that same directory, effectively confirming that the creation operation was successful. |
+| `list_files` | Retrieves metadata for all files in a specified folder. For each file, it returns key details like name, URL, size, and timestamps. This function exclusively lists file properties, distinguishing it from `list_folders` (which lists directories) and `get_document_content` (which retrieves file content). |
+| `upload_text_file` | Uploads string content to create a new file in a specified SharePoint folder. To confirm the operation, it returns an updated list of all files and their metadata from that directory, including the newly created file. |
+| `get_document_content` | Retrieves a file's content from a specified SharePoint path. It returns a dictionary containing the file's name and size, decoding text files as a string and Base64-encoding binary files. Unlike `list_files`, which only fetches metadata, this function provides the actual file content. |
+| `delete_document` | Permanently deletes a specified file from a SharePoint drive using its full path. This is the sole destructive file operation, contrasting with functions that read or create files. It returns `True` on successful deletion and raises an exception on failure, such as if the file is not found. |

universal_mcp/applications/sharepoint/app.py

@@ -36,7 +36,7 @@ class SharepointApp(BaseApplication):
     @property
     def client(self):
         """
-        A lazy-loaded property that gets or creates an authenticated GraphClient instance. On its first call, it uses integration credentials to initialize the client, fetches the user's profile and root site ID, and caches the instance for subsequent use. This ensures efficient connection management.
+        A lazy-loaded property that gets or creates an authenticated GraphClient instance. On first access, it uses integration credentials to initialize the client, fetches initial user and site data, and caches the instance for subsequent use, ensuring efficient connection management for all SharePoint operations.
         
         Returns:
             GraphClient: The authenticated GraphClient instance.
@@ -74,7 +74,7 @@ class SharepointApp(BaseApplication):
 
     def list_folders(self, folder_path: str | None = None) -> list[dict[str, Any]]:
         """
-        Retrieves the names of all immediate subfolders within a specified directory. If a path is not provided, it defaults to listing folders in the root of the user's drive. This function is distinct from `list_documents`, which lists files.
+        Retrieves a list of immediate subfolder names within a specified SharePoint directory. If no path is provided, it defaults to the root drive. This function is distinct from `list_files`, as it exclusively lists directories, not files.
         
         Args:
             folder_path (Optional[str], optional): The path to the parent folder. If None, lists folders in the root.
@@ -97,7 +97,7 @@ class SharepointApp(BaseApplication):
         self, folder_name: str, folder_path: str | None = None
     ) -> dict[str, Any]:
         """
-        Creates a new folder with a given name inside a specified parent directory on SharePoint. If no path is provided, the folder is created in the root. It then returns an updated list of all folder names within that parent directory.
+        Creates a new folder with a given name inside a specified parent directory (or the root). It then returns an updated list of all folder names within that same directory, effectively confirming that the creation operation was successful.
         
         Args:
             folder_name (str): The name of the folder to create.
@@ -118,7 +118,7 @@ class SharepointApp(BaseApplication):
 
     def list_files(self, folder_path: str) -> list[dict[str, Any]]:
         """
-        Retrieves files from a specified folder path. For each file, it returns a dictionary containing key metadata like its name, URL, size, creation date, and last modified date. This function specifically lists files, distinct from `list_folders` which only lists directories.
+        Retrieves metadata for all files in a specified folder. For each file, it returns key details like name, URL, size, and timestamps. This function exclusively lists file properties, distinguishing it from `list_folders` (which lists directories) and `get_document_content` (which retrieves file content).
         
         Args:
             folder_path (str): The path to the folder whose documents are to be listed.
@@ -147,7 +147,7 @@ class SharepointApp(BaseApplication):
         self, file_path: str, file_name: str, content: str
     ) -> dict[str, Any]:
         """
-        Uploads string content to a new file within a specified SharePoint folder path. After creation, it returns an updated list of all documents and their metadata residing in that folder, effectively confirming the file was added successfully.
+        Uploads string content to create a new file in a specified SharePoint folder. To confirm the operation, it returns an updated list of all files and their metadata from that directory, including the newly created file.
         
         Args:
             file_path (str): The path to the folder where the document will be created.
@@ -167,7 +167,7 @@ class SharepointApp(BaseApplication):
 
     def get_document_content(self, file_path: str) -> dict[str, Any]:
         """
-        Retrieves a document's content from SharePoint. It returns a dictionary with the content, name, and size. Content is decoded as a string for text files or Base64-encoded for binary files. This is distinct from `list_documents` which only returns metadata without content.
+        Retrieves a file's content from a specified SharePoint path. It returns a dictionary containing the file's name and size, decoding text files as a string and Base64-encoding binary files. Unlike `list_files`, which only fetches metadata, this function provides the actual file content.
         
         Args:
             file_path (str): The path to the document.
@@ -200,7 +200,7 @@ class SharepointApp(BaseApplication):
 
     def delete_document(self, file_path: str):
         """
-        Permanently deletes a specified file from SharePoint/OneDrive. The function takes the file path as an argument and returns True upon successful deletion. An exception is raised if the file is not found or the deletion fails.
+        Permanently deletes a specified file from a SharePoint drive using its full path. This is the sole destructive file operation, contrasting with functions that read or create files. It returns `True` on successful deletion and raises an exception on failure, such as if the file is not found.
         
         Args:
             file_path (str): The path to the file to delete.

universal_mcp/applications/shortcut/README.md

@@ -1,10 +1,10 @@
-# Shortcut MCP Server
+# ShortcutApp MCP Server
 
-An MCP Server for the Shortcut API.
+An MCP Server for the ShortcutApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Shortcut API.
+This is automatically generated from OpenAPI schema for the ShortcutApp API.
 
 
 | Tool | Description |

universal_mcp/applications/slack/README.md

@@ -0,0 +1,23 @@
+# SlackApp MCP Server
+
+An MCP Server for the SlackApp API.
+
+## 🛠️ Tool List
+
+This is automatically generated from OpenAPI schema for the SlackApp API.
+
+
+| Tool | Description |
+|------|-------------|
+| `chat_delete` | Deletes a specific message from a Slack channel. It identifies the message using its channel ID and timestamp (`ts`). This function is distinct from `chat_update` which modifies a message, and `chat_post_message` which sends a new one. |
+| `chat_post_message` | Posts a new message to a specified Slack channel. It supports rich content formats like text, attachments, and blocks, along with options for threading and authorship. This function creates new messages, unlike `chat_update` which modifies existing ones or `chat_delete` which removes them. |
+| `chat_update` | Updates a specific, existing message in a Slack channel, identified by its timestamp. It modifies content such as text, blocks, or attachments by calling the `chat.update` API endpoint, distinguishing it from functions that create (`chat_post_message`) or delete (`chat_delete`) messages. |
+| `conversations_history` | Fetches the message history for a specific Slack conversation or channel. Supports filtering messages by timestamp and pagination using a cursor. This method retrieves messages *within* a conversation, unlike `conversations_list` which retrieves a list of available conversations. |
+| `conversations_list` | Fetches a paginated list of channel-like conversations in a workspace. Allows filtering by type and excluding archived channels. This function lists available conversations, unlike `conversations_history` which retrieves the message history from within a specific conversation. |
+| `reactions_add` | Adds a specific emoji reaction to a message in a Slack channel, identifying the message by its channel ID and timestamp. This method creates a new reaction, unlike `reactions_get` or `reactions_list` which retrieve existing reaction data for items or users. |
+| `get_reactions_for_item` | Retrieves all reactions for a single item, such as a message, file, or file comment. This function targets reactions *on* a specific item, unlike `reactions_list` which gets reactions created *by* a user. |
+| `get_user_reactions` | Retrieves a paginated list of items (e.g., messages, files) that a specific user has reacted to. Unlike `reactions_get`, which fetches all reactions for a single item, this function lists all items a given user has reacted to across Slack. |
+| `search_messages` | Searches a Slack workspace for messages matching a specific query. It supports advanced control over results through pagination, sorting by relevance or timestamp, and an option to highlight search terms within the returned message content. |
+| `team_info` | Fetches details for a Slack team, such as name and domain, by calling the `team.info` API endpoint. This function requires an authentication token and can optionally target a specific team by its ID, distinguishing it from user or channel-specific functions. |
+| `get_user_info` | Fetches detailed profile information for a single Slack user, identified by their user ID. Unlike `users_list`, which retrieves all workspace members, this function targets an individual and can optionally include their locale information. It directly calls the `users.info` Slack API endpoint. |
+| `users_list` | Fetches a paginated list of all users in a Slack workspace, including deactivated members. Unlike `users_info` which retrieves a single user's details, this function returns a collection and supports limiting results or including locale data through optional parameters. |

universal_mcp/applications/spotify/README.md

@@ -1,10 +1,10 @@
-# Spotify MCP Server
+# SpotifyApp MCP Server
 
-An MCP Server for the Spotify API.
+An MCP Server for the SpotifyApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Spotify API.
+This is automatically generated from OpenAPI schema for the SpotifyApp API.
 
 
 | Tool | Description |

universal_mcp/applications/supabase/README.md

@@ -1,10 +1,10 @@
-# Supabase MCP Server
+# SupabaseApp MCP Server
 
-An MCP Server for the Supabase API.
+An MCP Server for the SupabaseApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Supabase API.
+This is automatically generated from OpenAPI schema for the SupabaseApp API.
 
 
 | Tool | Description |

universal_mcp/applications/tavily/README.md

@@ -1,12 +1,12 @@
-# Tavily MCP Server
+# TavilyApp MCP Server
 
-An MCP Server for the Tavily API.
+An MCP Server for the TavilyApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Tavily API.
+This is automatically generated from OpenAPI schema for the TavilyApp API.
 
 
 | Tool | Description |
 |------|-------------|
-| `search` | Performs a web search using Tavily's search API and returns either a direct answer or a summary of top results. |
+| `search_and_summarize` | Queries the Tavily API to perform a web search. It returns a direct AI-generated answer if available; otherwise, it provides a formatted summary of the top three search results, including their titles and snippets. |

universal_mcp/applications/twilio/README.md

@@ -0,0 +1,15 @@
+# TwilioApp MCP Server
+
+An MCP Server for the TwilioApp API.
+
+## 🛠️ Tool List
+
+This is automatically generated from OpenAPI schema for the TwilioApp API.
+
+
+| Tool | Description |
+|------|-------------|
+| `create_message` | Sends a new SMS or MMS message using Twilio. |
+| `fetch_message` | Fetches the details of a specific message by its SID. |
+| `list_messages` | Lists messages from your Twilio account, optionally filtered by date. |
+| `delete_message` | Deletes a specific message from your Twilio account. |