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

universal_mcp/applications/google_searchconsole/app.py

@@ -16,7 +16,7 @@ class GoogleSearchconsoleApp(APIApplication):
 
     def delete_sitemap(self, siteUrl: str, feedpath: str) -> None:
         """
-        Deletes a sitemap from a specified Google Search Console property. It targets the sitemap using the site's URL and the sitemap's `feedpath`, then issues an HTTP DELETE request. This action is distinct from `delete_site`, which removes the entire property, not just a sitemap.
+        Deletes a specific sitemap from a Google Search Console property using its URL (`feedpath`). This function is distinct from `delete_site`, which removes the entire site property, not just a single sitemap file. It issues an HTTP DELETE request to the specified API endpoint.
         
         Args:
             siteUrl (str): The site's URL, including protocol (e.g. 'http://www.example.com/').
@@ -38,7 +38,7 @@ class GoogleSearchconsoleApp(APIApplication):
 
     def get_sitemap(self, siteUrl: str, feedpath: str) -> dict[str, Any]:
         """
-        Retrieves detailed information for a single, specific sitemap using its full URL (`feedpath`). Unlike `list_sitemaps`, which fetches all sitemaps for a site, this function targets and returns one sitemap resource, providing its status, last processed date, and other API metadata.
+        Retrieves detailed information for a single sitemap from a specified Google Search Console property. Unlike `list_sitemaps` which fetches all sitemaps, this function targets one sitemap by its URL (`feedpath`) to return its resource details, including status and last processed date.
         
         Args:
             siteUrl (str): The site's URL, including protocol (e.g. 'http://www.example.com/').
@@ -62,7 +62,7 @@ class GoogleSearchconsoleApp(APIApplication):
         self, siteUrl: str, sitemapIndex: str | None = None
     ) -> dict[str, Any]:
         """
-        Retrieves a list of sitemaps submitted for a specific site. Optionally, it can list the sitemaps contained within a specified sitemap index file instead of all sitemaps for the site. This contrasts with get_sitemap, which fetches a single sitemap's details.
+        Retrieves a list of sitemaps for a specific site property. It can optionally list sitemaps contained within a specified sitemap index file. This function contrasts with `get_sitemap`, which fetches details for only a single, specified sitemap rather than a collection.
         
         Args:
             siteUrl (str): The site's URL, including protocol (e.g. 'http://www.example.com/').
@@ -88,7 +88,7 @@ class GoogleSearchconsoleApp(APIApplication):
 
     def submit_sitemap(self, siteUrl: str, feedpath: str) -> None:
         """
-        Submits a sitemap to a specified Google Search Console site property. This function notifies Google of the sitemap's location for crawling via a PUT request. It is the primary action for adding or updating a sitemap, complementing `get_sitemap`, `list_sitemaps`, and `delete_sitemap`.
+        Submits a sitemap to a specified Google Search Console property using its URL (feedpath). It notifies Google to crawl the sitemap's location, complementing other sitemap management functions (`list_sitemaps`, `delete_sitemap`) by adding or updating a sitemap's registration for a given site.
         
         Args:
             siteUrl (str): The site's URL, including protocol (e.g. 'http://www.example.com/').
@@ -112,7 +112,7 @@ class GoogleSearchconsoleApp(APIApplication):
 
     def add_site(self, siteUrl: str) -> dict[str, Any]:
         """
-        Adds a site to the user's Google Search Console account, which requires subsequent ownership verification. Upon success, it returns a dictionary containing the site resource. This method creates a new site entry, unlike `list_sites` which only retrieves existing ones.
+        Adds a site property to the user's Google Search Console account using its URL. This action requires subsequent ownership verification. Unlike `list_sites`, which only retrieves existing properties, this function creates a new entry and returns the corresponding site resource upon successful creation.
         
         Args:
             siteUrl (str): The URL of the site to add. Example: 'http://www.example.com/'.
@@ -134,7 +134,7 @@ class GoogleSearchconsoleApp(APIApplication):
 
     def delete_site(self, siteUrl: str) -> None:
         """
-        Removes a website property from the user's Google Search Console account using its URL. This function sends a DELETE request to the API, distinguishing it from `delete_sitemap` which only removes a sitemap file rather than the entire site property from the user's management list.
+        Removes a website property from the user's Google Search Console account using its URL. Unlike `delete_sitemap`, which only targets a sitemap file, this function deletes the entire site property, revoking management access and removing it from the user's list of managed sites.
         
         Args:
             siteUrl (str): The URL of the site to delete. Example: 'http://www.example.com/'.
@@ -152,7 +152,7 @@ class GoogleSearchconsoleApp(APIApplication):
 
     def get_site(self, siteUrl: str) -> dict[str, Any]:
         """
-        Retrieves the resource for a specific site property from Google Search Console, using its URL as an identifier. Unlike `list_sites`, which retrieves all user properties, this function fetches detailed information for a single, known site.
+        Retrieves detailed information for a specific site property from Google Search Console using its URL. Unlike `list_sites`, which fetches all properties associated with the user's account, this function targets and returns the resource for a single, known site.
         
         Args:
             siteUrl (str): The site's URL, including protocol (e.g. 'http://www.example.com/').
@@ -171,7 +171,7 @@ class GoogleSearchconsoleApp(APIApplication):
 
     def list_sites(self) -> dict[str, Any]:
         """
