universal-mcp-applications 0.1.13__py3-none-any.whl → 0.1.14__py3-none-any.whl

universal_mcp/applications/slack/app.py

@@ -16,19 +16,19 @@ class SlackApp(APIApplication):
         ts: float | None = None,
     ) -> dict[str, Any]:
         """
-        Deletes a message from a Slack channel using the provided token and returns a status message.
-
+        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.
+        
         Args:
             as_user (boolean): Pass true to delete the message as the authed user with `chat:write:user` scope. [Bot users](https://slack.dev) in this context are considered authed users. If unused or false, the message will be deleted with `chat:write:bot` scope.
             channel (string): Channel containing the message to be deleted.
             ts (number): Timestamp of the message to be deleted.
-
+        
         Returns:
             dict[str, Any]: Typical success response
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             chat
         """
@@ -70,8 +70,8 @@ class SlackApp(APIApplication):
         username: str | None = None,
     ) -> dict[str, Any]:
         """
-        Sends a message to a Slack channel using the `chat.postMessage` method, which requires a valid authentication token and supports various message formats, including text, attachments, and blocks.
-
+        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.
+        
         Args:
             as_user (boolean): Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See [authorship](https://slack.dev) below.
             attachments (string): A JSON-based array of structured attachments, presented as a URL-encoded string.
@@ -88,13 +88,13 @@ class SlackApp(APIApplication):
             unfurl_links (boolean): Pass true to enable unfurling of primarily text-based content.
             unfurl_media (boolean): Pass false to disable unfurling of media content.
             username (string): Set your bot's user name. Must be used in conjunction with `as_user` set to false, otherwise ignored. See [authorship](https://slack.dev) below.
-
+        
         Returns:
             dict[str, Any]: Typical success response
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             chat
         """
@@ -141,8 +141,8 @@ class SlackApp(APIApplication):
         ts: str | None = None,
     ) -> dict[str, Any]:
         """
-        Updates a message in a Slack channel using the "chat.update" API method, requiring a valid authentication token and supporting modifications to message content through parameters like "text," "blocks," or "attachments."
-
+        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.
+        
         Args:
             as_user (string): Pass true to update the message as the authed user. [Bot users](https://slack.dev) in this context are considered authed users.
             attachments (string): A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting `text`. If you don't include this field, the message's previous `attachments` will be retained. To remove previous `attachments`, include an empty array for this field.
@@ -152,13 +152,13 @@ class SlackApp(APIApplication):
             parse (string): Change how messages are treated. Defaults to `client`, unlike `chat.postMessage`. Accepts either `none` or `full`. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, `client`.
             text (string): New text for the message, using the [default formatting rules](https://slack.dev). It's not required when presenting `blocks` or `attachments`.
             ts (string): Timestamp of the message to be updated.
-
+        
         Returns:
             dict[str, Any]: Typical success response
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             chat, important
         """
@@ -197,8 +197,8 @@ class SlackApp(APIApplication):
         cursor: str | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves a portion of message events from a specified Slack conversation using the `conversations.history` method, allowing for pagination and filtering by timestamp.
-
+        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.
+        
         Args:
             token (string): Authentication token used to access conversation history.
             channel (string): The ID of the channel to retrieve the conversation history from.
@@ -207,13 +207,13 @@ class SlackApp(APIApplication):
             inclusive (boolean): Determines whether to include the messages at the end of the history range in the response.
             limit (integer): Specifies the maximum number of conversation history entries to retrieve in a single API call.
             cursor (string): A string token used for cursor-based pagination to fetch the next set of conversation history results starting from a specific point.
-
+        
         Returns:
             dict[str, Any]: Typical success response containing a channel's messages
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             conversations
         """
@@ -243,21 +243,21 @@ class SlackApp(APIApplication):
         cursor: str | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves a list of all channel-like conversations in a Slack workspace, optionally excluding archived channels and supporting pagination using a cursor[1][2][3].
-
+        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.
+        
         Args:
             token (string): The token parameter in the query string is a string used for authentication to authorize and identify the client making the GET request to the /conversations.list endpoint.
             exclude_archived (boolean): Exclude archived conversations from the list of results.
             types (string): Specifies the types of conversations to include in the list, as a string query parameter.
             limit (integer): Specifies the maximum number of conversations to return in the response, with a default value of 1.
             cursor (string): A cursor string used for pagination to specify the position from which to continue retrieving the next set of conversation results.
-
+        
         Returns:
             dict[str, Any]: Typical success response with only public channels
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             conversations
         """
@@ -278,19 +278,19 @@ class SlackApp(APIApplication):
 
     def reactions_add(self, channel: str, name: str, timestamp: str) -> dict[str, Any]:
         """
-        Adds a reaction to an item in Slack using a POST request with an authorization token and required form data.
-
+        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.
+        
         Args:
             channel (string): Channel where the message to add reaction to was posted.
             name (string): Reaction (emoji) name.
             timestamp (string): Timestamp of the message to add reaction to.
-
+        
         Returns:
             dict[str, Any]: Typical success response
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             reactions
         """
