universal-mcp-applications 0.1.21__py3-none-any.whl → 0.1.22__py3-none-any.whl

universal_mcp/applications/hubspot/app.py

@@ -1,23 +1,25 @@
+from datetime import UTC, datetime
+from typing import Any
+
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
+
 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'
+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"
         self.crm = CrmApi(self)
         self.marketing = MarketingApi(self)
-    
+
     def add_a_note(
         self,
         hs_note_body: str,
-        hs_timestamp: Optional[str] = None,
-        associations: Optional[List[dict[str, Any]]] = None,
+        hs_timestamp: str | None = None,
+        associations: list[dict[str, Any]] | None = None,
     ) -> dict[str, Any]:
         """
         Create a note in HubSpot with the given properties and associations.
@@ -38,28 +40,30 @@ 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(timezone.utc).isoformat()
+            "hs_timestamp": hs_timestamp
+            if hs_timestamp
+            else datetime.now(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: Optional[List[str]] = None, includeFilters: Optional[bool] = None) -> dict[str, Any]:
+    def fetch_multiple_lists(
+        self, listIds: list[str] | None = None, includeFilters: bool | None = 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.
 
@@ -77,16 +81,20 @@ 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: Optional[str] = None,
-        before: Optional[str] = None,
-        limit: Optional[int] = None,
+        after: str | None = None,
+        before: str | None = None,
+        limit: int | None = None,
     ) -> dict[str, Any]:
         """
         Fetch the memberships of a list in order sorted by the recordId of the records in the list.
@@ -108,24 +116,34 @@ 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: 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]:
+    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]:
         """
-        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:
@@ -149,22 +167,31 @@ 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,
+            "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
         }
-        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: Optional[bool] = None) -> dict[str, Any]:
+    def get_list_by_id(
+        self, listId: str, includeFilters: bool | None = None
+    ) -> dict[str, Any]:
         """
         Fetch a single list by ILS list ID.
 
@@ -184,7 +211,9 @@ 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)
 
@@ -210,8 +239,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.
@@ -236,10 +265,15 @@ 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.
@@ -264,10 +298,24 @@ 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: 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]:
+    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]:
         """
         Search lists by list name or page through all lists by providing an empty query value.
 
@@ -299,21 +347,30 @@ class HubspotApp(APIApplication):
         """
         request_body_data = None
         request_body_data = {
-            'listIds': listIds,
-            'offset': offset,
-            'query': query,
-            'count': count,
-            'processingTypes': processingTypes,
-            'additionalProperties': additionalProperties,
-            'sort': sort,
+            "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
         }
-        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: Optional[bool] = None) -> dict[str, Any]:
+    def fetch_list_by_name(
+        self, objectTypeId: str, listName: str, includeFilters: bool | None = None
+    ) -> dict[str, Any]:
         """
         Fetch a list by its name and object type ID.
 
@@ -336,23 +393,25 @@ 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/jira/app.py

@@ -1,7 +1,6 @@
 from typing import Any
 
 import httpx
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 

universal_mcp/applications/linkedin/app.py

@@ -38,7 +38,7 @@ class LinkedinApp(APIApplication):
     ) -> dict[str, str]:
         """
         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.
             author (str): The URN of the author creating the post. Use "urn:li:person:{id}" for individual posts or "urn:li:organization:{id}" for company page posts. Example: "urn:li:person:wGgGaX_xbB" or "urn:li:organization:2414183"
@@ -46,17 +46,17 @@ class LinkedinApp(APIApplication):
             distribution (dict[str, Any], optional): Distribution settings for the post. If not provided, defaults to {"feedDistribution": "MAIN_FEED", "targetEntities": [], "thirdPartyDistributionChannels": []}. feedDistribution controls where the post appears in feeds, targetEntities specifies entities to target, and thirdPartyDistributionChannels defines external distribution channels.
             lifecycle_state (str): The state of the post. Use "PUBLISHED" for live posts accessible to all entities, "DRAFT" for posts accessible only to author, "PUBLISH_REQUESTED" for posts submitted but processing, or "PUBLISH_FAILED" for posts that failed to publish. Defaults to "PUBLISHED".
             is_reshare_disabled (bool): Whether resharing is disabled by the author. Set to True to prevent other users from resharing this post, or False to allow resharing. Defaults to False.
-        
+
         Returns:
             dict[str, str]: Dictionary containing the post ID with key "post_id". Example: {"post_id": "urn:li:share:6844785523593134080"}
-        
+
         Raises:
             ValueError: If required parameters (commentary, author) are missing or if x-restli-id header is not found
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body
-        
+
         Notes:
             Requires LinkedIn API permissions: w_member_social (for individual posts) or w_organization_social (for company posts). All requests require headers: X-Restli-Protocol-Version: 2.0.0 and LinkedIn-Version: 202507. Rate limits: 150 requests per day per member, 100,000 requests per day per application. The Posts API replaces the deprecated ugcPosts API.
-        
+
         Tags:
             posts, important
         """
@@ -100,14 +100,14 @@ class LinkedinApp(APIApplication):
     def get_authenticated_user_profile(self) -> dict[str, Any]:
         """
         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.
-        
+
         Raises:
             ValueError: If integration is not found
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body
-        
+
         Tags:
             profile, info
         """
@@ -124,18 +124,18 @@ class LinkedinApp(APIApplication):
     def delete_post(self, post_urn: str) -> dict[str, str]:
         """
         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}).
-        
+
         Returns:
             dict[str, str]: Dictionary containing the deletion status. Example: {"status": "deleted", "post_urn": "urn:li:share:6844785523593134080"}
-        
+
         Raises:
             ValueError: If required parameter (post_urn) is missing or if integration is not found
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body
-        
-        
+
+
         Tags:
             posts, important
         """
@@ -164,7 +164,7 @@ class LinkedinApp(APIApplication):
     ) -> dict[str, str]:
         """
         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}).
             commentary (str | None, optional): The user generated commentary of this post in little format.
@@ -173,17 +173,17 @@ class LinkedinApp(APIApplication):
             lifecycle_state (str | None, optional): The state of the content. Can be DRAFT, PUBLISHED, PUBLISH_REQUESTED, or PUBLISH_FAILED.
             ad_context_name (str | None, optional): Update the name of the sponsored content.
             ad_context_status (str | None, optional): Update the status of the sponsored content.
-        
+
         Returns:
             dict[str, str]: Dictionary containing the update status. Example: {"status": "updated", "post_urn": "urn:li:share:6844785523593134080"}
-        
+
         Raises:
             ValueError: If required parameter (post_urn) is missing or if integration is not found
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body
-        
-        
-        
-        
+
+
+
+
         Tags:
             posts, update, important
         """

universal_mcp/applications/markitdown/app.py

@@ -1,8 +1,9 @@
 import re
 
-from markitdown import MarkItDown
 from universal_mcp.applications.application import BaseApplication
 
+from markitdown import MarkItDown
+
 
 class MarkitdownApp(BaseApplication):
     def __init__(self, **kwargs):
@@ -61,11 +62,15 @@ class MarkitdownApp(BaseApplication):
             self.convert_to_markdown,
         ]
 
+
 async def main():
     app = MarkitdownApp()
-    result = await app.convert_to_markdown("https://www.youtube.com/watch?v=Cr9B6yyLZSk")
-    print(result)
-    
+    await app.convert_to_markdown(
+        "https://www.youtube.com/watch?v=Cr9B6yyLZSk"
+    )
+
+
 if __name__ == "__main__":
     import asyncio
-    asyncio.run(main())
+
+    asyncio.run(main())