-        Retrieves a list of all websites and domain properties the authenticated user can access in Google Search Console. Unlike `get_site`, which fetches a single property, this function returns a comprehensive overview of all managed sites associated with the user's account.
+        Retrieves all websites and domain properties the authenticated user manages in Google Search Console. While `get_site` fetches a single, specific property, this function returns a comprehensive list of all sites linked to the user's account, providing a complete overview of managed properties.
         
         Returns:
             Dict[str, Any]: List of site resources.

universal_mcp/applications/google_sheet/app.py

@@ -21,7 +21,7 @@ class GoogleSheetApp(APIApplication):
 
     def create_spreadsheet(self, title: str) -> dict[str, Any]:
         """
-        Creates a new, blank Google Spreadsheet file with a specified title. This function generates a completely new document, unlike `add_sheet` which adds a tab to an existing spreadsheet. It returns the API response containing the new spreadsheet's metadata.
+        Creates a new, blank Google Spreadsheet file with a specified title. This function generates a completely new document, unlike `add_sheet` which adds a worksheet (tab) to an existing spreadsheet. It returns the API response containing the new spreadsheet's metadata.
         
         Args:
             title: String representing the desired title for the new spreadsheet
@@ -43,7 +43,7 @@ class GoogleSheetApp(APIApplication):
 
     def get_spreadsheet_metadata(self, spreadsheet_id: str) -> dict[str, Any]:
         """
-        Retrieves a spreadsheet's metadata and structural properties, such as sheet names, IDs, and named ranges, using its unique ID. This function intentionally excludes cell data, distinguishing it from `get_values` which fetches the actual content within the cells.
+        Retrieves a spreadsheet's metadata and structural properties, such as sheet names, IDs, and named ranges, using its unique ID. This function intentionally excludes cell data, distinguishing it from `get_values` which fetches the actual content within cells.
         
         Args:
             spreadsheet_id: The unique identifier of the Google Spreadsheet to retrieve (found in the spreadsheet's URL)
@@ -72,7 +72,7 @@ class GoogleSheetApp(APIApplication):
         dateTimeRenderOption: str | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves cell values from a single, specified A1 notation range in a Google Spreadsheet. Unlike `batch_get_values` which fetches multiple ranges, this function is for a singular query and provides options to control the data's output format (e.g., rows vs. columns, formatted vs. raw values).
+        Retrieves cell values from a single, specified A1 notation range. Unlike `batch_get_values_by_range` which fetches multiple ranges, this function is for a singular query and provides options to control the data's output format (e.g., rows vs. columns, formatted vs. raw values).
         
         Args:
             spreadsheetId: The unique identifier of the Google Spreadsheet to retrieve values from
@@ -108,7 +108,7 @@ class GoogleSheetApp(APIApplication):
         self, spreadsheet_id: str, ranges: list[str] | None = None
     ) -> dict[str, Any]:
         """
-        Efficiently retrieves values from multiple specified ranges in a Google Spreadsheet using a single batch API request. This method is distinct from `get_values`, which fetches a single range, and `batch_get_values_by_data_filter`, which uses filtering criteria instead of predefined A1 notation ranges.
+        Efficiently retrieves values from multiple predefined A1 notation ranges in a single API request. Unlike `get_values`, which fetches a single range, or `batch_get_values_by_data_filter`, which uses dynamic filtering criteria, this function operates on a simple list of range strings for bulk data retrieval.
         
         Args:
             spreadsheet_id: The unique identifier of the Google Spreadsheet to retrieve values from
@@ -144,7 +144,7 @@ class GoogleSheetApp(APIApplication):
         response_ranges: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Inserts empty rows or columns at a specified index, shifting existing content. Unlike `append_dimensions`, which adds to the end, this function is used to insert space within the data grid. Returns the API response containing update details.
+        Inserts a specified number of empty rows or columns at a given index, shifting existing content. Distinct from `append_dimensions`, which only adds to the end, this function creates space within the sheet's data grid, preserving surrounding data and formatting.
         
         This function inserts empty rows or columns at a specified location, shifting existing content.
         Use this when you need to add rows/columns in the middle of your data.
@@ -223,7 +223,7 @@ class GoogleSheetApp(APIApplication):
         length: int,
     ) -> dict[str, Any]:
         """
-        Adds a specified number of empty rows or columns to the end of a designated sheet. Unlike `insert_dimensions`, which adds dimensions at a specific index, this function exclusively extends the sheet's boundaries at the bottom or to the right without affecting existing content.
+        Adds a specified number of empty rows or columns to the end of a designated sheet. Unlike `insert_dimensions`, which adds space at a specific index, this function exclusively extends the sheet's boundaries at the bottom or to the right without affecting existing content.
         
         This function adds empty rows or columns to the end of the sheet without affecting existing content.
         Use this when you need to extend the sheet with additional space at the bottom or right.
