universal-mcp-applications 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

universal_mcp/applications/airtable/app.py

@@ -14,6 +14,7 @@ from pyairtable.api.types import (
     WritableFields,
 )
 from pyairtable.formulas import Formula, to_formula_str
+
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 

universal_mcp/applications/apollo/app.py

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

universal_mcp/applications/aws_s3/app.py

@@ -4,6 +4,7 @@ from typing import Any
 
 import boto3
 from botocore.exceptions import ClientError
+
 from universal_mcp.applications.application import BaseApplication
 from universal_mcp.integrations import Integration
 
@@ -22,7 +23,7 @@ class AwsS3App(BaseApplication):
             aws_secret_access_key (str, optional): AWS secret access key.
             region_name (str, optional): AWS region name.
         """
-        super().__init__(name="aws-s3", integration=integration, **kwargs)
+        super().__init__(name="aws_s3", integration=integration, **kwargs)
         self._client = client
         self.integration = integration
 
@@ -135,9 +136,7 @@ class AwsS3App(BaseApplication):
         except ClientError:
             return False
 
-    def list_prefixes(
-        self, bucket_name: str, prefix: str | None = None
-    ) -> list[str]:
+    def list_prefixes(self, bucket_name: str, prefix: str | None = None) -> list[str]:
         """
         Lists common prefixes ("folders") in the specified S3 bucket and prefix.
 

universal_mcp/applications/bill/app.py

@@ -244,7 +244,7 @@ class BillApp(APIApplication):
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
 
         Tags:
-            bills
+            bills, , important
         """
         url = f"{self.base_url}/v3/bills"
         query_params = {
@@ -356,7 +356,7 @@ class BillApp(APIApplication):
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
 
         Tags:
-            bills
+            bills, important
         """
         if billId is None:
             raise ValueError("Missing required parameter 'billId'.")
@@ -2927,7 +2927,7 @@ class BillApp(APIApplication):
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
 
         Tags:
-            customers
+            customers, important
         """
         if customerId is None:
             raise ValueError("Missing required parameter 'customerId'.")

universal_mcp/applications/box/app.py

@@ -3155,9 +3155,7 @@ class BoxApp(APIApplication):
         except ValueError:
             return None
 
-    def delete_folders_id(
-        self, folder_id: str, recursive: bool | None = None
-    ) -> Any:
+    def delete_folders_id(self, folder_id: str, recursive: bool | None = None) -> Any:
         """
         Delete folder
 
@@ -11630,9 +11628,7 @@ class BoxApp(APIApplication):
         except ValueError:
             return None
 
-    def create_shield_barriers(
-        self, enterprise: Any | None = None
-    ) -> dict[str, Any]:
+    def create_shield_barriers(self, enterprise: Any | None = None) -> dict[str, Any]:
         """
         Create shield information barrier
 

universal_mcp/applications/braze/app.py

@@ -927,9 +927,7 @@ class BrazeApp(APIApplication):
         except ValueError:
             return None
 
-    def add_email_to_blocklist(
-        self, email: list[str] | None = None
-    ) -> dict[str, Any]:
+    def add_email_to_blocklist(self, email: list[str] | None = None) -> dict[str, Any]:
         """
         Blocklist Email Addresses
 
@@ -2367,9 +2365,7 @@ class BrazeApp(APIApplication):
         except ValueError:
             return None
 
-    def list_scheduled_broadcasts(
-        self, end_time: str | None = None
-    ) -> dict[str, Any]:
+    def list_scheduled_broadcasts(self, end_time: str | None = None) -> dict[str, Any]:
         """
         List Upcoming Scheduled Campaigns and Canvases
 

universal_mcp/applications/cal_com_v2/app.py

@@ -6,7 +6,7 @@ from universal_mcp.integrations import Integration
 
 class CalComV2App(APIApplication):
     def __init__(self, integration: Integration = None, **kwargs) -> None:
-        super().__init__(name="cal-com-v2", integration=integration, **kwargs)
+        super().__init__(name="cal_com_v2", integration=integration, **kwargs)
         self.base_url = "https://api.cal.com"
 
     def get_provider_details(self, clientId: str) -> dict[str, Any]:
@@ -34,9 +34,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def get_provider_access_token(
-        self, clientId: str
-    ) -> dict[str, Any]:
+    def get_provider_access_token(self, clientId: str) -> dict[str, Any]:
         """
         Retrieves an access token for the specified client ID using a GET request.
 
