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

universal_mcp/applications/hubspot/app.py

@@ -1,38 +1,23 @@
-from datetime import UTC, datetime
-from typing import Any
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
-
-
-class CrmApi:
-    def __init__(self, api_client):
-        pass
-
-    def list_tools(self):
-        return []
-
-
-class MarketingApi:
-    def __init__(self, api_client):
-        pass
-
-    def list_tools(self):
-        return []
-
+from universal_mcp.applications.hubspot.api_segments.crm_api import CrmApi
+from universal_mcp.applications.hubspot.api_segments.marketing_api import MarketingApi
+from typing import List, Optional, Any
+from datetime import datetime, timezone
 
 class HubspotApp(APIApplication):
-    def __init__(self, integration: Integration = None, **kwargs) -> None:
-        super().__init__(name="hubspot", integration=integration, **kwargs)
-        self.base_url = "https://api.hubapi.com"
+
+    def __init__(self, integration: Integration=None, **kwargs) -> None:
+        super().__init__(name='hubspot', integration=integration, **kwargs)
+        self.base_url = 'https://api.hubapi.com'
         self.crm = CrmApi(self)
         self.marketing = MarketingApi(self)
-
+    
     def add_a_note(
         self,
         hs_note_body: str,
-        hs_timestamp: str | None = None,
-        associations: list[dict[str, Any]] | None = None,
+        hs_timestamp: Optional[str] = None,
+        associations: Optional[List[dict[str, Any]]] = None,
     ) -> dict[str, Any]:
         """
         Create a note in HubSpot with the given properties and associations.
@@ -53,30 +38,28 @@ class HubspotApp(APIApplication):
         """
         if hs_note_body is None:
             raise ValueError("Missing required parameter 'hs_note_body'.")
-
+        
         url = f"{self.base_url}/crm/v3/objects/notes"
-
+        
         # Build the properties object
         properties = {
             "hs_note_body": hs_note_body,
-            "hs_timestamp": hs_timestamp
-            if hs_timestamp
-            else datetime.now(UTC).isoformat(),
+            "hs_timestamp": hs_timestamp if hs_timestamp else datetime.now(timezone.utc).isoformat()
         }
-
+        
         # Build the request body
-        request_body_data: dict[str, Any] = {"properties": properties}
-
+        request_body_data: dict[str, Any] = {
+            "properties": properties
+        }
+        
         # Add associations if provided
         if associations:
             request_body_data["associations"] = associations
-
+        
         response = self._post(url, data=request_body_data)
         return self._handle_response(response)
 
-    def fetch_multiple_lists(
-        self, listIds: list[str] | None = None, includeFilters: bool | None = None
-    ) -> dict[str, Any]:
+    def fetch_multiple_lists(self, listIds: Optional[List[str]] = None, includeFilters: Optional[bool] = None) -> dict[str, Any]:
         """
         Fetch multiple lists in a single request by ILS list ID. The response will include the definitions of all lists that exist for the listIds provided.
 
@@ -94,20 +77,16 @@ class HubspotApp(APIApplication):
             Lists
         """
         url = f"{self.base_url}/crm/v3/lists/"
-        query_params = {
-            k: v
-            for k, v in [("listIds", listIds), ("includeFilters", includeFilters)]
-            if v is not None
-        }
+        query_params = {k: v for k, v in [('listIds', listIds), ('includeFilters', includeFilters)] if v is not None}
         response = self._get(url, params=query_params)
-        return self._handle_response(response)
+        return self._handle_response(response)   
 
     def fetch_list_memberships(
         self,
         listId: str,
-        after: str | None = None,
-        before: str | None = None,
-        limit: int | None = None,
+        after: Optional[str] = None,
+        before: Optional[str] = None,
+        limit: Optional[int] = None,
     ) -> dict[str, Any]:
         """
         Fetch the memberships of a list in order sorted by the recordId of the records in the list.
@@ -129,34 +108,24 @@ class HubspotApp(APIApplication):
         """
         if listId is None:
             raise ValueError("Missing required parameter 'listId'.")
-
+        
         url = f"{self.base_url}/crm/v3/lists/{listId}/memberships"
         query_params = {}
-
+        
         if after is not None:
             query_params["after"] = after
         if before is not None:
             query_params["before"] = before
         if limit is not None:
             query_params["limit"] = limit
-
+        
         response = self._get(url, params=query_params)
         return self._handle_response(response)
 