@@ -282,7 +282,7 @@ class GoogleSheetApp(APIApplication):
         response_ranges: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Deletes a specified range of rows or columns from a sheet, permanently removing them and shifting subsequent cells. This alters the sheet's structure, unlike `clear_values` which only removes cell content. It complements `insert_dimensions` and `append_dimensions` for structural modifications.
+        Deletes a specified range of rows or columns, permanently removing them and shifting subsequent cells. This alters the sheet's structure, unlike `clear_values` which only removes cell content. It is the direct counterpart to `insert_dimensions`, which adds space within the data grid.
         
         Args:
             spreadsheet_id: The ID of the spreadsheet. Example: "abc123xyz789"
@@ -371,7 +371,7 @@ class GoogleSheetApp(APIApplication):
         responseIncludeGridData: bool = False,
     ) -> dict[str, Any]:
         """
-        Adds a new worksheet (tab) to an existing Google Spreadsheet. Allows customization of the new sheet's properties, including its title, index position, size (rows/columns), and visibility. This differs from `create_spreadsheet`, which creates a new spreadsheet file entirely.
+        Adds a new worksheet (tab) to an existing Google Spreadsheet. It allows extensive customization of the new sheet's properties, such as its title, position, and dimensions. This is distinct from `create_spreadsheet`, which generates a completely new spreadsheet file instead of modifying an existing one.
         
         Args:
             spreadsheetId: The ID of the spreadsheet to add the sheet to. This is the long string of characters in the URL of your Google Sheet. Example: "abc123xyz789"
@@ -638,7 +638,7 @@ class GoogleSheetApp(APIApplication):
         pie_hole: float | None = None,
     ) -> dict[str, Any]:
         """
-        Adds a pie or donut chart to a Google Spreadsheet from a specified data range. Unlike the more general `add_basic_chart`, this function is specialized for visualizing data as proportions of a whole and supports pie-specific options like creating a donut chart via the `pie_hole` parameter.
+        Adds a pie or donut chart to a Google Spreadsheet from a specified data range. Unlike the more general `add_basic_chart`, this is specialized for visualizing data as proportions of a whole and supports pie-specific options like creating a donut chart via the `pie_hole` parameter.
         
         This function creates a pie chart from the specified data range and places it in a new sheet or existing sheet.
         Use this when you need to visualize data as proportions of a whole.
@@ -997,7 +997,7 @@ class GoogleSheetApp(APIApplication):
 
     def clear_values(self, spreadsheet_id: str, range: str) -> dict[str, Any]:
         """
-        Clears data from a single, specified cell range in a Google Sheet while preserving all formatting. Unlike `delete_dimensions`, it only removes content, not the cells themselves. For clearing multiple ranges simultaneously, use the `batch_clear_values` function.
+        Clears data from a single, specified cell range while preserving all formatting. Unlike `delete_dimensions`, it only removes content, not the cells themselves. For clearing multiple ranges simultaneously, use the `batch_clear_values` function.
         
         Args:
             spreadsheet_id: The unique identifier of the Google Spreadsheet to modify
@@ -1025,7 +1025,7 @@ class GoogleSheetApp(APIApplication):
         value_input_option: str = "RAW",
     ) -> dict[str, Any]:
         """
-        Overwrites cell values within a specific A1 notation range in a Google Spreadsheet. This function replaces existing data with the provided values, differing from `append_values` which adds new rows. It provides a direct method for targeted data replacement in a predefined area of the sheet.
+        Overwrites cell values within a specific A1 notation range using a provided 2D list. This function replaces existing data in a predefined area, distinguishing it from `append_values`, which adds new rows after a table instead of overwriting a specific block of cells.
         
         Args:
             spreadsheet_id: The unique identifier of the target Google Spreadsheet
@@ -1093,7 +1093,7 @@ class GoogleSheetApp(APIApplication):
         date_time_render_option: str | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves values from spreadsheet ranges matching a list of data filters. This method provides dynamic, criteria-based selection using A1 notation or grid coordinates, unlike `batch_get_values` which uses a simple list of range strings. It is ideal for fetching multiple, specific datasets in one request.
+        Retrieves values from spreadsheet ranges matching a list of data filters. This method provides dynamic, criteria-based selection using A1 notation or grid coordinates, unlike `batch_get_values_by_range` which uses a simple list of range strings. It is ideal for fetching multiple, specific datasets in one request.
         
         Args:
             spreadsheet_id: The ID of the spreadsheet to retrieve data from. Example: "1q2w3e4r5t6y7u8i9o0p"
