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

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

universal_mcp/applications/neon/README.md

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

universal_mcp/applications/openai/README.md

@@ -1,22 +1,23 @@
-# OpenAI MCP Server
+# OpenaiApp MCP Server
 
-An MCP Server for the OpenAI API.
+An MCP Server for the OpenaiApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the OpenAI API.
+This is automatically generated from OpenAPI schema for the OpenaiApp API.
 
-| Tool                     | Description                                                               |
-| ------------------------ | ------------------------------------------------------------------------- |
-| `create_chat_completion` | Creates a model response for the given chat conversation.                 |
-| `upload_file`            | Upload a file that can be used across various OpenAI API endpoints.       |
-| `list_files`             | Lists the files that have been uploaded to your OpenAI account.           |
-| `retrieve_file`          | Retrieves information about a specific file.                              |
-| `delete_file`            | Deletes a file.                                                           |
-| `retrieve_file_content`  | Retrieves the content of the specified file.                              |
-| `generate_image`         | Creates an image given a prompt.                                          |
-| `create_image_edit`      | Creates an edited or extended image given an original image and a prompt. |
-| `create_image_variation` | Creates a variation of a given image.                                     |
-| `create_transcription`   | Transcribes audio into the input language.                                |
-| `create_translation`     | Translates audio into English text.                                       |
-| `create_speech`          | Generates audio from the input text.                                      |
+
+| Tool | Description |
+|------|-------------|
+| `create_chat_completion` | Generates a model response for a chat conversation. It supports both standard and streaming modes; if streaming, it internally aggregates response chunks into a single complete object, simplifying stream handling. Returns the completion data as a dictionary on success or an error string on failure. |
+| `upload_file` | Uploads a file to the user's OpenAI account for use across various endpoints like 'assistants'. It accepts a file path or object and a purpose string, returning a dictionary with the created file object's details upon success. |
+| `list_files` | Retrieves a paginated list of files uploaded to the OpenAI account. Allows filtering by purpose and controlling the output with limit, `after` cursor, and sort order parameters to efficiently navigate through the file collection. |
+| `retrieve_file_metadata` | Retrieves the metadata (e.g., purpose, creation date) for a specific file from the OpenAI account using its ID. Unlike `retrieve_file_content`, this function does not download the file's contents. It returns a dictionary with file details on success or an error string on failure. |
+| `delete_file` | Permanently deletes a file from the user's OpenAI account using its unique file ID. This action is irreversible. It returns a dictionary confirming the deletion on success or an error message string on failure. This is the 'delete' operation in the file management lifecycle. |
+| `retrieve_file_content` | Retrieves a file's content from OpenAI using its ID. It returns plain text for common text formats (e.g., JSON, CSV). For binary or undecodable files, it returns a dictionary with base64-encoded data, differentiating it from `retrieve_file` which only fetches metadata. |
+| `create_image` | Generates new images from a textual prompt using OpenAI's DALL-E models. It allows customization of parameters like image size, quality, style, and response format (URL or base64 JSON). Unlike other image functions in this class, it creates images entirely from scratch based on text. |
+| `create_image_edit` | Modifies a source image using the DALL-E 2 model based on a text prompt. An optional mask can be supplied to specify the exact area for editing. This function is distinct from generating images from scratch (`generate_image`) or creating simple variations (`create_image_variation`). |
+| `create_image_variation` | Generates one or more variations of a provided image using the OpenAI API, specifically the DALL-E 2 model. It allows customization of the number, size, and response format of the resulting images. Returns a dictionary with image data on success or an error string on failure. |
+| `transcribe_audio` | Transcribes an audio file into text in its original language using models like Whisper or GPT-4o. It supports multiple response formats and internally aggregates streaming data into a final object. This differs from `create_translation`, which translates audio specifically into English text. |
+| `create_translation` | Translates audio from any supported language into English text using OpenAI's API. Unlike `create_transcription`, which converts audio to text in its original language, this function's output is always English. It supports various response formats like JSON, text, or SRT for the translated content. |
+| `create_speech` | Generates audio from input text using a specified TTS model and voice. This text-to-speech function allows customizing audio format and speed. On success, it returns a dictionary containing the base64-encoded audio content and its corresponding MIME type, or an error string on failure. |

universal_mcp/applications/outlook/README.md

@@ -9,12 +9,12 @@ This is automatically generated from OpenAPI schema for the OutlookApp API.
 
 | Tool | Description |
 |------|-------------|
