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

universal_mcp/applications/canva/app.py

@@ -12,13 +12,13 @@ class CanvaApp(APIApplication):
     def get_app_jwks(self, appId) -> dict[str, Any]:
         """
         Retrieves the JSON Web Key Set (JWKS) for a given application ID. The JWKS contains public keys essential for verifying the authenticity of JSON Web Tokens (JWTs) issued by the application, ensuring secure communication.
-        
+
         Args:
             appId (string): appId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             app
         """
@@ -33,13 +33,13 @@ class CanvaApp(APIApplication):
     def get_asset(self, assetId) -> dict[str, Any]:
         """
         Fetches the details of a specific asset using its unique identifier. This function performs a GET request to retrieve asset data, distinguishing it from other functions that update (`v1_assets_assetid2`, `v1_assets_assetid3`) or delete (`v1_assets_assetid`) assets at the same endpoint.
-        
+
         Args:
             assetId (string): assetId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             asset
         """
@@ -54,7 +54,7 @@ class CanvaApp(APIApplication):
     def post_update_asset(self, assetId, name=None, tags=None) -> dict[str, Any]:
         """
         Updates an asset's name and tags by its ID using an HTTP POST request. This method is distinct from the PATCH-based update function (`v1_assets_assetid2`), which performs a similar action on the same `/v1/assets/{assetId}` endpoint.
-        
+
         Args:
             assetId (string): assetId
             name (string): name Example: '<string>'.
@@ -69,10 +69,10 @@ class CanvaApp(APIApplication):
                   ]
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             asset
         """
@@ -92,13 +92,13 @@ class CanvaApp(APIApplication):
     def delete_asset(self, assetId) -> Any:
         """
         Deletes a specific Canva asset identified by its unique ID. This function sends an HTTP DELETE request to the `/v1/assets/{assetId}` endpoint to permanently remove the resource, returning the API's confirmation response upon successful completion.
-        
+
         Args:
             assetId (string): assetId
-        
+
         Returns:
             Any: OK
-        
+
         Tags:
             asset
         """
@@ -113,7 +113,7 @@ class CanvaApp(APIApplication):
     def patch_asset(self, assetId, name=None, tags=None) -> dict[str, Any]:
         """
         Partially updates an asset by its ID using an HTTP PATCH request to modify specific fields like name or tags. Unlike `v1_assets_assetid3` which uses POST, this method applies incremental changes, returning the updated asset data upon completion.
-        
+
         Args:
             assetId (string): assetId
             name (string): name Example: '<string>'.
@@ -128,10 +128,10 @@ class CanvaApp(APIApplication):
                   ]
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             asset
         """
@@ -151,13 +151,13 @@ class CanvaApp(APIApplication):
     def upload_asset(self, request_body=None) -> dict[str, Any]:
         """
         Uploads an asset by sending its data to the `/v1/assets/upload` endpoint. This function performs a direct, synchronous upload, returning a confirmation. It differs from `v1_asset_uploads`, which initiates an asynchronous upload job tracked by an ID.
-        
+
         Args:
             request_body (dict | None): Optional dictionary for arbitrary request body data.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             asset
         """
@@ -170,13 +170,13 @@ class CanvaApp(APIApplication):
     def create_asset_upload_job(self, request_body=None) -> dict[str, Any]:
         """
         Initiates an asynchronous asset upload by creating an upload job. This method returns details, like a job ID, for subsequent steps. It differs from `v1_assets_upload`, which targets a direct, synchronous upload endpoint.
-        
+
         Args:
             request_body (dict | None): Optional dictionary for arbitrary request body data.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             asset
         """
@@ -189,13 +189,13 @@ class CanvaApp(APIApplication):
     def get_asset_upload_job_status(self, jobId) -> dict[str, Any]:
         """
         Retrieves the status and results of an asynchronous asset upload job using its unique job ID. This allows for checking the outcome of an upload initiated by `v1_asset_uploads`, returning details on its completion and any resulting asset information.
-        
+
         Args:
             jobId (string): jobId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             asset
         """
@@ -212,7 +212,7 @@ class CanvaApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Initiates an autofill job to create a new design by populating a brand template with provided data. It sends a POST request with the template ID, data, and title, returning the details of the newly created job.
-        
+
         Args:
             brand_template_id (string): brand_template_id Example: '<string>'.
             data (object): data