@@ -1168,7 +1168,7 @@ class GoogleSheetApp(APIApplication):
         destination_spreadsheet_id: str,
     ) -> dict[str, Any]:
         """
-        Copies a specific sheet, including all its data and formatting, from a source spreadsheet to a different destination spreadsheet. This action duplicates an entire worksheet into another workbook, returning the properties of the newly created sheet in the API response.
+        Copies a specific sheet, including all its data and formatting, from a source spreadsheet to a different destination spreadsheet. This action duplicates an entire worksheet into another workbook, returning properties of the newly created sheet.
         
         
         Args:
@@ -1212,7 +1212,7 @@ class GoogleSheetApp(APIApplication):
         include_values_in_response: bool = False,
     ) -> dict[str, Any]:
         """
-        Writes a 2D list of values to a sheet, overwriting existing data. Data is written starting from a specified cell, or defaults to cell A1 if no location is provided. This differs from `append_values`, which adds new rows after existing data.
+        Writes a 2D list of values to a sheet, overwriting existing data. Data is written starting from a specified cell, or defaults to cell A1 if no location is provided. This differs from `append_values`, which adds new rows after existing data without replacing content.
         
         Args:
             spreadsheet_id: The unique identifier of the Google Sheets spreadsheet to be updated. Example: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
@@ -1278,7 +1278,7 @@ class GoogleSheetApp(APIApplication):
         response_date_time_render_option: str | None = None,
     ) -> dict[str, Any]:
         """
-        Appends rows of data after a table within a specified range. Unlike `batch_update`, this function can optionally insert new rows, shifting existing data down. This provides more granular control for adding data to a sheet without overwriting existing cells below the target table.
+        Appends rows of data after a specified table in a Google Sheet. Distinct from `update_values` which overwrites data, this function adds new rows at the end of the table. It can also insert rows, shifting existing cells down, offering finer control over data addition.
         
         Args:
             spreadsheet_id: The ID of the spreadsheet to update. Example: "1q0gLhLdGXYZblahblahblah"
@@ -1371,7 +1371,7 @@ class GoogleSheetApp(APIApplication):
         sheet_id: int,
     ) -> dict[str, Any]:
         """
-        Removes the basic filter from a specified sheet within a Google Spreadsheet. This action clears any active sorting or filtering criteria, restoring the default data view. It is the direct counterpart to the `set_basic_filter` function.
+        Removes the basic filter from a specified sheet, clearing active sorting and filtering criteria to restore the default data view. As the direct counterpart to `set_basic_filter`, this function removes the entire filter object, not just the cell content.
         
         Args:
             spreadsheet_id: The ID of the spreadsheet. Example: "abc123xyz789"
@@ -1443,7 +1443,7 @@ class GoogleSheetApp(APIApplication):
         min_confidence: float = 0.5,
     ) -> dict[str, Any]:
         """
-        Discovers and lists all table-like data structures within a Google Spreadsheet. It heuristically analyzes each sheet to identify headers and data boundaries, returning tables that meet specified size and confidence criteria. This is distinct from listing formally defined tables.
+        Heuristically analyzes a spreadsheet to discover and list all table-like data structures, identifying headers and data boundaries. It returns informal data blocks meeting specified size criteria, distinguishing it from functions like `add_table` that manage formally defined tables.
         
         Args:
             spreadsheet_id: Google Sheets ID from the URL (e.g., '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms'). Example: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
@@ -1474,7 +1474,7 @@ class GoogleSheetApp(APIApplication):
             raise ValueError("min_confidence must be between 0.0 and 1.0")
 
         # Get spreadsheet structure
-        spreadsheet = self.get_spreadsheet(spreadsheet_id)
+        spreadsheet = self.get_spreadsheet_metadata(spreadsheet_id)
 
         tables = []
 
@@ -1514,7 +1514,7 @@ class GoogleSheetApp(APIApplication):
         sample_size: int = 50,
     ) -> dict[str, Any]:
         """
-        Infers the schema for a specific table within a Google Sheet by analyzing a sample of its data. After locating the table by name (as discovered by `list_tables`), it determines the most likely data type and properties for each column.
+        Infers a specified table's schema by analyzing a data sample. After locating the table by name (a value discovered via `discover_tables`), this function determines the most likely data type and properties for each column, providing a detailed structural breakdown of its content.
         
         Args:
             spreadsheet_id: Google Sheets ID from the URL (e.g., '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms')
@@ -1542,7 +1542,7 @@ class GoogleSheetApp(APIApplication):
             raise ValueError("sample_size must be between 1 and 1000")
 
         # Get spreadsheet structure
-        spreadsheet = self.get_spreadsheet(spreadsheet_id)
+        spreadsheet = self.get_spreadsheet_metadata(spreadsheet_id)
 
         # Find the target table
         target_table = None