-| `users_message_reply` | Replies to a specific message for a user using the POST method, accepting JSON content in the request body and returning status codes indicating success or error. |
-| `user_send_mail` | Sends an email on behalf of the specified user, accepting the email details as JSON in the request body and returning a 204 No Content response on success. |
-| `user_get_mail_folder` | Retrieves a specific mail folder for a specified user using optional query parameters to include hidden folders or select/expand properties. |
-| `user_list_message` | Retrieves a list of messages for a user, allowing optional filtering and sorting of results based on parameters such as includeHiddenMessages, search, filter, top, skip, orderby, select, and expand. |
-| `user_get_message` | Retrieves a specific message for a user, optionally including hidden messages, selecting specific fields, or expanding related data. |
-| `user_delete_message` | Deletes a specific message for a given user using the DELETE method and optional If-Match header for conditional requests. |
-| `user_message_list_attachment` | Retrieves attachments associated with a specified user's message, supporting filtering, pagination, and field selection via query parameters. |
-| `get_user_id` | Retrieves the current user. |
-| `get_from_url` | Makes a GET request to a full @odata.nextLink or @odata.deltaLink URL. |
+| `reply_to_message` | Replies to an email using its message ID, with either a simple comment or a full message object including attachments. Unlike `send_mail`, which creates a new email, this function targets an existing message. It defaults to the current user if no user ID is specified. |
+| `send_mail` | Sends a new email on behalf of a specified or current user, using a dictionary for content like recipients and subject. Unlike `reply_to_message`, which replies to an existing message, this function composes and sends an entirely new email from scratch. |
+| `get_mail_folder` | Retrieves a specific mail folder's metadata by its ID for a given user. The response can be customized to include hidden folders or select specific properties. Unlike `list_user_messages`, this function fetches folder details, not the emails contained within it. |
+| `list_user_messages` | Retrieves a list of messages from a user's mailbox. This function supports powerful querying using optional parameters for filtering, searching, sorting, and pagination, unlike `get_user_message`, which fetches a single email by its ID. |
+| `get_user_message` | Retrieves a specific email message by its ID for a given user, with options to select specific fields or expand related data. Unlike `list_user_messages`, which fetches a collection of emails with advanced filtering, this function is designed to retrieve a single, known message. |
+| `user_delete_message` | Permanently deletes a specific email, identified by `message_id`, from a user's mailbox. If `user_id` is not provided, it defaults to the current authenticated user. Unlike retrieval functions such as `get_user_message`, this performs a destructive action to remove the specified email from Outlook. |
+| `list_message_attachments` | Retrieves attachments for a specific email message, identified by its ID. Supports advanced querying for filtering, sorting, and pagination, allowing users to select specific fields to return in the result set, focusing only on attachments rather than the full message content. |
+| `get_current_user_profile` | Fetches the `userPrincipalName` for the currently authenticated user from the `/me` endpoint. This internal helper is used by other methods to automatically obtain the user's ID for API calls when a `user_id` is not explicitly provided. |
+| `get_next_page` | Executes a GET request for a full URL, typically the `@odata.nextLink` from a previous paginated API response. It simplifies retrieving subsequent pages of data from list functions by handling URL validation and parsing before fetching the results for the next page. |

universal_mcp/applications/outlook/app.py

@@ -18,7 +18,7 @@ class OutlookApp(APIApplication):
         message: dict[str, Any] | None = None,
     ) -> Any:
         """
-        Replies to a specific email message identified by its ID. The reply can contain a simple comment or a full message object with attachments. If no user ID is provided, it defaults to the current user, distinguishing it from `user_send_mail` which sends a new email.
+        Replies to an email using its message ID, with either a simple comment or a full message object including attachments. Unlike `send_mail`, which creates a new email, this function targets an existing message. It defaults to the current user if no user ID is specified.
         
         Args:
             user_id (string, optional): user-id. If not provided, will automatically get the current user's ID.
@@ -70,7 +70,7 @@ class OutlookApp(APIApplication):
         saveToSentItems: bool | None = None,
     ) -> Any:
         """
-        Sends a new email on behalf of a user, using a provided dictionary for content like recipients and subject. Unlike `users_message_reply`, which replies to an existing message, this function is used to compose and send an entirely new email from scratch.
+        Sends a new email on behalf of a specified or current user, using a dictionary for content like recipients and subject. Unlike `reply_to_message`, which replies to an existing message, this function composes and sends an entirely new email from scratch.
         
         Args:
             user_id (string, optional): user-id. If not provided, will automatically get the current user's ID.
