universal-mcp 0.1.9rc1__py3-none-any.whl → 0.1.10__py3-none-any.whl

universal_mcp/applications/retell_ai/app.py

@@ -6,23 +6,23 @@ from universal_mcp.integrations import Integration
 
 class RetellAiApp(APIApplication):
     def __init__(self, integration: Integration = None, **kwargs) -> None:
-        super().__init__(name='retell-ai', integration=integration, **kwargs)
+        super().__init__(name="retell-ai", integration=integration, **kwargs)
         self.base_url = "https://api.retellai.com"
 
     def get_v2_get_call_by_call_id(self, call_id) -> dict[str, Any]:
         """
         Retrieve detailed information about a specific call using its call ID.
-        
+
         Args:
             call_id: The unique identifier of the call to retrieve. Must not be None.
-        
+
         Returns:
             A dictionary containing the details of the requested call as returned by the API.
-        
+
         Raises:
             ValueError: If the 'call_id' parameter is None.
             HTTPError: If the HTTP request to the API fails or returns an unsuccessful status code.
-        
+
         Tags:
             get, call, api, important
         """
@@ -34,23 +34,30 @@ class RetellAiApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def post_v2_create_phone_call(self, from_number, to_number, override_agent_id=None, metadata=None, retell_llm_dynamic_variables=None) -> dict[str, Any]:
+    def post_v2_create_phone_call(
+        self,
+        from_number,
+        to_number,
+        override_agent_id=None,
+        metadata=None,
+        retell_llm_dynamic_variables=None,
+    ) -> dict[str, Any]:
         """
         Initiates a phone call using a JSON payload with specified parameters.
-        
+
         Args:
             from_number: The source number for the call.
             to_number: The destination number for the call.
             override_agent_id: Optional ID for overriding the default agent.
             metadata: Optional metadata to be included with the call request.
             retell_llm_dynamic_variables: Optional dynamic variables for LLM (Large Language Model) processing.
-        
+
         Returns:
             A dictionary containing the response data for the created phone call.
-        
+
         Raises:
             ValueError: Raised if either 'from_number' or 'to_number' is missing.
-        
+
         Tags:
             initiate, create-call, async_job, management, important
         """
@@ -59,11 +66,11 @@ class RetellAiApp(APIApplication):
         if to_number is None:
             raise ValueError("Missing required parameter 'to_number'")
         request_body = {
-            'from_number': from_number,
-            'to_number': to_number,
-            'override_agent_id': override_agent_id,
-            'metadata': metadata,
-            'retell_llm_dynamic_variables': retell_llm_dynamic_variables,
+            "from_number": from_number,
+            "to_number": to_number,
+            "override_agent_id": override_agent_id,
+            "metadata": metadata,
+            "retell_llm_dynamic_variables": retell_llm_dynamic_variables,
         }
         request_body = {k: v for k, v in request_body.items() if v is not None}
         url = f"{self.base_url}/v2/create-phone-call"
@@ -72,30 +79,32 @@ class RetellAiApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def post_v2_create_web_call(self, agent_id, metadata=None, retell_llm_dynamic_variables=None) -> dict[str, Any]:
+    def post_v2_create_web_call(
+        self, agent_id, metadata=None, retell_llm_dynamic_variables=None
+    ) -> dict[str, Any]:
         """
         Creates a web call via a POST request to the v2 endpoint with specified agent ID and optional metadata or dynamic variables.
-        
+
         Args:
             agent_id: Required identifier of the agent initiating the web call.
             metadata: Optional metadata to include in the web call request.
             retell_llm_dynamic_variables: Optional dynamic variables for LLN model customization.
-        
+
         Returns:
             A dictionary containing the response details from the web call creation request.
-        
+
         Raises:
             ValueError: Raised when the required 'agent_id' parameter is missing.
-        
+
         Tags:
             create, web-calls, api-call, important
         """
         if agent_id is None:
             raise ValueError("Missing required parameter 'agent_id'")
         request_body = {
-            'agent_id': agent_id,
-            'metadata': metadata,
-            'retell_llm_dynamic_variables': retell_llm_dynamic_variables,
+            "agent_id": agent_id,
+            "metadata": metadata,
+            "retell_llm_dynamic_variables": retell_llm_dynamic_variables,
         }
         request_body = {k: v for k, v in request_body.items() if v is not None}
         url = f"{self.base_url}/v2/create-web-call"