@@ -215,9 +213,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def get_oauth_client_user_by_id(
-        self, clientId: str, userId: str
-    ) -> dict[str, Any]:
+    def get_oauth_client_user_by_id(self, clientId: str, userId: str) -> dict[str, Any]:
         """
         Retrieves user-specific information associated with an OAuth client using the provided client ID and user ID.
 
@@ -307,9 +303,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def delete_user_by_client_id_id(
-        self, clientId: str, userId: str
-    ) -> dict[str, Any]:
+    def delete_user_by_client_id_id(self, clientId: str, userId: str) -> dict[str, Any]:
         """
         Removes a user's association with an OAuth client identified by the client ID and user ID.
 
@@ -337,9 +331,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def force_refresh_user(
-        self, clientId: str, userId: str
-    ) -> dict[str, Any]:
+    def force_refresh_user(self, clientId: str, userId: str) -> dict[str, Any]:
         """
         Forces a refresh for the OAuth client's user session, invalidating existing tokens and generating new ones.
 
@@ -797,9 +789,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def delete_org_attribute(
-        self, orgId: str, attributeId: str
-    ) -> dict[str, Any]:
+    def delete_org_attribute(self, orgId: str, attributeId: str) -> dict[str, Any]:
         """
         Deletes a specified attribute from an organization using the provided orgId and attributeId path parameters.
 
@@ -874,9 +864,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def get_org_attribute_options(
-        self, orgId: str, attributeId: str
-    ) -> dict[str, Any]:
+    def get_org_attribute_options(self, orgId: str, attributeId: str) -> dict[str, Any]:
         """
         Retrieves options for a specific attribute within an organization using the "GET" method at the "/v2/organizations/{orgId}/attributes/{attributeId}/options" endpoint.
 
@@ -1039,9 +1027,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def get_user_org_attribute_options(
-        self, orgId: str, userId: str
-    ) -> dict[str, Any]:
+    def get_user_org_attribute_options(self, orgId: str, userId: str) -> dict[str, Any]:
         """
         Retrieves attribute options for a specified user within an organization using the "GET" method.
 
@@ -1507,9 +1493,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def get_org_membership_by_id(
-        self, orgId: str, membershipId: str
-    ) -> dict[str, Any]:
+    def get_org_membership_by_id(self, orgId: str, membershipId: str) -> dict[str, Any]:
         """
         Retrieves membership details for a specific organization membership using the provided organization ID and membership ID.
 
@@ -1704,9 +1688,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def get_user_schedule(
-        self, orgId: str, userId: str
-    ) -> dict[str, Any]:
+    def get_user_schedule(self, orgId: str, userId: str) -> dict[str, Any]:
         """
         Retrieves a user's schedule for a specific organization using the GET method.
 
@@ -2013,9 +1995,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def get_organization_team_by_id(
-        self, orgId: str, teamId: str
-    ) -> dict[str, Any]:
+    def get_organization_team_by_id(self, orgId: str, teamId: str) -> dict[str, Any]:
         """
         Retrieves information about a specific team within an organization using the organization and team IDs.
 
@@ -2043,9 +2023,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def delete_team_by_id(
-        self, orgId: str, teamId: str
-    ) -> dict[str, Any]:
+    def delete_team_by_id(self, orgId: str, teamId: str) -> dict[str, Any]:
         """
         Deletes a specific team within an organization and returns a success status upon completion.
 
@@ -2838,9 +2816,7 @@ class CalComV2App(APIApplication):
         response = self._get(url, params=query_params)
         return Getbookingbyuidresponse.model_validate(self._handle_response(response))
 
-    def reschedule_booking_by_uid(
-        self, bookingUid: str
-    ) -> dict[str, Any]:
+    def reschedule_booking_by_uid(self, bookingUid: str) -> dict[str, Any]:
         """
         Reschedules an existing booking identified by its unique `bookingUid`, using the `POST` method at the "/v2/bookings/{bookingUid}/reschedule" endpoint.
 
@@ -3341,9 +3317,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def conferencing_controller_connect(
-        self, app: str
-    ) -> dict[str, Any]:
+    def conferencing_controller_connect(self, app: str) -> dict[str, Any]:
         """
         Establishes a connection for conferencing using the specified application via the POST method at the "/v2/conferencing/{app}/connect" endpoint.
 
@@ -3452,9 +3426,7 @@ class CalComV2App(APIApplication):
         response = self._get(url, params=query_params)
         return Listconferencingresponse.model_validate(self._handle_response(response))
 
-    def conferencing_controller_default(
-        self, app: str
-    ) -> dict[str, Any]:
+    def conferencing_controller_default(self, app: str) -> dict[str, Any]:
         """
         Sets the default conferencing application for the specified app identifier.
 
@@ -3823,9 +3795,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def get_webhook_by_id(
-        self, eventTypeId: str, webhookId: str
-    ) -> dict[str, Any]:
+    def get_webhook_by_id(self, eventTypeId: str, webhookId: str) -> dict[str, Any]:
         """
         Retrieves details about a specific webhook for a given event type using the provided event type ID and webhook ID.
 