@@ -236,10 +236,10 @@ class CanvaApp(APIApplication):
                   "title": "<string>"
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             autofill
         """
@@ -259,13 +259,13 @@ class CanvaApp(APIApplication):
     def get_autofill_job_status(self, jobId) -> dict[str, Any]:
         """
         Retrieves the status and results of an asynchronous autofill job by its unique `jobId`. This function is used to check the outcome of a template population operation initiated by the `v1_autofills` method.
-        
+
         Args:
             jobId (string): jobId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             autofill
         """
@@ -282,7 +282,7 @@ class CanvaApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Searches for and retrieves a paginated list of brand templates. Results can be filtered by ownership and sorted by relevance, modification date, or title. A continuation token can be used to fetch subsequent pages of templates.
-        
+
         Args:
             query (string): Lets you search the brand templates available to the user using a search term or terms. Example: '<string>'.
             continuation (string): If the success response contains a continuation token, the user has access to more
@@ -301,10 +301,10 @@ class CanvaApp(APIApplication):
         - `MODIFIED_ASCENDING`: Sort results by the date last modified in ascending order.
         - `TITLE_DESCENDING`: Sort results by title in descending order.
         - `TITLE_ASCENDING`: Sort results by title in ascending order. Example: '<string>'.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             brand_template, important
         """
@@ -326,13 +326,13 @@ class CanvaApp(APIApplication):
     def get_brand_template_by_id(self, brandTemplateId) -> dict[str, Any]:
         """
         Retrieves the complete metadata for a specific brand template using its unique identifier. This is distinct from `v1_brand_templates`, which lists multiple templates, and `v1_brand_templates_brandtemplateid_dataset`, which gets only a template's dataset.
-        
+
         Args:
             brandTemplateId (string): brandTemplateId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             brand_template
         """
@@ -344,18 +344,16 @@ class CanvaApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_brand_template_dataset(
-        self, brandTemplateId
-    ) -> dict[str, Any]:
+    def get_brand_template_dataset(self, brandTemplateId) -> dict[str, Any]:
         """
         Retrieves the dataset for a specific brand template by its ID. The dataset defines the names and types of autofillable fields, which is essential for programmatically populating the template with data.
-        
+
         Args:
             brandTemplateId (string): brandTemplateId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             brand_template
         """
@@ -372,7 +370,7 @@ class CanvaApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Creates a new top-level comment attached to a specific resource, such as a design. It allows for an optional assignee and a message body, sending a POST request to the `/v1/comments` endpoint and returning the details of the newly created comment.
-        
+
         Args:
             assignee_id (string): assignee_id Example: '<string>'.
             attached_to (object): attached_to
@@ -388,10 +386,10 @@ class CanvaApp(APIApplication):
                   "message": "<string>"
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             comment
         """
@@ -412,7 +410,7 @@ class CanvaApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Creates a reply to a specific comment, identified by `commentId`. It sends a POST request with the reply's message and attachment details to the `/v1/comments/{commentId}/replies` endpoint, adding a threaded response to an existing comment.
-        
+
         Args:
             commentId (string): commentId
             attached_to (object): attached_to
@@ -427,10 +425,10 @@ class CanvaApp(APIApplication):
                   "message": "<string>"
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             comment
         """
@@ -447,19 +445,17 @@ class CanvaApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_design_comment(
-        self, designId, commentId
-    ) -> dict[str, Any]:
+    def get_design_comment(self, designId, commentId) -> dict[str, Any]:
         """
         Fetches a specific comment from a design using both the design and comment IDs. Unlike other functions that create comments or replies, this method exclusively retrieves the data for a single, existing comment by making a GET request to the API.
-        
+
         Args:
             designId (string): designId
             commentId (string): commentId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             comment
         """
@@ -476,10 +472,10 @@ class CanvaApp(APIApplication):
     def get_connection_keys(self) -> dict[str, Any]:
         """
         Fetches a list of connection keys for the authenticated user or application from the `/v1/connect/keys` endpoint. These keys are used for establishing secure connections or integrations with the Canva API.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             connect
         """