-    def create_list(
-        self,
-        objectTypeId: str,
-        processingType: str,
-        name: str,
-        membershipSettings: dict[str, Any] | None = None,
-        customProperties: dict[str, str] | None = None,
-        listFolderId: int | None = None,
-        listPermissions: dict[str, Any] | None = None,
-        filterBranch: Any | None = None,
-    ) -> dict[str, Any]:
+    def create_list(self, objectTypeId: str, processingType: str, name: str, membershipSettings: Optional[dict[str, Any]] = None, customProperties: Optional[dict[str, str]] = None, listFolderId: Optional[int] = None, listPermissions: Optional[dict[str, Any]] = None, filterBranch: Optional[Any] = None) -> dict[str, Any]:
         """
-        Create a new list in HubSpot with the specified object type, processing type, and name.
-        Optionally use this to provide membership settings, custom properties, a folder ID, list permissions,
+        Create a new list in HubSpot with the specified object type, processing type, and name. 
+        Optionally use this to provide membership settings, custom properties, a folder ID, list permissions, 
         and a filter branch to further configure the list.
 
         Args:
@@ -180,31 +149,22 @@ class HubspotApp(APIApplication):
         """
         request_body_data = None
         request_body_data = {
-            "membershipSettings": membershipSettings,
-            "objectTypeId": objectTypeId,
-            "processingType": processingType,
-            "customProperties": customProperties,
-            "listFolderId": listFolderId,
-            "name": name,
-            "listPermissions": listPermissions,
-            "filterBranch": filterBranch,
-        }
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
+            'membershipSettings': membershipSettings,
+            'objectTypeId': objectTypeId,
+            'processingType': processingType,
+            'customProperties': customProperties,
+            'listFolderId': listFolderId,
+            'name': name,
+            'listPermissions': listPermissions,
+            'filterBranch': filterBranch,
         }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.base_url}/crm/v3/lists/"
         query_params = {}
-        response = self._post(
-            url,
-            data=request_body_data,
-            params=query_params,
-            content_type="application/json",
-        )
+        response = self._post(url, data=request_body_data, params=query_params, content_type='application/json')
         return self._handle_response(response)
 
-    def get_list_by_id(
-        self, listId: str, includeFilters: bool | None = None
-    ) -> dict[str, Any]:
+    def get_list_by_id(self, listId: str, includeFilters: Optional[bool] = None) -> dict[str, Any]:
         """
         Fetch a single list by ILS list ID.
 
@@ -224,9 +184,7 @@ class HubspotApp(APIApplication):
         if listId is None:
             raise ValueError("Missing required parameter 'listId'.")
         url = f"{self.base_url}/crm/v3/lists/{listId}"
-        query_params = {
-            k: v for k, v in [("includeFilters", includeFilters)] if v is not None
-        }
+        query_params = {k: v for k, v in [('includeFilters', includeFilters)] if v is not None}
         response = self._get(url, params=query_params)
         return self._handle_response(response)
 
@@ -252,8 +210,8 @@ class HubspotApp(APIApplication):
         query_params = {}
         response = self._delete(url, params=query_params)
         return self._handle_response(response)
-
-    def add_records_to_list(self, listId: str, items: list[str]) -> dict[str, Any]:
+      
+    def add_records_to_list(self, listId: str, items: List[str]) -> dict[str, Any]:
         """
         Add the records provided to the list. Records that do not exist or that are already members of the list are ignored.
         This only works for lists that have a processingType of MANUAL or SNAPSHOT.
@@ -278,15 +236,10 @@ class HubspotApp(APIApplication):
         request_body_data = items
         url = f"{self.base_url}/crm/v3/lists/{listId}/memberships/add"
         query_params = {}
-        response = self._put(
-            url,
-            data=request_body_data,
-            params=query_params,
-            content_type="application/json",
-        )
-        return self._handle_response(response)
+        response = self._put(url, data=request_body_data, params=query_params, content_type='application/json')
+        return self._handle_response(response) 
 
-    def remove_records_from_list(self, listId: str, items: list[str]) -> dict[str, Any]:
+    def remove_records_from_list(self, listId: str, items: List[str]) -> dict[str, Any]:
         """
         Remove the records provided from the list. Records that are not members of the list are ignored.
         This only works for lists that have a processingType of MANUAL or SNAPSHOT.
@@ -311,24 +264,10 @@ class HubspotApp(APIApplication):
         request_body_data = items
         url = f"{self.base_url}/crm/v3/lists/{listId}/memberships/remove"
         query_params = {}
-        response = self._put(
-            url,
-            data=request_body_data,
-            params=query_params,
-            content_type="application/json",
-        )
+        response = self._put(url, data=request_body_data, params=query_params, content_type='application/json')
         return self._handle_response(response)
 
-    def search_lists(
-        self,
-        listIds: list[str] | None = None,
-        offset: int | None = None,
-        query: str | None = None,
-        count: int | None = None,
-        processingTypes: list[str] | None = None,
-        additionalProperties: list[str] | None = None,
-        sort: str | None = None,
-    ) -> dict[str, Any]:
+    def search_lists(self, listIds: Optional[List[str]] = None, offset: Optional[int] = None, query: Optional[str] = None, count: Optional[int] = None, processingTypes: Optional[List[str]] = None, additionalProperties: Optional[List[str]] = None, sort: Optional[str] = None) -> dict[str, Any]:
         """
         Search lists by list name or page through all lists by providing an empty query value.
 