@@ -4366,9 +4336,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def stripe_controller_save(
-        self, state: str, code: str
-    ) -> dict[str, Any]:
+    def stripe_controller_save(self, state: str, code: str) -> dict[str, Any]:
         """
         Retrieves a Stripe resource using a state and code query parameter and returns the result upon successful authentication.
 
@@ -4551,9 +4519,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def teams_controller_get_team(
-        self, teamId: str
-    ) -> dict[str, Any]:
+    def teams_controller_get_team(self, teamId: str) -> dict[str, Any]:
         """
         Retrieves information about a team specified by the team ID using the GET method.
 
@@ -4672,9 +4638,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def teams_controller_delete_team(
-        self, teamId: str
-    ) -> dict[str, Any]:
+    def teams_controller_delete_team(self, teamId: str) -> dict[str, Any]:
         """
         Deletes a specified team using the provided team ID.
 
@@ -5089,9 +5053,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def get_membership_by_id(
-        self, teamId: str, membershipId: str
-    ) -> dict[str, Any]:
+    def get_membership_by_id(self, teamId: str, membershipId: str) -> dict[str, Any]:
         """
         Retrieves the membership details for a specific user in a team using the provided membership ID.
 
@@ -5341,9 +5303,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def webhooks_controller_get_webhook(
-        self, webhookId: str
-    ) -> dict[str, Any]:
+    def webhooks_controller_get_webhook(self, webhookId: str) -> dict[str, Any]:
         """
         Retrieves information about a specific webhook identified by its ID using the "GET" method.
 
@@ -5368,9 +5328,7 @@ class CalComV2App(APIApplication):
             self._handle_response(response)
         )
 
-    def delete_user_webhook_by_id(
-        self, webhookId: str
-    ) -> dict[str, Any]:
+    def delete_user_webhook_by_id(self, webhookId: str) -> dict[str, Any]:
         """
         Deletes a webhook by its ID using the DELETE method at the "/v2/webhooks/{webhookId}" path, removing the specified webhook endpoint.
 

universal_mcp/applications/confluence/app.py

@@ -1,6 +1,7 @@
 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,8 @@ from collections.abc import Callable
 from typing import Any
 
 from loguru import logger
-from universal_mcp.applications import GraphQLApplication
+
+from universal_mcp.applications.application import GraphQLApplication
 from universal_mcp.exceptions import NotAuthorizedError
 from universal_mcp.integrations import Integration
 
@@ -14,10 +15,10 @@ class ContentfulApp(GraphQLApplication):
         **kwargs: Any,
     ) -> None:
         self.space_id: str | None = None
-        self.environment_id: str = "master"  # Default Contentful environment
+        self.environment_id: str = "master" 
         self._access_token: str | None = None
-        self._is_eu_customer: bool = False  # Default data center
-        self._credentials_loaded: bool = False  # Flag for lazy loading
+        self._is_eu_customer: bool = False 
+        self._credentials_loaded: bool = False 
         default_base_url = "https://graphql.contentful.com"
 
         super().__init__(
@@ -63,9 +64,7 @@ class ContentfulApp(GraphQLApplication):
             self._credentials_loaded = True  # Prevent retries
             return False
 
-        # --- Extract Credentials ---
         self.space_id = credentials.get("space_id")
-        # Prefer access_token, fallback to api_key for naming flexibility
         self._access_token = credentials.get("access_token") or credentials.get(
             "api_key"
         )
@@ -76,7 +75,6 @@ class ContentfulApp(GraphQLApplication):
             "is_eu_customer", False
         )  # Use default if not specified
 
-        # --- Validate Required Credentials ---
         missing_creds = []
         if not self.space_id:
             missing_creds.append("'space_id'")
@@ -91,20 +89,13 @@ class ContentfulApp(GraphQLApplication):
             self._credentials_loaded = True  # Prevent retries
             return False
 
-        # --- Construct Final Base URL ---
         contentful_api_domain = (
             "graphql.eu.contentful.com"
             if self._is_eu_customer
             else "graphql.contentful.com"
         )
-        # Update self.base_url which was initially set to the default by super().__init__
         self.base_url = f"https://{contentful_api_domain}/content/v1/spaces/{self.space_id}/environments/{self.environment_id}"
 