@@ -494,7 +490,7 @@ class CanvaApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves a list of designs available to the user. Results can be filtered by a search query, ownership status, and sort order. It supports pagination for large datasets using a continuation token to fetch multiple designs.
-        
+
         Args:
             query (string): Lets you search the user's designs, and designs shared with the user, using a search term or terms. Example: '<string>'.
             continuation (string): If the success response contains a continuation token, the list contains more designs
@@ -511,10 +507,10 @@ class CanvaApp(APIApplication):
         - `modified_ascending`: Sort results by the date last modified in ascending order.
         - `title_descending`: Sort results by title in descending order.
         - `title_ascending`: Sort results by title in ascending order. Example: '<string>'.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             design, important
         """
@@ -538,7 +534,7 @@ class CanvaApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Creates a new design from an asset. This function sends a POST request to the `/v1/designs` endpoint with the asset ID, design type, and title, returning the data for the newly created design resource.
-        
+
         Args:
             asset_id (string): asset_id Example: '<string>'.
             design_type (object): design_type
@@ -554,10 +550,10 @@ class CanvaApp(APIApplication):
                   "title": "<string>"
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             design
         """
@@ -576,13 +572,13 @@ class CanvaApp(APIApplication):
     def get_design(self, designId) -> dict[str, Any]:
         """
         Fetches the details for a single, specific design using its unique identifier. This function retrieves one design, distinguishing it from `v1_designs` which lists multiple designs and `v1_designs1` which creates a new design.
-        
+
         Args:
             designId (string): designId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             design
         """
@@ -597,13 +593,13 @@ class CanvaApp(APIApplication):
     def create_design_import_job(self, request_body=None) -> dict[str, Any]:
         """
         Initiates a job to import a file (e.g., PDF, PPTX) for creating a new Canva design. This function sends a POST request to the `/v1/imports` endpoint and returns details of the created import job, including a job ID for status tracking.
-        
+
         Args:
             request_body (dict | None): Optional dictionary for arbitrary request body data.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             design_import
         """
@@ -616,13 +612,13 @@ class CanvaApp(APIApplication):
     def get_design_import_status(self, jobId) -> dict[str, Any]:
         """
         Retrieves the status and results of a specific design import job using its unique `jobId`. This function checks the outcome of an import process initiated by the `v1_imports` method, returning details about the job's progress and final state.
-        
+
         Args:
             jobId (string): jobId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             design_import
         """
@@ -637,7 +633,7 @@ class CanvaApp(APIApplication):
     def create_design_export(self, design_id=None, format=None) -> dict[str, Any]:
         """
         Initiates an export job for a specified design based on its ID and format details (e.g., file type, quality). It returns the export job's details, including an ID used to track its status with `v1_exports_exportid`.
-        
+
         Args:
             design_id (string): design_id Example: '<string>'.
             format (object): format
@@ -656,10 +652,10 @@ class CanvaApp(APIApplication):
                   }
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             export
         """
@@ -677,13 +673,13 @@ class CanvaApp(APIApplication):
     def get_export_job_status(self, exportId) -> dict[str, Any]:
         """
         Retrieves the status and results of a specific design export job using its unique ID. This is used to check on an export initiated by the `v1_exports` function and to obtain download links for the completed file.
-        
+
         Args:
             exportId (string): exportId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             export
         """
@@ -698,13 +694,13 @@ class CanvaApp(APIApplication):
     def get_folder_by_id(self, folderId) -> dict[str, Any]:
         """
         Retrieves detailed information for a specific folder using its unique ID. This GET operation fetches folder metadata, distinguishing it from functions that delete (`v1_folders_folderid`) or update (`v1_folders_folderid2`) the same folder resource.
-        
+
         Args:
             folderId (string): folderId
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             folder
         """
@@ -719,13 +715,13 @@ class CanvaApp(APIApplication):
     def delete_folder(self, folderId) -> Any:
         """
         Deletes a folder and all its contents using the folder's unique identifier. This function sends an HTTP DELETE request to the `/v1/folders/{folderId}` endpoint and returns a confirmation status upon successful deletion.
-        
+
         Args:
             folderId (string): folderId
-        
+
         Returns:
             Any: OK
-        
+
         Tags:
             folder
         """