@@ -107,16 +116,16 @@ class RetellAiApp(APIApplication):
     def get_get_voice_by_voice_id(self, voice_id) -> dict[str, Any]:
         """
         Fetches voice details based on the provided voice ID.
-        
+
         Args:
             voice_id: The unique identifier of the voice to retrieve.
-        
+
         Returns:
             A dictionary containing voice details.
-        
+
         Raises:
             ValueError: Raised when the 'voice_id' parameter is missing or None.
-        
+
         Tags:
             retrieve, voice, important, data-fetched
         """
@@ -128,30 +137,32 @@ class RetellAiApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def post_v2_list_calls(self, filter_criteria=None, sort_order=None, limit=None, pagination_key=None) -> list[Any]:
+    def post_v2_list_calls(
+        self, filter_criteria=None, sort_order=None, limit=None, pagination_key=None
+    ) -> list[Any]:
         """
         Sends a POST request to list call records with optional filtering, sorting, pagination, and limits.
-        
+
         Args:
             filter_criteria: Optional dictionary specifying filter conditions for returned call records.
             sort_order: Optional sorting instructions (e.g., by date or status) for the call records.
             limit: Optional integer specifying the maximum number of call records to return.
             pagination_key: Optional key indicating where to continue fetching records for paginated results.
-        
+
         Returns:
             A list of call record objects returned from the API.
-        
+
         Raises:
             HTTPError: If the HTTP request to the remote service fails or returns an error status code.
-        
+
         Tags:
             list, calls, api, batch, management, important
         """
         request_body = {
-            'filter_criteria': filter_criteria,
-            'sort_order': sort_order,
-            'limit': limit,
-            'pagination_key': pagination_key,
+            "filter_criteria": filter_criteria,
+            "sort_order": sort_order,
+            "limit": limit,
+            "pagination_key": pagination_key,
         }
         request_body = {k: v for k, v in request_body.items() if v is not None}
         url = f"{self.base_url}/v2/list-calls"
@@ -160,33 +171,35 @@ class RetellAiApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def post_create_phone_number(self, area_code, inbound_agent_id=None, outbound_agent_id=None, nickname=None) -> dict[str, Any]:
+    def post_create_phone_number(
+        self, area_code, inbound_agent_id=None, outbound_agent_id=None, nickname=None
+    ) -> dict[str, Any]:
         """
         Creates a phone number with the specified area code and optional parameters.
-        
+
         Args:
             area_code: The area code for the phone number (required).
             inbound_agent_id: The ID of the agent to handle inbound calls (optional).
             outbound_agent_id: The ID of the agent to handle outbound calls (optional).
             nickname: A user-friendly name for the phone number (optional).
-        
+
         Returns:
             A dictionary containing the created phone number details and any associated metadata.
-        
+
         Raises:
             ValueError: When the required parameter 'area_code' is None or not provided.
             HTTPError: When the API request fails with an error status code.
-        
+
         Tags:
             create, phone, post, communication, important
         """
         if area_code is None:
             raise ValueError("Missing required parameter 'area_code'")
         request_body = {
-            'inbound_agent_id': inbound_agent_id,
-            'outbound_agent_id': outbound_agent_id,
-            'area_code': area_code,
-            'nickname': nickname,
+            "inbound_agent_id": inbound_agent_id,
+            "outbound_agent_id": outbound_agent_id,
+            "area_code": area_code,
+            "nickname": nickname,
         }
         request_body = {k: v for k, v in request_body.items() if v is not None}
         url = f"{self.base_url}/create-phone-number"
@@ -198,17 +211,17 @@ class RetellAiApp(APIApplication):
     def get_get_phone_number_by_phone_number(self, phone_number) -> dict[str, Any]:
         """
         Retrieves phone number details by making a GET request to the API endpoint using the provided phone number.
-        
+
         Args:
             phone_number: str. The phone number to look up. Must not be None.
-        
+
         Returns:
             dict[str, Any]: A dictionary containing the details associated with the given phone number as returned by the API.
-        
+
         Raises:
             ValueError: If the 'phone_number' parameter is None.
             requests.HTTPError: If the HTTP request fails or an error response is returned from the API.
-        
+
         Tags:
             get, phone-number, api, lookup, important
         """
