universal-mcp 0.1.8rc1__py3-none-any.whl → 0.1.8rc3__py3-none-any.whl

universal_mcp/__init__.py

@@ -1,2 +0,0 @@
-def hello() -> str:
-    return "Hello from universal-mcp!"

universal_mcp/analytics.py

@@ -0,0 +1,75 @@
+import os
+import uuid
+from functools import lru_cache
+from importlib.metadata import version
+
+import posthog
+from loguru import logger
+
+
+class Analytics:
+    _instance = None
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+            cls._instance._initialize()
+        return cls._instance
+
+    def _initialize(self):
+        """Initialize the Analytics singleton"""
+        posthog.host = "https://us.i.posthog.com"
+        posthog.api_key = "phc_6HXMDi8CjfIW0l04l34L7IDkpCDeOVz9cOz1KLAHXh8"
+        self.enabled = os.getenv("TELEMETRY_DISABLED", "false").lower() != "true"
+        self.user_id = str(uuid.uuid4())[:8]
+
+    @staticmethod
+    @lru_cache(maxsize=1)
+    def get_version():
+        """
+        Get the version of the Universal MCP
+        """
+        try:
+            return version("universal_mcp")
+        except ImportError:
+            return "unknown"
+
+    def track_app_loaded(self, app_name: str):
+        """Track when the app is loaded"""
+        if not self.enabled:
+            return
+        try:
+            properties = {
+                "version": self.get_version(),
+                "app_name": app_name,
+            }
+            posthog.capture(self.user_id, "app_loaded", properties)
+        except Exception as e:
+            logger.error(f"Failed to track app_loaded event: {e}")
+
+    def track_tool_called(
+        self, tool_name: str, status: str, error: str = None, user_id=None
+    ):
+        """Track when a tool is called
+
+        Args:
+            tool_name: Name of the tool being called
+            status: Status of the tool call (success/error)
+            error: Error message if status is error
+            user_id: Optional user ID to track
+        """
+        if not self.enabled:
+            return
+        try:
+            properties = {
+                "tool_name": tool_name,
+                "status": status,
+                "error": error,
+                "version": self.get_version(),
+            }
+            posthog.capture(self.user_id, "tool_called", properties)
+        except Exception as e:
+            logger.error(f"Failed to track tool_called event: {e}")
+
+
+analytics = Analytics()

universal_mcp/applications/application.py

@@ -27,6 +27,7 @@ class APIApplication(Application):
 
     def __init__(self, name: str, integration: Integration = None, **kwargs):
         super().__init__(name, **kwargs)
+        self.default_timeout = 30
         self.integration = integration
 
     def _get_headers(self):
@@ -35,7 +36,9 @@ class APIApplication(Application):
     def _get(self, url, params=None):
         try:
             headers = self._get_headers()
-            response = httpx.get(url, headers=headers, params=params)
+            response = httpx.get(
+                url, headers=headers, params=params, timeout=self.default_timeout
+            )
             response.raise_for_status()
             return response
         except NotAuthorizedError as e:
@@ -48,7 +51,13 @@ class APIApplication(Application):
     def _post(self, url, data, params=None):
         try:
             headers = self._get_headers()
-            response = httpx.post(url, headers=headers, json=data, params=params)
+            response = httpx.post(
+                url,
+                headers=headers,
+                json=data,
+                params=params,
+                timeout=self.default_timeout,
+            )
             response.raise_for_status()
             return response
         except NotAuthorizedError as e:
@@ -66,7 +75,13 @@ class APIApplication(Application):
     def _put(self, url, data, params=None):
         try:
             headers = self._get_headers()
-            response = httpx.put(url, headers=headers, json=data, params=params)
+            response = httpx.put(
+                url,
+                headers=headers,
+                json=data,
+                params=params,
+                timeout=self.default_timeout,
+            )
             response.raise_for_status()
             return response
         except NotAuthorizedError as e:
@@ -79,7 +94,9 @@ class APIApplication(Application):
     def _delete(self, url, params=None):
         try:
             headers = self._get_headers()
-            response = httpx.delete(url, headers=headers, params=params)
+            response = httpx.delete(
+                url, headers=headers, params=params, timeout=self.default_timeout
+            )
             response.raise_for_status()
             return response
         except NotAuthorizedError as e:
@@ -92,7 +109,13 @@ class APIApplication(Application):
     def _patch(self, url, data, params=None):
         try:
             headers = self._get_headers()
-            response = httpx.patch(url, headers=headers, json=data, params=params)
+            response = httpx.patch(
+                url,
+                headers=headers,
+                json=data,
+                params=params,
+                timeout=self.default_timeout,
+            )
             response.raise_for_status()
             return response
         except NotAuthorizedError as e:

universal_mcp/applications/calendly/README.md

@@ -0,0 +1,78 @@
+
+# Calendly MCP Server
+
+An MCP Server for the Calendly API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Calendly API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| list_event_invitees | Retrieves a list of invitees for a specific scheduled event, optionally filtered and paginated by status, email, sorting order, and paging parameters. |
+| get_event | Retrieves the details of a scheduled event given its UUID. |
+| get_event_invitee | Retrieves details about a specific invitee for a given scheduled event. |
+| list_events | Retrieves a list of scheduled events filtered by optional user, organization, invitee email, status, date range, sorting, and pagination criteria. |
+| get_event_type | Retrieves the event type details for the specified UUID from the API. |
+| list_user_sevent_types | Retrieves a list of user event types with optional filtering, sorting, and pagination parameters. |
+| get_user | Retrieves detailed user information for a given UUID from the remote API. |
+| get_current_user | Retrieves information about the currently authenticated user from the API. |
+| list_organization_invitations | Retrieves a paginated list of invitations for a specified organization, with optional filtering and sorting. |
+| invite_user_to_organization | Sends an invitation to a specified email address to join an organization identified by its UUID. |
+| get_organization_invitation | Retrieves a specific invitation for an organization using its unique identifiers. |
+| revoke_user_sorganization_invitation | Revokes a user's invitation to an organization by deleting the specified invitation resource. |
+| get_organization_membership | Retrieves the membership information for a specified organization membership UUID. |
+| remove_user_from_organization | Removes a user from the organization by deleting their membership using the specified UUID. |
+| list_organization_memberships | Retrieves a list of organization memberships, optionally filtered by pagination, email, organization, or user parameters. |
+| get_webhook_subscription | Retrieves the details of a webhook subscription identified by its UUID. |
+| delete_webhook_subscription | Deletes a webhook subscription identified by its UUID. |
+| list_webhook_subscriptions | Retrieves a list of webhook subscriptions, optionally filtered and paginated based on input criteria. |
+| create_webhook_subscription | Creates a new webhook subscription with the specified parameters and returns the subscription details as a dictionary. |
+| create_single_use_scheduling_link | Creates a single-use scheduling link by sending a POST request with optional restrictions. |
+| delete_invitee_data | Deletes invitee data for the specified email addresses by sending a POST request to the data compliance API. |
+| delete_scheduled_event_data | Deletes scheduled event data within the specified time range by sending a deletion request to the data compliance service. |
+| get_invitee_no_show | Retrieves details about an invitee who did not show up for a scheduled event, identified by a unique UUID. |
+| delete_invitee_no_show | Deletes an invitee no-show record identified by the given UUID. |
+| create_invitee_no_show | Creates an invitee no-show record by sending a POST request to the invitee_no_shows endpoint. |
+| get_group | Retrieves information for a group identified by its UUID from the server. |
+| list_groups | Retrieves a list of groups from the API, optionally filtered by organization and paginated using a page token and count. |
+| get_group_relationship | Retrieves the relationship information for a group specified by UUID from the API. |
+| list_group_relationships | Retrieves a list of group relationships from the server, optionally filtered by pagination and various group ownership parameters. |
+| get_routing_form | Retrieves a routing form by its unique identifier from the server. |
+| list_routing_forms | Retrieves a paginated list of routing forms from the API, optionally filtered and sorted by organization, count, page token, or sort order. |
+| get_routing_form_submission | Retrieves a routing form submission by its unique identifier (UUID) from the configured API endpoint. |
+| list_routing_form_submissions | Retrieves a list of routing form submissions, optionally filtered and paginated based on provided parameters. |
+| list_event_type_available_times | Retrieves available times for a specified event type within an optional date and time range. |
+| list_activity_log_entries | Retrieves a list of activity log entries with optional filtering, sorting, and pagination. |
+| create_share | Creates a new share with the specified configuration parameters by making a POST request to the shares API endpoint. |
+| list_user_busy_times | Retrieves a list of busy time intervals for a specified user within an optional date range. |
+| get_user_availability_schedule | Retrieves the availability schedule for a user identified by the given UUID. |
+| list_user_availability_schedules | Retrieves a list of user availability schedules from the API, optionally filtering by a specific user. |
+| list_event_type_hosts | Retrieves a list of event type hosts based on provided filter, count, and pagination parameters. |
+| create_one_off_event_type | Creates a one-off event type with specified parameters and returns the created event type details. |
+| get_sample_webhook_data | Retrieves sample webhook data from the API using optional filtering parameters. |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Calendly app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server