@@ -740,7 +736,7 @@ class CanvaApp(APIApplication):
     def update_folder(self, folderId, name=None) -> dict[str, Any]:
         """
         Updates a specific folder's properties, such as its name, using its unique ID. This function sends a PATCH request to the `/v1/folders/{folderId}` endpoint to apply partial modifications and returns the updated folder information upon success.
-        
+
         Args:
             folderId (string): folderId
             name (string): name
@@ -750,10 +746,10 @@ class CanvaApp(APIApplication):
                   "name": "<string>"
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             folder
         """
@@ -774,7 +770,7 @@ class CanvaApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Lists items within a specific folder. Supports optional filtering by item type (asset, design, folder, template) and pagination using a continuation token to navigate through large result sets.
-        
+
         Args:
             folderId (string): folderId
             continuation (string): If the success response contains a continuation token, the folder contains more items
@@ -784,10 +780,10 @@ class CanvaApp(APIApplication):
             item_types (string): Filter the folder items to only return specified types. The available types are:
         `asset`, `design`, `folder`, and `template`. To filter for more than one item type,
         provide a comma-delimited list. Example: '<string>'.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             folder
         """
@@ -808,7 +804,7 @@ class CanvaApp(APIApplication):
     ) -> Any:
         """
         Moves an item, such as a design or another folder, from a source folder to a destination folder. It requires the unique IDs for the item, the source folder, and the target folder to perform the relocation, returning a status confirmation upon completion.
-        
+
         Args:
             from_folder_id (string): from_folder_id Example: '<string>'.
             item_id (string): item_id Example: '<string>'.
@@ -821,10 +817,10 @@ class CanvaApp(APIApplication):
                   "to_folder_id": "<string>"
                 }
                 ```
-        
+
         Returns:
             Any: OK
-        
+
         Tags:
             folder
         """
@@ -843,7 +839,7 @@ class CanvaApp(APIApplication):
     def create_folder(self, name=None, parent_folder_id=None) -> dict[str, Any]:
         """
         Creates a new folder, optionally assigning it a name and placing it within a specified parent folder. This function is distinct from others as it uses a POST request to the base `/v1/folders` endpoint, specifically for creation.
-        
+
         Args:
             name (string): name Example: '<string>'.
             parent_folder_id (string): parent_folder_id
@@ -854,10 +850,10 @@ class CanvaApp(APIApplication):
                   "parent_folder_id": "<string>"
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             folder
         """
@@ -875,10 +871,10 @@ class CanvaApp(APIApplication):
     def get_current_user(self) -> dict[str, Any]:
         """
         Retrieves core information for the currently authenticated user, such as ID and team details. This function is distinct from `v1_users_me_profile`, which fetches more specific profile data like the user's display name and profile picture.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             user, important
         """
@@ -891,10 +887,10 @@ class CanvaApp(APIApplication):
     def get_current_user_profile(self) -> dict[str, Any]:
         """
         Fetches detailed profile information for the currently authenticated user. This method is distinct from `v1_users_me`, which retrieves general user account information rather than specific profile details like display name or avatar.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             user
         """

universal_mcp/applications/confluence/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/contentful/app.py

@@ -2,7 +2,6 @@ from collections.abc import Callable
 from typing import Any
 
 from loguru import logger
-
 from universal_mcp.applications.application import GraphQLApplication
 from universal_mcp.exceptions import NotAuthorizedError
 from universal_mcp.integrations import Integration
@@ -15,10 +14,10 @@ class ContentfulApp(GraphQLApplication):
         **kwargs: Any,
     ) -> None:
         self.space_id: str | None = None
-        self.environment_id: str = "master" 
+        self.environment_id: str = "master"
         self._access_token: str | None = None
-        self._is_eu_customer: bool = False 
-        self._credentials_loaded: bool = False 
+        self._is_eu_customer: bool = False
+        self._credentials_loaded: bool = False
         default_base_url = "https://graphql.contentful.com"
 
         super().__init__(
@@ -326,7 +325,7 @@ class ContentfulApp(GraphQLApplication):
 
         Returns:
             The result of the query, or an error dictionary.
-            
+
         Tags:
             important
         """