@@ -1681,11 +1681,11 @@ class GoogleSheetApp(APIApplication):
         mergeCells: bool = False,
     ) -> dict[str, Any]:
         """
-        Applies comprehensive formatting to a specified cell range in a worksheet. It modifies visual properties like text style, color, alignment, borders, and can merge cells, without altering the underlying cell values.
+        Applies comprehensive formatting to a specified cell range in a worksheet. It modifies visual properties like text style, color, alignment, borders, and can merge cells, without altering the underlying cell values, distinguishing it from data-modification functions like `update_values`.
         
         Args:
             spreadsheetId: Identifier of the Google Sheets spreadsheet. Example: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
-            worksheetId: ID (sheetId) of the worksheet. Use `get_spreadsheet` to find this ID. Example: 123456789
+            worksheetId: ID (sheetId) of the worksheet. Use `get_spreadsheet_metadata` to find this ID. Example: 123456789
             startRowIndex: 0-based index of the first row in the range. Example: 0
             startColumnIndex: 0-based index of the first column in the range. Example: 0
             endRowIndex: 0-based index of the row *after* the last row in the range (exclusive). Example: 1

universal_mcp/applications/linkedin/app.py

@@ -37,7 +37,7 @@ class LinkedinApp(APIApplication):
         is_reshare_disabled: bool = False,
     ) -> dict[str, str]:
         """
-        Publishes a new text post to a specified LinkedIn author's feed (person or organization). It requires commentary and allows configuring visibility, distribution, and lifecycle state. Upon success, it returns the unique URN and a direct URL for the newly created post, distinguishing it from update/delete operations.
+        Publishes a new text post to a specified LinkedIn author's feed (person or organization). It allows configuring visibility, distribution, and lifecycle state. Upon success, it returns the unique URN and URL for the new post, distinguishing this creation operation from the update or delete functions.
         
         Args:
             commentary (str): The user generated commentary for the post. Supports mentions using format "@[Entity Name](urn:li:organization:123456)" and hashtags using "#keyword". Text linking to annotated entities must match the name exactly (case sensitive). For member mentions, partial name matching is supported.
@@ -99,7 +99,7 @@ class LinkedinApp(APIApplication):
 
     def get_authenticated_user_profile(self) -> dict[str, Any]:
         """
-        Retrieves the authenticated user's profile information from the LinkedIn `/v2/userinfo` endpoint. It returns a dictionary containing the user's basic profile details, such as name and email, using the credentials from the active integration.
+        Retrieves the authenticated user's profile from the LinkedIn `/v2/userinfo` endpoint. Using credentials from the active integration, it returns a dictionary with basic user details like name and email. This function is for fetching user data, distinct from others that create, update, or delete posts.
         
         Returns:
             dict[str, Any]: Dictionary containing your LinkedIn profile information.
@@ -123,7 +123,7 @@ class LinkedinApp(APIApplication):
 
     def delete_post(self, post_urn: str) -> dict[str, str]:
         """
-        Deletes a specific LinkedIn post identified by its unique Uniform Resource Name (URN). The function sends a DELETE request to the LinkedIn API and returns a confirmation dictionary with the deletion status upon a successful (HTTP 204) response.
+        Deletes a LinkedIn post identified by its unique Uniform Resource Name (URN). This function sends a DELETE request to the API, permanently removing the content. Upon a successful HTTP 204 response, it returns a dictionary confirming the post's deletion status.
         
         Args:
             post_urn (str): The URN of the post to delete. Can be either a ugcPostUrn (urn:li:ugcPost:{id}) or shareUrn (urn:li:share:{id}).
@@ -163,7 +163,7 @@ class LinkedinApp(APIApplication):
         ad_context_status: str | None = None,
     ) -> dict[str, str]:
         """
-        Modifies an existing LinkedIn post identified by its URN. This function performs a partial update, allowing changes to specific attributes such as commentary, call-to-action details, lifecycle state, or sponsored ad context. It returns a confirmation dictionary upon successful completion of the PATCH request.
+        Modifies an existing LinkedIn post, identified by its URN, by performing a partial update. It selectively changes attributes like commentary or ad context, distinguishing it from `create_post` which creates new content. Returns a confirmation dictionary upon successful completion.
         
         Args:
             post_urn (str): The URN of the post to update. Can be either a ugcPostUrn (urn:li:ugcPost:{id}) or shareUrn (urn:li:share:{id}).

universal_mcp/applications/ms_teams/app.py

@@ -62,7 +62,7 @@ class MsTeamsApp(APIApplication):
 
     def get_joined_teams(self) -> list[dict[str, Any]]:
         """
-        Fetches all Microsoft Teams the authenticated user is a member of. This function queries the `/me/joinedTeams` API endpoint, returning a list of dictionaries where each dictionary contains the details of a specific team.
+        Fetches all Microsoft Teams the authenticated user belongs to by querying the `/me/joinedTeams` Graph API endpoint. It returns a list of dictionaries, where each dictionary represents a single team's details, unlike functions that list channels or chats for a specific team.
         
         Returns:
             A list of dictionaries, where each dictionary represents a team.
@@ -92,7 +92,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves channels for a specified Microsoft Teams team using its unique ID. Optional parameters allow for advanced querying, including filtering, searching, sorting, and pagination of the results, to customize the returned collection of channels.
+        Retrieves the collection of channels for a specified Microsoft Teams team by its ID. It supports advanced OData query parameters for filtering, sorting, and pagination, distinguishing it from functions that fetch single channels like `get_channel_details`.
         
         Args:
             team_id (string): team-id