@@ -313,7 +313,7 @@ class SlackApp(APIApplication):
         )
         return self._handle_response(response)
 
-    def reactions_get(
+    def get_reactions_for_item(
         self,
         token: str,
         channel: str | None = None,
@@ -323,8 +323,8 @@ class SlackApp(APIApplication):
         timestamp: str | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves reaction information for a Slack message or file based on specified parameters such as channel, file, file comment, or timestamp, requiring a valid token with "reactions:read" scope.
-
+        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.
+        
         Args:
             token (string): The "token" parameter is a required string that must be provided in the query string for authentication purposes when using the GET operation at "/reactions.get" to authorize access to reaction data.
             channel (string): The channel identifier to filter reactions by, specified as a string.
@@ -332,13 +332,13 @@ class SlackApp(APIApplication):
             file_comment (string): A query parameter to filter reactions by a specific file comment.
             full (boolean): Whether to return full reaction details or only basic reaction information.
             timestamp (string): The timestamp parameter filters results based on a specific date and time value, expected in an ISO 8601 format string.
-
+        
         Returns:
             dict[str, Any]: Typical success response
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             reactions
         """
@@ -358,7 +358,7 @@ class SlackApp(APIApplication):
         response = self._get(url, params=query_params)
         return self._handle_response(response)
 
-    def reactions_list(
+    def get_user_reactions(
         self,
         token: str,
         user: str | None = None,
@@ -369,8 +369,8 @@ class SlackApp(APIApplication):
         limit: int | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves a paginated list of reactions, supporting filtering by user and additional query parameters for granular results.
-
+        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.
+        
         Args:
             token (string): Required authentication token passed as a query parameter to authenticate the request for listing reactions.
             user (string): Filter reactions by specifying the user, which can be a username or identifier.
@@ -379,13 +379,13 @@ class SlackApp(APIApplication):
             page (integer): The "page" parameter is an integer query parameter used to specify the page number for pagination in the list of reactions.
             cursor (string): A string used to specify the position in the list of reactions for pagination, allowing retrieval of additional items after or before the specified cursor.
             limit (integer): The `limit` parameter specifies the maximum number of reactions to return in the response.
-
+        
         Returns:
             dict[str, Any]: Typical success response
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             reactions
         """
@@ -417,8 +417,8 @@ class SlackApp(APIApplication):
         sort_dir: str | None = None,
     ) -> dict[str, Any]:
         """
-        Searches for and retrieves Slack messages matching a specified query, with options for pagination, sorting, and query highlighting[1][2].
-
+        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.
+        
         Args:
             token (string): A required string parameter named "token" passed as a query parameter to authenticate the request for retrieving search messages.
             query (string): The search query string to specify the text or keywords to search for in messages.
@@ -427,13 +427,13 @@ class SlackApp(APIApplication):
             page (integer): The page query parameter specifies the page number of search results to retrieve in the GET /search.messages operation.
             sort (string): Sorts the search results by a specified field, allowing clients to customize the order of returned messages.
             sort_dir (string): The "sort_dir" query parameter specifies the direction of sorting for the search results, typically accepting values like "asc" for ascending or "desc" for descending order.
-
+        
         Returns:
             dict[str, Any]: Typical success response
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             search, important
         """
@@ -456,18 +456,18 @@ class SlackApp(APIApplication):
 
     def team_info(self, token: str, team: str | None = None) -> dict[str, Any]:
         """
-        Retrieves information about a Slack team, including its custom icon and basic details, using a provided authentication token[1][3][4].
-
+        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.
+        
         Args:
             token (string): Mandatory authentication token passed as a query parameter to authenticate the request for retrieving team information.
             team (string): The "team" parameter is a query string parameter of type string, used to specify the team for which information is requested in the GET operation at the "/team.info" path.
-
+        
         Returns:
             dict[str, Any]: Typical success response
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             team
         """
@@ -478,26 +478,26 @@ class SlackApp(APIApplication):
         response = self._get(url, params=query_params)
         return self._handle_response(response)
 
-    def users_info(
+    def get_user_info(
         self,
         token: str,
         include_locale: bool | None = None,
         user: str | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves information about a specific Slack workspace member using the `users.info` method, returning a user object that includes profile details such as name and display name.
-
+        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.
+        
         Args:
             token (string): The token query parameter is a required string used to authenticate and authorize the API request to access user information in the GET /users.info operation.
             include_locale (boolean): Indicates whether to include locale information in the response, with a value of true or false.
             user (string): A string parameter used to identify or specify a user in the request.
-
+        
         Returns:
             dict[str, Any]: Typical success response
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             users, important
         """
@@ -522,20 +522,20 @@ class SlackApp(APIApplication):
         include_locale: bool | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves a list of all users in a Slack workspace, using the "GET" method, including both invited and deactivated users, with optional parameters for limiting results and pagination.
-
+        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.
+        
         Args:
             token (string): Required authentication token for accessing the list of users.
             limit (integer): Specifies the maximum number of users to return in the response, defaults to 1.
             cursor (string): A unique string identifier used for cursor-based pagination, indicating the starting point for retrieving the next set of users in the list.
             include_locale (boolean): A boolean query parameter to optionally include locale information in the response.
-
+        
         Returns:
             dict[str, Any]: Typical success response
-
+        
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-
+        
         Tags:
             users
         """
@@ -561,10 +561,10 @@ class SlackApp(APIApplication):
             self.conversations_history,
             self.conversations_list,
             self.reactions_add,
-            self.reactions_get,
-            self.reactions_list,
+            self.get_reactions_for_item,
+            self.get_user_reactions,
             self.search_messages,
             self.team_info,
-            self.users_info,
+            self.get_user_info,
             self.users_list,
         ]

universal_mcp/applications/tavily/app.py

@@ -8,20 +8,20 @@ class TavilyApp(APIApplication):
         super().__init__(name=name, integration=integration)
         self.base_url = "https://api.tavily.com"
 
-    def search(self, query: str) -> str:
+    def search_and_summarize(self, query: str) -> str:
         """
-        Performs a web search using Tavily's search API and returns either a direct answer or a summary of top results.
-
+        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.
+        
         Args:
             query: The search query string to be processed by Tavily's search engine
-
+        
         Returns:
             A string containing either a direct answer from Tavily's AI or a formatted summary of the top 3 search results, with each result containing the title and snippet
-
+        
         Raises:
             ValueError: When authentication credentials are invalid or missing (via validate() method)
             HTTPError: When the API request fails or returns an error response
-
+        
         Tags:
             search, ai, web, query, important, api-client, text-processing
         """
@@ -48,4 +48,4 @@ class TavilyApp(APIApplication):
         return "\n".join(summaries)
 
     def list_tools(self):
-        return [self.search]
+        return [self.search_and_summarize]

universal_mcp/applications/twitter/api_segments/compliance_api.py

@@ -11,21 +11,20 @@ class ComplianceApi(APISegmentBase):
         self, type, status=None, compliance_job_fields=None
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of compliance jobs based on the specified job type, with optional filtering by status.
-
+        Retrieves a list of compliance jobs, requiring a job `type` ('tweets' or 'users') and allowing optional filtering by `status`. This function fetches multiple jobs, distinguishing it from `get_batch_compliance_job` which retrieves a single job by its unique ID.
+        
         Args:
             type (string): The type parameter specifies the compliance job type and must be either "tweets" or "users".
             status (string): Filters compliance jobs by their current status, which can be one of: created, in_progress, failed, or complete.
             compliance_job_fields (array): A comma separated list of ComplianceJob fields to display. Example: "['created_at', 'download_expires_at', 'download_url', 'id', 'name', 'resumable', 'status', 'type', 'upload_expires_at', 'upload_url']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Compliance
         """
@@ -47,21 +46,20 @@ class ComplianceApi(APISegmentBase):
         self, type, name=None, resumable=None
     ) -> dict[str, Any]:
         """
-
-        Creates a new compliance job using JSON data in the request body and authenticates the request using a Bearer token.
-
+        Creates a new batch compliance job for a specified type ('tweets' or 'users'). A custom name can be provided, and resumable uploads can be enabled. This initiates the job creation process, differing from functions that list or retrieve existing jobs.
+        
         Args:
             type (string): Type of compliance job to list.
             name (string): User-provided name for a compliance job. Example: 'my-job'.
             resumable (boolean): If true, this endpoint will return a pre-signed URL with resumable uploads enabled.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Compliance
         """
@@ -81,24 +79,23 @@ class ComplianceApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_batch_compliance_job(
+    def get_compliance_job(
         self, id, compliance_job_fields=None
     ) -> dict[str, Any]:
         """
-
-        Retrieves information about a compliance job by its ID using the BearerToken for authentication.
-
+        Retrieves a single batch compliance job by its unique ID. Unlike `list_batch_compliance_jobs`, which fetches a list, this function returns details for one specific job. Optional parameters can customize which data fields are returned in the response.
+        
         Args:
             id (string): id
             compliance_job_fields (array): A comma separated list of ComplianceJob fields to display. Example: "['created_at', 'download_expires_at', 'download_url', 'id', 'name', 'resumable', 'status', 'type', 'upload_expires_at', 'upload_url']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Compliance
         """
@@ -118,5 +115,5 @@ class ComplianceApi(APISegmentBase):
         return [
             self.list_batch_compliance_jobs,
             self.create_batch_compliance_job,
-            self.get_batch_compliance_job,
+            self.get_compliance_job,
         ]