-        # --- Force GraphQL Client Re-initialization ---
-        # Reset the internal client instance of the base class.
-        # The next time self.client property is accessed (e.g., in self.query),
-        # it will be recreated using the new self.base_url and fresh headers
-        # obtained via self._get_headers() (which will now find self._access_token).
         self._client = None
 
         logger.info(
@@ -115,11 +106,6 @@ class ContentfulApp(GraphQLApplication):
         self._credentials_loaded = True
         return True
 
-    # We rely on the base GraphQLApplication._get_headers() which looks for
-    # 'access_token' or 'api_key' and creates the Bearer token header.
-    # No override needed here as long as _load_credentials_and_construct_url
-    # correctly populates self._access_token before the client is used.
-
     @staticmethod
     def _to_camel_case(s: str) -> str:
         """Converts a string to camelCase based on Contentful's typical ID to GraphQL name conversion."""
@@ -340,6 +326,9 @@ class ContentfulApp(GraphQLApplication):
 
         Returns:
             The result of the query, or an error dictionary.
+            
+        Tags:
+            important
         """
         if not self._ensure_loaded():
             return {

universal_mcp/applications/digitalocean/app.py

@@ -248,9 +248,7 @@ class DigitaloceanApp(APIApplication):
         except ValueError:
             return None
 
-    def ssh_keys_update(
-        self, ssh_key_identifier: str, name: str | None = None
-    ) -> Any:
+    def ssh_keys_update(self, ssh_key_identifier: str, name: str | None = None) -> Any:
         """
         Update an SSH Key's Name
 
@@ -331,9 +329,7 @@ class DigitaloceanApp(APIApplication):
         except ValueError:
             return None
 
-    def actions_list(
-        self, per_page: int | None = None, page: int | None = None
-    ) -> Any:
+    def actions_list(self, per_page: int | None = None, page: int | None = None) -> Any:
         """
         List All Actions
 
@@ -5055,9 +5051,7 @@ class DigitaloceanApp(APIApplication):
         except ValueError:
             return None
 
-    def domains_list(
-        self, per_page: int | None = None, page: int | None = None
-    ) -> Any:
+    def domains_list(self, per_page: int | None = None, page: int | None = None) -> Any:
         """
         List All Domains
 
@@ -7266,9 +7260,7 @@ class DigitaloceanApp(APIApplication):
         except ValueError:
             return None
 
-    def firewalls_delete_tags(
-        self, firewall_id: str, tags: Any | None = None
-    ) -> Any:
+    def firewalls_delete_tags(self, firewall_id: str, tags: Any | None = None) -> Any:
         """
         Remove Tags from a Firewall
 
@@ -9618,9 +9610,7 @@ class DigitaloceanApp(APIApplication):
         except ValueError:
             return None
 
-    def kubernetes_remove_registry(
-        self, cluster_uuids: list[str] | None = None
-    ) -> Any:
+    def kubernetes_remove_registry(self, cluster_uuids: list[str] | None = None) -> Any:
         """
         Remove Container Registry from Kubernetes Clusters
 
@@ -14015,9 +14005,7 @@ class DigitaloceanApp(APIApplication):
         except ValueError:
             return None
 
-    def regions_list(
-        self, per_page: int | None = None, page: int | None = None
-    ) -> Any:
+    def regions_list(self, per_page: int | None = None, page: int | None = None) -> Any:
         """
         List All Data Center Regions
 
@@ -15314,9 +15302,7 @@ class DigitaloceanApp(APIApplication):
         except ValueError:
             return None
 
-    def sizes_list(
-        self, per_page: int | None = None, page: int | None = None
-    ) -> Any:
+    def sizes_list(self, per_page: int | None = None, page: int | None = None) -> Any:
         """
         List All Droplet Sizes
 
@@ -15764,9 +15750,7 @@ class DigitaloceanApp(APIApplication):
         except ValueError:
             return None
 
-    def tags_list(
-        self, per_page: int | None = None, page: int | None = None
-    ) -> Any:
+    def tags_list(self, per_page: int | None = None, page: int | None = None) -> Any:
         """
         List All Tags
 
@@ -16622,9 +16606,7 @@ class DigitaloceanApp(APIApplication):
         except ValueError:
             return None
 
-    def vpcs_list(
-        self, per_page: int | None = None, page: int | None = None
-    ) -> Any:
+    def vpcs_list(self, per_page: int | None = None, page: int | None = None) -> Any:
         """
         List All VPCs
 

universal_mcp/applications/{domain-checker → domain_checker}/app.py

@@ -4,6 +4,7 @@ from typing import Any
 
 import dns.resolver
 import requests
+
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -45,7 +46,7 @@ class DomainCheckerApp(APIApplication):
     """
 
     def __init__(self, integration: Integration = None, **kwargs) -> None:
-        super().__init__(name="domain-checker", integration=integration, **kwargs)
+        super().__init__(name="domain_checker", integration=integration, **kwargs)
 
     async def get_rdap_data(self, domain: str) -> dict[str, Any] | None:
         """Get RDAP data for a domain"""