@@ -136,7 +136,7 @@ class MsTeamsApp(APIApplication):
 
     def send_chat_message(self, chat_id: str, content: str) -> dict[str, Any]:
         """
-        Posts a new message to a specific Microsoft Teams chat using its unique ID. It sends a POST request to the Graph API endpoint with the provided content (text/HTML). This function targets direct/group chats, differentiating it from `send_channel_message`, which posts to team channels.
+        Posts a new message to a specific Microsoft Teams chat using its unique ID. This function targets direct or group chats, distinguishing it from `send_channel_message`, which posts to public team channels, and `reply_to_chat_message`, which responds to existing messages.
         
         Args:
             chat_id: The unique identifier of the chat.
@@ -160,7 +160,7 @@ class MsTeamsApp(APIApplication):
         self, team_id: str, channel_id: str, content: str
     ) -> dict[str, Any]:
         """
-        Posts a new message to a specified channel within a Microsoft Teams team using the team and channel IDs. This function initiates a new conversation thread, unlike `reply_to_channel_message`. The content can be plain text or HTML. It differs from `send_chat_message` which targets private/group chats.
+        Posts a new message to a specified team channel, initiating a new conversation thread. Unlike `reply_to_channel_message`, which replies to a message, this function starts a new topic. It's distinct from `send_chat_message`, which is for private or group chats, not team channels.
         
         Args:
             team_id: The unique identifier of the team.
@@ -185,7 +185,7 @@ class MsTeamsApp(APIApplication):
         self, team_id: str, channel_id: str, message_id: str, content: str
     ) -> dict[str, Any]:
         """
-        Posts a reply to a specific message within a Microsoft Teams channel. It uses the team, channel, and original message IDs to target the correct conversation thread, distinguishing it from `send_channel_message` which starts a new thread.
+        Posts a reply to a specific message within a Microsoft Teams channel. It uses the team, channel, and original message IDs to target an existing conversation thread, distinguishing it from `send_channel_message` which starts a new one.
         
         Args:
             team_id: The unique identifier of the team.
@@ -228,7 +228,7 @@ class MsTeamsApp(APIApplication):
         tabs: list[Any] | None = None,
     ) -> Any:
         """
-        Creates a new Microsoft Teams chat conversation. It takes optional parameters like chat type, topic, and members to configure the chat. This function sends a POST request to the `/chats` API endpoint, initiating a new one-on-one or group chat based on the provided details.
+        Creates a new one-on-one or group chat in Microsoft Teams. This function provisions a new conversation using optional parameters like chatType and members, distinguishing it from functions that create teams (`create_team`) or send messages to existing chats (`send_chat_message`).
         
         Args:
             id (string): The unique identifier for an entity. Read-only.
@@ -298,7 +298,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> Any:
         """
-        Retrieves the properties and relationships of a specific chat conversation by its unique ID. Optional parameters can select specific fields or expand related entities in the response, such as chat members or installed apps.
+        Retrieves the properties and relationships of a specific chat conversation by its unique ID. Unlike `get_user_chats` which lists all chats, this targets one chat. Optional parameters can select specific fields or expand related entities like members or apps to customize the returned data.
         
         Args:
             chat_id (string): chat-id
@@ -345,7 +345,7 @@ class MsTeamsApp(APIApplication):
         tabs: list[Any] | None = None,
     ) -> Any:
         """
-        Updates properties of a specific chat, such as its topic, using its unique ID. This function performs a partial update (PATCH) on an existing chat, distinguishing it from `get_chat` which only retrieves data, and `create_chat_operation` which creates an entirely new chat conversation.
+        Updates properties of a specific chat, such as its topic, using its unique ID. This function performs a partial update (PATCH), distinguishing it from `get_chat_details` which only retrieves data, and `create_chat` which creates an entirely new chat conversation.
         
         Args:
             chat_id (string): chat-id
@@ -419,7 +419,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves the collection of applications installed within a specific Microsoft Teams chat, identified by its ID. It supports advanced querying through optional parameters for pagination, filtering, searching, and sorting to customize the results.
+        Retrieves applications installed in a specific chat, identified by `chat_id`. Differentiating from `list_user_installed_apps`, which targets a user's personal scope, this function queries a single conversation. It supports optional parameters for advanced filtering, sorting, and pagination to customize the returned collection.
         
         Args:
             chat_id (string): chat-id
@@ -474,7 +474,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves a list of members for a specific chat, identified by `chat_id`. Supports advanced querying, including pagination, filtering, searching, and sorting. This function lists all members, unlike `get_chat_member_details` which fetches information for a single member.
+        Retrieves a collection of all members in a specific chat using its ID. It supports OData query parameters for pagination, filtering, and sorting. Unlike `get_chat_member`, which fetches a single individual, this function returns the entire collection of members for the specified chat.
         
         Args:
             chat_id (string): chat-id