@@ -220,19 +233,21 @@ class RetellAiApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_list_phone_numbers(self, ) -> list[Any]:
+    def get_list_phone_numbers(
+        self,
+    ) -> list[Any]:
         """
         Retrieves a list of phone numbers from the remote API.
-        
+
         Args:
             None: This function takes no arguments
-        
+
         Returns:
             A list containing the phone numbers returned by the API.
-        
+
         Raises:
             requests.HTTPError: If the HTTP request to the API fails or returns an unsuccessful status code.
-        
+
         Tags:
             get, list, phone-numbers, api, synchronous, important
         """
@@ -242,32 +257,34 @@ class RetellAiApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def patch_update_phone_number_by_phone_number(self, phone_number, inbound_agent_id=None, outbound_agent_id=None, nickname=None) -> dict[str, Any]:
+    def patch_update_phone_number_by_phone_number(
+        self, phone_number, inbound_agent_id=None, outbound_agent_id=None, nickname=None
+    ) -> dict[str, Any]:
         """
         Updates the information of a phone number by its number, allowing optional modification of inbound and outbound agent IDs and nickname.
-        
+
         Args:
             phone_number: str. The phone number to update. This parameter is required.
             inbound_agent_id: Optional[str]. The ID of the inbound agent to associate with the phone number. If None, this field will not be updated.
             outbound_agent_id: Optional[str]. The ID of the outbound agent to associate with the phone number. If None, this field will not be updated.
             nickname: Optional[str]. The nickname to assign to the phone number. If None, this field will not be updated.
-        
+
         Returns:
             dict[str, Any]: A dictionary containing the updated phone number information as returned by the API.
-        
+
         Raises:
             ValueError: If the required parameter 'phone_number' is not provided.
             requests.HTTPError: If the HTTP PATCH request fails or the response has an error status.
-        
+
         Tags:
             update, phone-number, api, patch, management
         """
         if phone_number is None:
             raise ValueError("Missing required parameter 'phone_number'")
         request_body = {
-            'inbound_agent_id': inbound_agent_id,
-            'outbound_agent_id': outbound_agent_id,
-            'nickname': nickname,
+            "inbound_agent_id": inbound_agent_id,
+            "outbound_agent_id": outbound_agent_id,
+            "nickname": nickname,
         }
         request_body = {k: v for k, v in request_body.items() if v is not None}
         url = f"{self.base_url}/update-phone-number/{phone_number}"
@@ -279,17 +296,17 @@ class RetellAiApp(APIApplication):
     def delete_delete_phone_number_by_phone_number(self, phone_number) -> Any:
         """
         Deletes a phone number resource by its phone number identifier via an HTTP DELETE request.
-        
+
         Args:
             phone_number: The phone number (str or compatible type) identifying the resource to be deleted.
-        
+
         Returns:
             The server's JSON response as a Python object upon successful deletion.
-        
+
         Raises:
             ValueError: If 'phone_number' is None.
             requests.HTTPError: If the HTTP DELETE request results in an error status code.
-        
+
         Tags:
             delete, phone-number, api, management, important
         """
@@ -312,5 +329,5 @@ class RetellAiApp(APIApplication):
             self.get_get_phone_number_by_phone_number,
             self.get_list_phone_numbers,
             self.patch_update_phone_number_by_phone_number,
-            self.delete_delete_phone_number_by_phone_number
+            self.delete_delete_phone_number_by_phone_number,
         ]

universal_mcp/applications/rocketlane/app.py

@@ -6,8 +6,8 @@ from universal_mcp.integrations import Integration
 
 class RocketlaneApp(APIApplication):
     def __init__(self, integration: Integration = None, **kwargs) -> None:
-        super().__init__(name='rocketlane', integration=integration, **kwargs)
-        subdomain= self.integration.get_credentials().get("subdomain")
+        super().__init__(name="rocketlane", integration=integration, **kwargs)
+        subdomain = self.integration.get_credentials().get("subdomain")
         self.base_url = f"https://{subdomain}.api.rocketlane.com/api/v1"
 
     def _get_headers(self) -> dict[str, Any]:
@@ -18,19 +18,21 @@ class RocketlaneApp(APIApplication):
             "Accept": "application/json",
         }
 
-    def get_subscription(self, ) -> Any:
+    def get_subscription(
+        self,
+    ) -> Any:
         """
         Retrieves subscription details from the server.
-        
+
         Args:
             None: This function does not take any parameters.
-        
+
         Returns:
             A JSON response containing subscription details.
-        
+
         Raises:
             requests.HTTPError: Raised if an HTTP error occurs during the request
-        
+
         Tags:
             fetch, subscription, management, important
         """