@@ -121,7 +121,7 @@ class OutlookApp(APIApplication):
         expand: list[str] | None = None,
     ) -> Any:
         """
-        Retrieves a specific mail folder by its ID for a given user. Allows customization of the response by optionally including hidden folders, selecting specific properties to return, or expanding related entities. It specifically targets folder metadata, not the messages within.
+        Retrieves a specific mail folder's metadata by its ID for a given user. The response can be customized to include hidden folders or select specific properties. Unlike `list_user_messages`, this function fetches folder details, not the emails contained within it.
         
         Args:
             user_id (string, optional): user-id. If not provided, will automatically get the current user's ID.
@@ -176,7 +176,7 @@ class OutlookApp(APIApplication):
         expand: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves a list of messages from a user's mailbox. This function supports powerful querying using optional parameters for filtering, searching, sorting, and pagination, unlike `user_get_message`, which fetches a single email by its ID.
+        Retrieves a list of messages from a user's mailbox. This function supports powerful querying using optional parameters for filtering, searching, sorting, and pagination, unlike `get_user_message`, which fetches a single email by its ID.
         
         Args:
             user_id (string, optional): user-id. If not provided, will automatically get the current user's ID.
@@ -250,7 +250,7 @@ class OutlookApp(APIApplication):
         expand: list[str] | None = None,
     ) -> Any:
         """
-        Retrieves a specific message by its ID for a user, with options to select fields or expand related data. This function fetches a single item, in contrast to `user_list_message` which retrieves a collection of messages.
+        Retrieves a specific email message by its ID for a given user, with options to select specific fields or expand related data. Unlike `list_user_messages`, which fetches a collection of emails with advanced filtering, this function is designed to retrieve a single, known message.
         
         Args:
             user_id (string, optional): user-id. If not provided, will automatically get the current user's ID.
@@ -293,7 +293,7 @@ class OutlookApp(APIApplication):
 
     def user_delete_message(self, message_id: str, user_id: str | None = None) -> Any:
         """
-        Deletes a specific Outlook message for a user, identified by its unique `message_id`. If `user_id` is not provided, it automatically targets the currently authenticated user's mailbox. It makes a DELETE request to the corresponding Microsoft Graph API endpoint to permanently remove the message.
+        Permanently deletes a specific email, identified by `message_id`, from a user's mailbox. If `user_id` is not provided, it defaults to the current authenticated user. Unlike retrieval functions such as `get_user_message`, this performs a destructive action to remove the specified email from Outlook.
         
         Args:
             user_id (string, optional): user-id. If not provided, will automatically get the current user's ID.
@@ -337,7 +337,7 @@ class OutlookApp(APIApplication):
         expand: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves attachments for a specific email message, identified by its ID. Supports advanced querying for filtering, sorting, and pagination, allowing users to select specific fields to return in the result set.
+        Retrieves attachments for a specific email message, identified by its ID. Supports advanced querying for filtering, sorting, and pagination, allowing users to select specific fields to return in the result set, focusing only on attachments rather than the full message content.
         
         Args:
             user_id (string, optional): user-id. If not provided, will automatically get the current user's ID.
@@ -392,7 +392,7 @@ class OutlookApp(APIApplication):
         self,
     ) -> dict[str, Any]:
         """
-        Fetches the `userPrincipalName` for the currently authenticated user from the `/me` endpoint. It is a helper function used internally by other methods to automatically obtain the user's ID for API calls when one is not explicitly provided.
+        Fetches the `userPrincipalName` for the currently authenticated user from the `/me` endpoint. This internal helper is used by other methods to automatically obtain the user's ID for API calls when a `user_id` is not explicitly provided.
         
         
         Returns:
@@ -413,7 +413,7 @@ class OutlookApp(APIApplication):
 
     def get_next_page(self, url: str) -> dict[str, Any]:
         """
-        Executes a GET request using a full URL, typically a pagination link (`@odata.nextLink`) from a previous API response. It validates the URL, extracts the relative path and query parameters, and fetches the corresponding data, simplifying navigation through paginated API results.
+        Executes a GET request for a full URL, typically the `@odata.nextLink` from a previous paginated API response. It simplifies retrieving subsequent pages of data from list functions by handling URL validation and parsing before fetching the results for the next page.
         """
         if not url:
             raise ValueError("Missing required parameter 'url'.")

universal_mcp/applications/perplexity/README.md

@@ -1,12 +1,12 @@
-# Perplexity MCP Server
+# PerplexityApp MCP Server
 
-An MCP Server for the Perplexity API.
+An MCP Server for the PerplexityApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Perplexity API.
+This is automatically generated from OpenAPI schema for the PerplexityApp API.
 
 
 | Tool | Description |
 |------|-------------|
-| `chat` | Initiates a chat completion request to generate AI responses using various models with customizable parameters. |
+| `answer_with_search` | Queries the Perplexity Chat Completions API for a web-search-grounded answer. It sends the user's prompt and model parameters to the `/chat/completions` endpoint, then parses the response to return the synthesized content and a list of supporting source citations, ideal for real-time information retrieval. |