@@ -525,7 +525,7 @@ class MsTeamsApp(APIApplication):
         visibleHistoryStartDateTime: str | None = None,
     ) -> Any:
         """
-        Adds a member to a specified Microsoft Teams chat using its `chat_id`. Details such as the member's roles and the extent of their visible chat history can be provided. This operation sends a POST request to the `/chats/{chat_id}/members` API endpoint.
+        Adds a new member to a specific Microsoft Teams chat using its `chat_id`. This function allows for configuring member roles and chat history visibility. It is the direct counterpart to `delete_chat_member`, performing the 'create' action for a chat's membership.
         
         Args:
             chat_id (string): chat-id
@@ -573,7 +573,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> Any:
         """
-        Retrieves detailed information for a specific member within a chat using their unique ID. Unlike `list_chat_members` which fetches all members, this function targets a single individual. The response can be customized by selecting specific properties or expanding related entities.
+        Retrieves detailed information for a specific member within a chat using their unique ID. This function targets a single individual, distinguishing it from `list_chat_members` which returns all members. The response can be customized by selecting specific properties or expanding related entities.
         
         Args:
             chat_id (string): chat-id
@@ -603,7 +603,7 @@ class MsTeamsApp(APIApplication):
 
     def delete_chat_member(self, chat_id: str, conversationMember_id: str) -> Any:
         """
-        Removes a specific member from a chat using their unique ID and the chat's ID. This function sends a DELETE request to the Microsoft Graph API to permanently remove the user from the specified conversation, acting as the counterpart to `add_member_to_chat`.
+        Removes a specific member from a chat using their unique ID and the chat's ID. This function sends a DELETE request to the Microsoft Graph API to permanently remove the user from the conversation, acting as the counterpart to `add_member_to_chat`.
         
         Args:
             chat_id (string): chat-id
@@ -640,7 +640,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves a collection of messages from a specific chat, identified by its unique ID. Supports advanced querying with options for pagination (top, skip), filtering, sorting, and searching to refine the results, distinguishing it from functions that get single messages or replies.
+        Retrieves messages from a specific chat using its ID. Unlike `get_chat_message`, which fetches a single message, this function returns a collection and supports advanced querying for filtering, sorting, and pagination to refine the results.
         
         Args:
             chat_id (string): chat-id
@@ -690,7 +690,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> Any:
         """
-        Retrieves the full details of a single message from a specific chat, identified by both the chat and message IDs. Supports optional query parameters to select specific properties or expand related entities, enabling customized API responses for a particular message.
+        Retrieves the full details of a single message from a specific chat using both chat and message IDs. This function targets an individual message, differentiating it from `list_chat_messages`, which retrieves a collection. Optional parameters can customize the response by selecting specific properties or expanding entities.
         
         Args:
             chat_id (string): chat-id
@@ -732,7 +732,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves a collection of replies for a specific message within a given chat. It identifies the parent message using `chat_id` and `chatMessage_id` and supports optional OData query parameters for advanced filtering, sorting, and pagination of the results.
+        Retrieves all replies for a specific message within a chat, using the parent message's ID. This function, unlike `get_chat_reply_details`, returns a collection and supports OData query parameters for advanced filtering, sorting, and pagination of the results.
         
         Args:
             chat_id (string): chat-id
@@ -808,7 +808,7 @@ class MsTeamsApp(APIApplication):
         replies: list[Any] | None = None,
     ) -> Any:
         """
-        Posts a reply to a specific message within a chat. This comprehensive function allows for detailed configuration of the reply message's properties, such as its body and attachments. It is distinct from `reply_to_channel_message`, which sends simple replies to messages within team channels.
+        Posts a reply to a specific message within a chat. This comprehensive function allows for detailed configuration of the reply's properties, like its body and attachments. It differs from `reply_to_channel_message`, which sends simpler replies to messages within team channels.
         
         Args:
             chat_id (string): chat-id
@@ -902,7 +902,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> Any:
         """
-        Retrieves a single, specific reply from a chat message thread using its unique ID, requiring the parent message and chat IDs. It targets one reply for detailed information, unlike `read_chat_replies` which lists all replies to a parent message.
+        Retrieves a specific reply from a chat message thread using the chat, parent message, and reply IDs. Unlike `list_chat_message_replies`, which fetches all replies, this function targets a single reply for detailed information, allowing for customized field selection.
         
         Args:
             chat_id (string): chat-id
@@ -968,7 +968,7 @@ class MsTeamsApp(APIApplication):
         template: Any | None = None,
     ) -> Any:
         """
-        Enables a Microsoft Teams instance for a pre-existing Microsoft 365 group, identified by its ID. This 'team-ifies' the group, allowing optional team properties to be configured. It differs from `create_team`, which provisions a new team and group simultaneously.
+        Enables Microsoft Teams functionality for a pre-existing Microsoft 365 group using its ID. This 'team-ifies' the group, allowing optional configuration of team properties. It differs from `create_team`, which provisions both a new team and its associated group simultaneously.
         
         Args:
             group_id (string): group-id
@@ -1191,7 +1191,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> Any:
         """