@@ -40,16 +42,18 @@ class RocketlaneApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_home(self, ) -> Any:
+    def get_home(
+        self,
+    ) -> Any:
         """
         Retrieves the JSON response from the '/home' endpoint of the configured API.
-        
+
         Returns:
             Any: Parsed JSON data returned by the '/home' endpoint.
-        
+
         Raises:
             requests.HTTPError: If the HTTP request to the '/home' endpoint returns an unsuccessful status code.
-        
+
         Tags:
             get, home, api, request, important
         """
@@ -59,19 +63,21 @@ class RocketlaneApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_all_projects(self, ) -> dict[str, Any]:
+    def get_all_projects(
+        self,
+    ) -> dict[str, Any]:
         """
         Retrieves a list of all projects from the remote service.
-        
+
         Args:
             None: This function takes no arguments
-        
+
         Returns:
             A dictionary containing the JSON response data representing all available projects.
-        
+
         Raises:
             HTTPError: If the HTTP request to retrieve the projects fails or returns an unsuccessful status code.
-        
+
         Tags:
             list, projects, api, important
         """
@@ -84,17 +90,17 @@ class RocketlaneApp(APIApplication):
     def get_projects_by_projectid(self, projectId) -> Any:
         """
         Retrieves project details for a given project ID from the server.
-        
+
         Args:
             projectId: The unique identifier of the project to retrieve.
-        
+
         Returns:
             A JSON-deserialized object containing the project's details as returned by the server.
-        
+
         Raises:
             ValueError: Raised if 'projectId' is None.
             requests.HTTPError: Raised if the HTTP request to retrieve the project fails (e.g., 4xx or 5xx response).
-        
+
         Tags:
             get, project, fetch, management, important
         """
@@ -109,17 +115,17 @@ class RocketlaneApp(APIApplication):
     def get_projects_by_projectid_tasks(self, projectId) -> Any:
         """
         Retrieves a list of tasks associated with a given project ID.
-        
+
         Args:
             projectId: str. The unique identifier of the project whose tasks are to be retrieved.
-        
+
         Returns:
             dict. A JSON object containing the list of tasks for the specified project.
-        
+
         Raises:
             ValueError: If the projectId parameter is None.
             requests.HTTPError: If the HTTP request to retrieve tasks fails (i.e., non-2xx response).
-        
+
         Tags:
             get, list, project-tasks, management, important
         """
@@ -131,10 +137,18 @@ class RocketlaneApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def create_task(self, projectId, taskDescription=None, taskName=None, assignee=None, startDate=None, dueDate=None) -> dict[str, Any]:
+    def create_task(
+        self,
+        projectId,
+        taskDescription=None,
+        taskName=None,
+        assignee=None,
+        startDate=None,
+        dueDate=None,
+    ) -> dict[str, Any]:
         """
         Creates a new task within the specified project, assigning optional details such as description, name, assignee, start date, and due date.
-        
+
         Args:
             projectId: str. The unique identifier of the project in which to create the task. Required.
             taskDescription: Optional[str]. A description of the task to be created.
@@ -142,25 +156,25 @@ class RocketlaneApp(APIApplication):
             assignee: Optional[str]. The user to whom the task is assigned.
             startDate: Optional[str]. The starting date for the task, formatted as an ISO 8601 string.
             dueDate: Optional[str]. The due date for task completion, formatted as an ISO 8601 string.
-        
+
         Returns:
             dict[str, Any]: A dictionary containing the details of the created task as returned by the API.
-        
+
         Raises:
             ValueError: If 'projectId' is not provided.
             requests.HTTPError: If the API request fails and returns a non-success HTTP status code.
-        
+
         Tags:
             create, task, management, project, api, important
         """
         if projectId is None:
             raise ValueError("Missing required parameter 'projectId'")
         request_body = {
-            'taskDescription': taskDescription,
-            'taskName': taskName,
-            'assignee': assignee,
-            'startDate': startDate,
-            'dueDate': dueDate,
+            "taskDescription": taskDescription,
+            "taskName": taskName,
+            "assignee": assignee,
+            "startDate": startDate,
+            "dueDate": dueDate,
         }
         request_body = {k: v for k, v in request_body.items() if v is not None}
         url = f"{self.base_url}/projects/{projectId}/tasks"
@@ -176,5 +190,5 @@ class RocketlaneApp(APIApplication):
             self.get_all_projects,
             self.get_projects_by_projectid,
             self.get_projects_by_projectid_tasks,
-            self.create_task
+            self.create_task,
         ]