universal-mcp-applications 0.1.39rc8__py3-none-any.whl → 0.1.39rc16__py3-none-any.whl

universal_mcp/applications/BEST_PRACTICES.md

@@ -40,7 +40,7 @@ class GoogleGeminiApp(APIApplication):
         if self._genai_client is not None:
             return self._genai_client
         
-        credentials = self.integration.get_credentials()
+        credentials = await self.integration.get_credentials_async()
         api_key = (
             credentials.get("api_key")
             or credentials.get("API_KEY")

universal_mcp/applications/airtable/app.py

@@ -18,11 +18,11 @@ class AirtableApp(APIApplication):
     def __init__(self, integration: Integration | None = None) -> None:
         super().__init__(name="airtable", integration=integration)
 
-    def _get_client(self) -> Api:
+    async def get_client(self) -> Api:
         """Initializes and returns the pyairtable client after ensuring API key is set."""
         if not self.integration:
             raise ValueError("Integration is not set for AirtableApp.")
-        credentials = self.integration.get_credentials()
+        credentials = await self.integration.get_credentials_async()
         api_key = credentials.get("api_key") or credentials.get("apiKey") or credentials.get("API_KEY")
         if not api_key:
             raise ValueError("Airtable API key is not configured in the integration.")
@@ -52,7 +52,7 @@ class AirtableApp(APIApplication):
             list, base, important
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             return client.bases()
         except Exception as e:
             return f"Error listing bases: {type(e).__name__} - {e}"
@@ -72,7 +72,7 @@ class AirtableApp(APIApplication):
             list, table, important
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             base = client.base(base_id)
             return base.tables()
         except Exception as e:
@@ -98,7 +98,7 @@ class AirtableApp(APIApplication):
             get, record, important
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             table = client.table(base_id, table_id_or_name)
             pyairtable_params = self._prepare_pyairtable_params(options)
             return table.get(record_id, **pyairtable_params)
@@ -125,7 +125,7 @@ class AirtableApp(APIApplication):
             list, record, important
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             table = client.table(base_id, table_id_or_name)
             pyairtable_params = self._prepare_pyairtable_params(options)
             if "formula" in pyairtable_params and isinstance(pyairtable_params["formula"], Formula):
@@ -154,7 +154,7 @@ class AirtableApp(APIApplication):
             create, record, important
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             table = client.table(base_id, table_id_or_name)
             prepared_options = self._prepare_pyairtable_params(options)
             prepared_options.get("typecast", False)
@@ -191,7 +191,7 @@ class AirtableApp(APIApplication):
             update, record
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             table = client.table(base_id, table_id_or_name)
             prepared_options = self._prepare_pyairtable_params(options)
             call_kwargs = {}
@@ -222,7 +222,7 @@ class AirtableApp(APIApplication):
             delete, record
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             table = client.table(base_id, table_id_or_name)
             return table.delete(record_id)
         except Exception as e:
@@ -250,7 +250,7 @@ class AirtableApp(APIApplication):
             create, record, batch
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             table = client.table(base_id, table_id_or_name)
             prepared_options = self._prepare_pyairtable_params(options)
             call_kwargs = {}
@@ -284,7 +284,7 @@ class AirtableApp(APIApplication):
             update, record, batch
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             table = client.table(base_id, table_id_or_name)
             prepared_options = self._prepare_pyairtable_params(options)
             call_kwargs = {}
@@ -317,7 +317,7 @@ class AirtableApp(APIApplication):
             delete, record, batch
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             table = client.table(base_id, table_id_or_name)
             return table.batch_delete(record_ids)
         except Exception as e:
@@ -349,7 +349,7 @@ class AirtableApp(APIApplication):
             create, update, record, batch, upsert
         """
         try:
-            client = self._get_client()
+            client = await self.get_client()
             table = client.table(base_id, table_id_or_name)
             prepared_options = self._prepare_pyairtable_params(options)
             call_kwargs = {}

universal_mcp/applications/apollo/app.py

@@ -9,7 +9,7 @@ class ApolloApp(APIApplication):
         super().__init__(name="apollo", integration=integration, **kwargs)
         self.base_url = "https://api.apollo.io/api/v1"
 
-    def _get_headers(self) -> dict[str, str]:
+    async def _aget_headers(self) -> dict[str, str]:
         """
         Get the headers for Apollo API requests.
         Overrides the base class method to use X-Api-Key.
@@ -17,7 +17,7 @@ class ApolloApp(APIApplication):
         if not self.integration:
             logger.warning("ApolloApp: No integration configured, returning empty headers.")
             return {}
-        credentials = self.integration.get_credentials()
+        credentials = await self.integration.get_credentials_async()
         api_key = credentials.get("api_key") or credentials.get("API_KEY") or credentials.get("apiKey")
         if not api_key:
             logger.error("ApolloApp: API key not found in integration credentials for Apollo.")

universal_mcp/applications/aws_s3/app.py

@@ -25,15 +25,14 @@ class AwsS3App(BaseApplication):
         self._client = client
         self.integration = integration
 
-    @property
-    def client(self):
+    async def get_client(self):
         """
         Lazily initializes and returns a cached Boto3 S3 client instance. It retrieves authentication credentials from the associated `integration` object. This property is the core mechanism used by all other methods in the class to interact with AWS S3, raising an error if the integration is not set.
         """
         if not self.integration:
             raise ValueError("Integration not initialized")
         if not self._client:
-            credentials = self.integration.get_credentials()
+            credentials = await self.integration.get_credentials_async()
             credentials = {
                 "aws_access_key_id": credentials.get("access_key_id") or credentials.get("username"),
                 "aws_secret_access_key": credentials.get("secret_access_key") or credentials.get("password"),
@@ -42,14 +41,15 @@ class AwsS3App(BaseApplication):
             self._client = boto3.client("s3", **credentials)
         return self._client
 
-    def list_buckets(self) -> list[str]:
+    async def list_buckets(self) -> list[str]:
         """
         Retrieves all S3 buckets accessible by the configured AWS credentials. It calls the S3 API's list_buckets operation and processes the response to return a simple list containing just the names of the buckets.
 
         Returns:
             List[str]: A list of bucket names.
         """
-        response = self.client.list_buckets()
+        client = await self.get_client()
+        response = await client.list_buckets()
         return [bucket["Name"] for bucket in response["Buckets"]]
 
     async def create_bucket(self, bucket_name: str, region: str | None = None) -> bool:
@@ -66,10 +66,11 @@ class AwsS3App(BaseApplication):
             important
         """
         try:
+            client = await self.get_client()
             if region:
-                self.client.create_bucket(Bucket=bucket_name, CreateBucketConfiguration={"LocationConstraint": region})
+                await client.create_bucket(Bucket=bucket_name, CreateBucketConfiguration={"LocationConstraint": region})
             else:
-                self.client.create_bucket(Bucket=bucket_name)
+                await client.create_bucket(Bucket=bucket_name)
             return True
         except ClientError:
             return False
@@ -87,7 +88,8 @@ class AwsS3App(BaseApplication):
             important
         """
         try:
-            self.client.delete_bucket(Bucket=bucket_name)
+            client = await self.get_client()
+            await client.delete_bucket(Bucket=bucket_name)
             return True
         except ClientError:
             return False
@@ -105,7 +107,8 @@ class AwsS3App(BaseApplication):
             important
         """
         try:
-            response = self.client.get_bucket_policy(Bucket=bucket_name)
+            client = await self.get_client()
+            response = await client.get_bucket_policy(Bucket=bucket_name)
             return json.loads(response["Policy"])
         except ClientError as e:
             return {"error": str(e)}
@@ -124,7 +127,8 @@ class AwsS3App(BaseApplication):
             important
         """
         try:
-            self.client.put_bucket_policy(Bucket=bucket_name, Policy=json.dumps(policy))
+            client = await self.get_client()
+            await client.put_bucket_policy(Bucket=bucket_name, Policy=json.dumps(policy))
             return True
         except ClientError:
             return False
@@ -142,7 +146,7 @@ class AwsS3App(BaseApplication):
         Tags:
             important
         """
-        paginator = self.client.get_paginator("list_objects_v2")
+        paginator = (await self.get_client()).get_paginator("list_objects_v2")
         operation_parameters = {"Bucket": bucket_name}
         if prefix:
             operation_parameters["Prefix"] = prefix
@@ -173,7 +177,7 @@ class AwsS3App(BaseApplication):
             key = f"{parent_prefix.rstrip('/')}/{prefix_name}/"
         else:
             key = f"{prefix_name}/"
-        self.client.put_object(Bucket=bucket_name, Key=key)
+        await (await self.get_client()).put_object(Bucket=bucket_name, Key=key)
         return True
 
     async def list_objects(self, bucket_name: str, prefix: str) -> list[dict[str, Any]]:
@@ -189,7 +193,8 @@ class AwsS3App(BaseApplication):
         Tags:
             important
         """
-        paginator = self.client.get_paginator("list_objects_v2")
+        client = await self.get_client()
+        paginator = client.get_paginator("list_objects_v2")
         operation_parameters = {"Bucket": bucket_name, "Prefix": prefix}
         objects = []
         for page in paginator.paginate(**operation_parameters):
@@ -223,7 +228,8 @@ class AwsS3App(BaseApplication):
             important
         """
         key = f"{prefix.rstrip('/')}/{object_name}" if prefix else object_name
-        self.client.put_object(Bucket=bucket_name, Key=key, Body=content.encode("utf-8"))
+        client = await self.get_client()
+        await client.put_object(Bucket=bucket_name, Key=key, Body=content.encode("utf-8"))
         return True
 
     async def put_object_from_base64(self, bucket_name: str, prefix: str, object_name: str, base64_content: str) -> bool:
@@ -244,7 +250,8 @@ class AwsS3App(BaseApplication):
         try:
             key = f"{prefix.rstrip('/')}/{object_name}" if prefix else object_name
             content = base64.b64decode(base64_content)
-            self.client.put_object(Bucket=bucket_name, Key=key, Body=content)
+            client = await self.get_client()
+            await client.put_object(Bucket=bucket_name, Key=key, Body=content)
             return True
         except Exception:
             return False
@@ -263,7 +270,8 @@ class AwsS3App(BaseApplication):
             important
         """
         try:
-            obj = self.client.get_object(Bucket=bucket_name, Key=key)
+            client = await self.get_client()
+            obj = await client.get_object(Bucket=bucket_name, Key=key)
             content = obj["Body"].read()
             is_text_file = key.lower().endswith((".txt", ".csv", ".json", ".xml", ".html", ".md", ".js", ".css", ".py"))
             content_dict = (
@@ -287,7 +295,8 @@ class AwsS3App(BaseApplication):
             important
         """
         try:
-            response = self.client.head_object(Bucket=bucket_name, Key=key)
+            client = await self.get_client()
+            response = await client.head_object(Bucket=bucket_name, Key=key)
             return {
                 "key": key,
                 "name": key.split("/")[-1],
@@ -375,7 +384,8 @@ class AwsS3App(BaseApplication):
         """
         try:
             delete_dict = {"Objects": [{"Key": key} for key in keys]}
-            response = self.client.delete_objects(Bucket=bucket_name, Delete=delete_dict)
+            client = await self.get_client()
+            response = await client.delete_objects(Bucket=bucket_name, Delete=delete_dict)
             return {
                 "deleted": [obj.get("Key") for obj in response.get("Deleted", [])],
                 "errors": [obj for obj in response.get("Errors", [])],
@@ -400,7 +410,8 @@ class AwsS3App(BaseApplication):
         """
         try:
             method_map = {"GET": "get_object", "PUT": "put_object", "DELETE": "delete_object"}
-            response = self.client.generate_presigned_url(
+            client = await self.get_client()
+            response = await client.generate_presigned_url(
                 method_map.get(http_method.upper(), "get_object"), Params={"Bucket": bucket_name, "Key": key}, ExpiresIn=expiration
             )
             return response

universal_mcp/applications/browser_use/app.py

@@ -11,13 +11,12 @@ class BrowserUseApp(APIApplication):
         super().__init__(name="browser_use", integration=integration, **kwargs)
         self._browser_client = None
 
-    @property
-    def browser_client(self) -> AsyncBrowserUse:
+    async def get_client(self) -> AsyncBrowserUse:
         if self._browser_client is not None:
             return self._browser_client
         if not self.integration:
             raise ValueError("Integration is required but not provided")
-        credentials = self.integration.get_credentials()
+        credentials = await self.integration.get_credentials_async()
         api_key = credentials.get("api_key") or credentials.get("API_KEY") or credentials.get("apiKey")
         if not api_key:
             raise ValueError("API key not found in integration credentials")
@@ -61,7 +60,8 @@ class BrowserUseApp(APIApplication):
         Tags:
             browser, automation, background, task, web, research, create, important
         """
-        created_task = await self.browser_client.tasks.create_task(
+        client = await self.get_client()
+        created_task = await client.tasks.create_task(
             llm=llm, task=task, max_steps=max_steps, session_id=session_id
         )
 
@@ -83,7 +83,8 @@ class BrowserUseApp(APIApplication):
         Tags:
             status, poll, browser, task, monitoring, output, important
         """
-        task = await self.browser_client.tasks.get_task(task_id)
+        client = await self.get_client()
+        task = await client.tasks.get_task(task_id)
         return task.model_dump()
 
     async def list_tasks(
@@ -102,7 +103,8 @@ class BrowserUseApp(APIApplication):
         Tags:
             list, history, browser, tasks, audit
         """
-        tasks = await self.browser_client.tasks.list_tasks(page_size=page_size)
+        client = await self.get_client()
+        tasks = await client.tasks.list_tasks(page_size=page_size)
         return tasks.model_dump()
 
     async def stop_task(
@@ -121,7 +123,8 @@ class BrowserUseApp(APIApplication):
         Tags:
             stop, cancel, browser, task, control
         """
-        updated_task = await self.browser_client.tasks.update_task(task_id, action="stop")
+        client = await self.get_client()
+        updated_task = await client.tasks.update_task(task_id, action="stop")
         return updated_task.model_dump()
 
     def list_tools(self):

universal_mcp/applications/contentful/app.py

@@ -16,7 +16,7 @@ class ContentfulApp(GraphQLApplication):
         default_base_url = "https://graphql.contentful.com"
         super().__init__(name="contentful", base_url=default_base_url, integration=integration, **kwargs)
 
-    def _load_credentials_and_construct_url(self) -> bool:
+    async def _load_credentials_and_construct_url(self) -> bool:
         """
         Loads credentials from the integration, constructs the precise API URL,
         and prepares the instance for API calls. Runs only once.
@@ -32,7 +32,7 @@ class ContentfulApp(GraphQLApplication):
             self._credentials_loaded = True
             return False
         try:
-            credentials = self.integration.get_credentials()
+            credentials = await self.integration.get_credentials_async()
         except NotAuthorizedError as e:
             logger.error(f"Authorization required or credentials unavailable for Contentful: {e.message}")
             self._credentials_loaded = True
@@ -85,10 +85,10 @@ class ContentfulApp(GraphQLApplication):
             return s[0].upper() + s[1:] if len(s) > 1 else s.upper()
         return "".join((word.capitalize() for word in parts))
 
-    def _ensure_loaded(self) -> bool:
+    async def _ensure_loaded(self) -> bool:
         """Internal helper to trigger lazy loading and check status."""
         if not self._credentials_loaded:
-            return self._load_credentials_and_construct_url()
+            return await self._load_credentials_and_construct_url()
         return bool(self.base_url and self.space_id and self._access_token)
 
     async def get_entry(

universal_mcp/applications/crustdata/app.py

@@ -8,8 +8,8 @@ class CrustdataApp(APIApplication):
         super().__init__(name="crustdata", integration=integration, **kwargs)
         self.base_url = "https://api.crustdata.com"
 
-    def _get_headers(self) -> dict[str, Any]:
-        api_key = self.integration.get_credentials().get("api_key")
+    async def _aget_headers(self) -> dict[str, Any]:
+        api_key = await self.integration.get_credentials_async().get("api_key")
         return {"Authorization": f"Token {api_key}", "Content-Type": "application/json", "Accept": "application/json"}
 
     async def screen_companies(self, metrics, filters, offset, count, sorts) -> dict[str, Any]:

universal_mcp/applications/e2b/app.py

@@ -25,8 +25,7 @@ class E2bApp(APIApplication):
         if Sandbox is None:
             logger.warning("E2B Sandbox SDK is not available. E2B tools will not function.")
 
-    @property
-    def e2b_api_key(self) -> str:
+    async def get_e2b_api_key(self) -> str:
         """
         A property that lazily retrieves and caches the E2B API key from the configured integration. It fetches the key on the first call, handles authentication failures, and raises `NotAuthorizedError` with actionable guidance if the key cannot be obtained.
         """
@@ -35,7 +34,7 @@ class E2bApp(APIApplication):
                 logger.error("E2B App: Integration not configured.")
                 raise NotAuthorizedError("Integration not configured for E2B App. Cannot retrieve API key.")
             try:
-                credentials = self.integration.get_credentials()
+                credentials = await self.integration.get_credentials_async()
             except NotAuthorizedError as e:
                 logger.error(f"E2B App: Authorization error when fetching credentials: {e.message}")
                 raise
@@ -111,7 +110,7 @@ class E2bApp(APIApplication):
             raise ValueError("Provided code must be a non-empty string.")
         try:
             logger.info("Attempting to execute Python code in E2B Sandbox.")
-            os.environ["E2B_API_KEY"] = self.e2b_api_key
+            os.environ["E2B_API_KEY"] = await self.get_e2b_api_key()
             with Sandbox.create() as sandbox:
                 logger.info("E2B Sandbox initialized. Running code.")
                 execution = sandbox.run_code(code)

universal_mcp/applications/elevenlabs/README.md

@@ -9,6 +9,30 @@ This is automatically generated from OpenAPI schema for the ElevenlabsApp API.
 
 | Tool | Description |
 |------|-------------|
-| `generate_speech_audio_url` | Converts a text string into speech using the ElevenLabs API. The function then saves the generated audio to a temporary MP3 file and returns a public URL to access it, rather than the raw audio bytes. |
-| `speech_to_text` | Transcribes an audio file into text using the ElevenLabs API. It supports language specification and speaker diarization, providing the inverse operation to the audio-generating `text_to_speech` method. Note: The docstring indicates this is a placeholder for an undocumented endpoint. |
-| `speech_to_speech` | Downloads an audio file from a URL and converts the speech into a specified target voice using the ElevenLabs API. This function transforms the speaker's voice in an existing recording and returns the new audio data as bytes, distinct from creating audio from text. |
+| `text_to_speech` | Converts text to speech and returns the generated audio data. |
+| `speech_to_text` | Transcribes an audio file into text. |
+| `speech_to_speech` | Converts speech from an audio source (URL or local path) to a different voice. |
+| `get_history_items` | Returns a list of generated audio history items. |
+| `get_history_item` | Retrieves a specific history item by ID. |
+| `delete_history_item` | Deletes a history item by ID. |
+| `get_history_item_audio` | Gets the audio for a history item. |
+| `get_voices` | Lists all available voices. |
+| `get_voice` | Gets details of a specific voice. |
+| `delete_voice` | Deletes a voice by ID. |
+| `get_voice_samples` | Gets samples for a specific voice. |
+| `delete_sample` | Deletes a sample. |
+| `convert_text_to_sound_effect` | Converts text to sound effects. |
+| `convert_text_to_dialogue` | Converts a list of text and voice ID pairs into speech (dialogue) and returns synthesized audio. |
+| `remix_voice` | Remixes an existing voice to create a new one based on a description. |
+| `convert_text_to_music` | Generates music based on a text prompt. |
+| `clone_voice` | Clones a voice from provided audio samples (URLs or local paths). |
+| `design_voice` | Generates voice previews based on a text description. |
+| `align_audio` | Aligns text to an audio file, returning timing information for characters and words. |
+| `isolate_audio` | Removes background noise from audio. |
+| `dub_file` | Dubs an audio file into another language. |
+| `get_dubbing_project_metadata` | Gets metadata for a dubbing project. |
+| `get_dubbed_file` | Downloads a dubbed file. |
+| `get_models` | Lists available models. |
+| `get_user_info` | Gets user information. |
+| `get_user_subscription` | Gets user subscription details. |
+| `get_usage` | Gets usage statistics. Defaults to the last 30 days if dates are not provided. |