@@ -360,30 +299,21 @@ class HubspotApp(APIApplication):
         """
         request_body_data = None
         request_body_data = {
-            "listIds": listIds,
-            "offset": offset,
-            "query": query,
-            "count": count,
-            "processingTypes": processingTypes,
-            "additionalProperties": additionalProperties,
-            "sort": sort,
-        }
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
+            'listIds': listIds,
+            'offset': offset,
+            'query': query,
+            'count': count,
+            'processingTypes': processingTypes,
+            'additionalProperties': additionalProperties,
+            'sort': sort,
         }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.base_url}/crm/v3/lists/search"
         query_params = {}
-        response = self._post(
-            url,
-            data=request_body_data,
-            params=query_params,
-            content_type="application/json",
-        )
+        response = self._post(url, data=request_body_data, params=query_params, content_type='application/json')
         return self._handle_response(response)
 
-    def fetch_list_by_name(
-        self, objectTypeId: str, listName: str, includeFilters: bool | None = None
-    ) -> dict[str, Any]:
+    def fetch_list_by_name(self, objectTypeId: str, listName: str, includeFilters: Optional[bool] = None) -> dict[str, Any]:
         """
         Fetch a list by its name and object type ID.
 
@@ -406,25 +336,23 @@ class HubspotApp(APIApplication):
         if listName is None:
             raise ValueError("Missing required parameter 'listName'.")
         url = f"{self.base_url}/crm/v3/lists/object-type-id/{objectTypeId}/name/{listName}"
-        query_params = {
-            k: v for k, v in [("includeFilters", includeFilters)] if v is not None
-        }
+        query_params = {k: v for k, v in [('includeFilters', includeFilters)] if v is not None}
         response = self._get(url, params=query_params)
         return self._handle_response(response)
 
+
     def list_tools(self):
         all_tools = [
-            self.add_a_note,
-            self.fetch_multiple_lists,
-            self.fetch_list_memberships,
-            self.create_list,
-            self.get_list_by_id,
-            self.delete_list_by_id,
-            self.add_records_to_list,
-            self.remove_records_from_list,
-            self.search_lists,
-            self.fetch_list_by_name,
-        ]
+         self.add_a_note,
+         self.fetch_multiple_lists,
+         self.fetch_list_memberships,
+         self.create_list,
+         self.get_list_by_id,
+         self.delete_list_by_id,
+         self.add_records_to_list, 
+         self.remove_records_from_list,
+         self.search_lists, 
+         self.fetch_list_by_name]
         all_tools.extend(self.crm.list_tools())
         all_tools.extend(self.marketing.list_tools())
-        return all_tools
+        return all_tools

universal_mcp/applications/klaviyo/README.md

@@ -275,39 +275,3 @@ This is automatically generated from OpenAPI schema for the KlaviyoApp API.
 | `update_webhook` | Updates the webhook resource identified by {id} using partial modifications, requiring a revision header and returning appropriate status codes for success (200), client errors (400), or server errors (500). |
 | `get_webhook_topics` | Retrieves webhook topics with an optional revision header parameter, returning 200, 400, or 500 status codes. |
 | `get_webhook_topic` | Retrieves a webhook topic by its ID using the GET method, supporting revision information via a header parameter, and returns responses for successful retrieval (200), bad requests (400), and internal server errors (500). |
-
-
-## 📁 Project Structure
-
-The generated project has a standard layout:
-```
-.
-├── src/                  # Source code directory
-│   └── universal_mcp_klaviyoapp/
-│       ├── __init__.py
-│       └── mcp.py        # Server is launched here
-│       └── app.py        # Application tools are defined here
-├── tests/                # Directory for project tests
-├── .env                  # Environment variables (for local development)
-├── pyproject.toml        # Project dependencies managed by uv
-├── README.md             # This file
-```
-
-## 📝 License
-
-This project is licensed under the MIT License.
-
----
-
-_This project was generated using **MCP CLI** — Happy coding! 🚀_
-
-## Usage
-
-- Login to AgentR
-- Follow the quickstart guide to setup MCP Server for your client
-- Visit Apps Store and enable the KlaviyoApp app
-- Restart the MCP Server
-
-### Local Development
-
-- Follow the README to test with the local MCP Server 