-        Retrieves detailed information for a specific channel within a Microsoft Teams team, identified by both team and channel IDs. Optional parameters allow for selecting specific properties or expanding related entities in the response to get more targeted data.
+        Retrieves detailed information for a specific channel within a Microsoft Teams team, identified by both team and channel IDs. Optional parameters can select specific properties or expand related entities in the response, distinguishing it from list_channels_for_team, which retrieves a collection of channels.
         
         Args:
             team_id (string): team-id
@@ -1251,7 +1251,7 @@ class MsTeamsApp(APIApplication):
         replies: list[Any] | None = None,
     ) -> Any:
         """
-        Updates properties of a specific message within a Microsoft Teams channel, identified by its team, channel, and message IDs. It applies modifications like changing the message body or attachments by sending a PATCH request to the Microsoft Graph API.
+        Updates an existing message within a Microsoft Teams channel, identified by team, channel, and message IDs. This function modifies the original message's properties, like its body, via a PATCH request, distinguishing it from functions that create new messages or update replies.
         
         Args:
             team_id (string): team-id
@@ -1467,7 +1467,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves a list of all tabs within a specific channel of a Microsoft Teams team. Supports advanced OData query parameters for filtering, sorting, and pagination, allowing for customized retrieval of the tab collection.
+        Retrieves a collection of tabs from a specified channel within a Microsoft Teams team. Unlike `get_channel_tab_details`, which fetches a single tab, this function lists all tabs and supports advanced OData query parameters for filtering, sorting, and pagination of the entire collection.
         
         Args:
             team_id (string): team-id
@@ -1523,7 +1523,7 @@ class MsTeamsApp(APIApplication):
         teamsApp: Any | None = None,
     ) -> Any:
         """
-        Adds a new tab to a specified channel within a Microsoft Teams team. It requires team and channel IDs to target the location, and accepts optional configuration details like the tab's display name and associated application to create the new tab.
+        Creates a new tab in a specified Microsoft Teams channel using team and channel IDs. This function configures the tab's initial properties, such as display name and application, distinguishing it from functions that list (`list_channel_tabs`) or modify (`update_channel_tab`) existing tabs.
         
         Args:
             team_id (string): team-id
@@ -1577,7 +1577,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> Any:
         """
-        Retrieves detailed information for a specific tab within a channel using its unique ID. Requires team and channel identifiers to locate the resource. This function fetches a single tab, unlike `get_channel_tabs` which lists all tabs for the channel.
+        Fetches properties for a single tab within a specific Microsoft Teams channel, identified by its team, channel, and tab IDs. Unlike `list_channel_tabs` which gets all tabs, this targets a specific one, with options to select fields or expand related entities in the response.
         
         Args:
             team_id (string): team-id
@@ -1622,7 +1622,7 @@ class MsTeamsApp(APIApplication):
         teamsApp: Any | None = None,
     ) -> Any:
         """
-        Updates an existing tab within a specific channel of a Microsoft Teams team. It identifies the tab using team, channel, and tab IDs to modify properties like its display name or configuration. This function performs a partial update on the tab's resource.
+        Modifies properties of an existing tab within a specific Microsoft Teams channel. It uses the team, channel, and tab IDs to target the tab, allowing for partial updates to its configuration or display name via a PATCH request, differentiating it from tab creation or deletion functions.
         
         Args:
             team_id (string): team-id
@@ -1671,7 +1671,7 @@ class MsTeamsApp(APIApplication):
         self, team_id: str, channel_id: str, teamsTab_id: str
     ) -> Any:
         """
-        Deletes a specific tab from a Microsoft Teams channel. The function requires the team ID, channel ID, and the tab's unique ID to target and permanently remove the specified tab from the channel's interface.
+        Permanently removes a specific tab from a Microsoft Teams channel using its unique ID, along with the parent team and channel IDs. This function is the destructive counterpart to `create_channel_tab`, designed to delete a tab rather than create, list, or update one.
         
         Args:
             team_id (string): team-id
@@ -1707,7 +1707,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> Any:
         """
-        Retrieves details for the primary channel (typically 'General') of a specified Microsoft Teams team. Optional parameters allow for selecting specific properties or expanding related entities in the API response. This differs from `get_team_channel_info`, which requires a specific channel ID.
+        Retrieves the primary channel (usually 'General') for a specified team using its ID. Unlike `get_channel_details`, this function directly accesses the team's default channel without requiring a specific channel ID. Optional parameters can select or expand properties in the returned data.
         
         Args:
             team_id (string): team-id
@@ -1745,7 +1745,7 @@ class MsTeamsApp(APIApplication):
         expand: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves the collection of applications installed in a specific user's personal Microsoft Teams scope. This function accepts optional parameters for filtering, sorting, and pagination, enabling customized queries to refine the list of apps returned from the Microsoft Graph API.
+        Retrieves applications installed in a user's personal Microsoft Teams scope, identified by their ID. Unlike `list_installed_chat_apps` which targets chat installations, this focuses on the user's scope. It supports optional OData parameters for filtering, sorting, and pagination to customize the returned app collection.
         
         Args:
             user_id (string): user-id