universal_mcp/applications/linkedin/README.md

@@ -9,7 +9,7 @@ This is automatically generated from OpenAPI schema for the LinkedinApp API.
 
 | Tool | Description |
 |------|-------------|
-| `create_post` | Create a post on LinkedIn. |
-| `get_your_info` | Get your LinkedIn profile information. |
-| `delete_post` | Delete a post on LinkedIn. |
-| `update_post` | Update a post on LinkedIn. |
+| `create_post` | 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. |
+| `get_authenticated_user_profile` | 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. |
+| `delete_post` | 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. |
+| `update_post` | 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. |

universal_mcp/applications/mailchimp/README.md

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

universal_mcp/applications/ms_teams/README.md

@@ -9,34 +9,34 @@ This is automatically generated from OpenAPI schema for the MsTeamsApp API.
 
 | Tool | Description |
 |------|-------------|
-| `list_chats` | List chats |
-| `get_joined_teams` | Fetches a list of the Microsoft Teams the user has joined. |
-| `list_channels_for_team` | List channels |
-| `send_chat_message` | Sends a message to a specific chat. |
-| `send_channel_message` | Sends a message to a specific channel in a Microsoft Teams team. |
-| `reply_to_channel_message` | Sends a reply to a specific message in a channel. |
-| `create_chat_operation` | Create chat |
-| `get_chat` | Get chat |
-| `update_chat_details` | Update chat |
-| `list_chat_apps` | List apps in chat |
-| `list_chat_members` | List conversationMembers |
-| `add_member_to_chat` | Add member to a chat |
-| `get_chat_member_details` | Get conversationMember |
-| `delete_chat_member` | Remove member from chat |
-| `list_chat_messages` | List messages in a chat |
-| `get_chat_message_detail` | Get chatMessage in a channel or chat |
-| `read_chat_replies` | Get replies from chats |
-| `create_chat_reply` | Create new navigation property to replies for chats |
-| `get_chat_replies` | Get replies from chats |
-| `create_team_from_group` | Create team from group |
-| `create_team` | Create team |
-| `get_team_channel_info` | Get channel |
-| `update_chat_message_by_team_channel` | Update chatMessage |
-| `update_message_reply` | Update the navigation property replies in teams |
-| `get_channel_tabs` | List tabs in channel |
-| `add_channel_tab` | Add tab to channel |
-| `get_team_tab_info` | Get tab |
-| `update_tab_info` | Update tab |
-| `delete_channel_tab_by_id` | Delete tab from channel |
-| `get_primary_team_channel` | Get primaryChannel |
-| `get_user_installed_apps` | List apps installed for user |
+| `get_user_chats` | Retrieves a collection of chats the authenticated user is participating in. Supports optional OData query parameters for advanced filtering, sorting, pagination, and field selection, enabling customized data retrieval from the Microsoft Graph API. |
+| `get_joined_teams` | 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. |
+| `list_channels_for_team` | 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`. |
+| `send_chat_message` | 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. |
+| `send_channel_message` | 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. |
+| `reply_to_channel_message` | 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. |
+| `create_chat` | 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`). |
+| `get_chat_details` | 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. |
+| `update_chat_details` | 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. |
+| `list_installed_chat_apps` | 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. |
+| `list_chat_members` | 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. |
+| `add_member_to_chat` | 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. |
+| `get_chat_member` | 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. |
+| `delete_chat_member` | 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`. |
+| `list_chat_messages` | 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. |
+| `get_chat_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. |
+| `list_chat_message_replies` | 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. |
+| `reply_to_chat_message` | 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. |
+| `get_chat_reply_details` | 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. |
+| `create_team_from_group` | 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. |
+| `create_team` | Creates a new Microsoft Team and its associated Microsoft 365 group. This method builds a team from scratch, allowing specification of initial properties like display name, description, and members. It differs from `create_team_from_group`, which enables team functionality for an existing group. |
+| `get_channel_details` | 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. |
+| `update_channel_message` | 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. |
+| `update_channel_message_reply` | Updates an existing reply to a specific message within a Microsoft Teams channel. It identifies the target reply using team, channel, parent message, and reply IDs, modifying its properties (e.g., body content, attachments) via a PATCH request. |
+| `list_channel_tabs` | 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. |
+| `create_channel_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. |
+| `get_channel_tab_details` | 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. |
+| `update_channel_tab` | 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. |
+| `delete_channel_tab` | 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. |
+| `get_primary_team_channel` | 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. |
+| `list_user_installed_apps` | 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. |

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/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. |