universal-mcp 0.1.5__py3-none-any.whl → 0.1.6__py3-none-any.whl

universal_mcp/applications/e2b/README.md

@@ -0,0 +1,37 @@
+
+# E2B MCP Server
+
+An MCP Server for the E2B API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the E2B API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| execute_python_code | Executes Python code within a secure E2B cloud sandbox. |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the E2B app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/firecrawl/README.md

@@ -0,0 +1,45 @@
+
+# Firecrawl MCP Server
+
+An MCP Server for the Firecrawl API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Firecrawl API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| scrape_url | Scrapes a single URL using Firecrawl and returns the extracted data. |
+| search | Performs a web search using Firecrawl's search capability. |
+| start_crawl | Starts a crawl job for a given URL using Firecrawl. Returns the job ID immediately. |
+| check_crawl_status | Checks the status of a previously initiated Firecrawl crawl job. |
+| cancel_crawl | Cancels a currently running Firecrawl crawl job. |
+| start_batch_scrape | Starts a batch scrape job for multiple URLs using Firecrawl. |
+| check_batch_scrape_status | Checks the status of a previously initiated Firecrawl batch scrape job. |
+| start_extract | Starts an extraction job for one or more URLs using Firecrawl. |
+| check_extract_status | Checks the status of a previously initiated Firecrawl extraction job. |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Firecrawl app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/github/README.md

@@ -19,7 +19,19 @@ This tool can be integrated with any service that supports HTTP requests.
 
 ## Tool List
 
-No tools with documentation were found in this API client.
+| Tool | Description |
+|------|-------------|
+| create_issue | Create a new issue in a GitHub repository |
+| create_pull_request | Create a new pull request for a GitHub repository |
+| get_pull_request | Get a specific pull request for a GitHub repository |
+| list_branches | List branches for a GitHub repository |
+| list_commits | List recent commits for a GitHub repository |
+| list_issues | List issues for a GitHub repository |
+| list_pull_requests | List pull requests for a GitHub repository |
+| list_repo_activities | List activities for a GitHub repository |
+| star_repository | Star a GitHub repository |
+| update_issue | Update an issue in a GitHub repository |
+| validate | Function for validate |
 
 
 

universal_mcp/applications/google_docs/README.md

@@ -0,0 +1,40 @@
+
+# Google Docs MCP Server
+
+An MCP Server for the Google Docs API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Google Docs API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| add_content | Adds text content to an existing Google Document. |
+| create_document | Creates a new blank Google Document with the specified title. |
+| get_document | Gets the latest version of the specified document. |
+| validate | Function for validate |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Google Docs app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/google_docs/app.py

@@ -0,0 +1,93 @@
+from typing import Any
+
+from loguru import logger
+
+from universal_mcp.applications.application import APIApplication
+from universal_mcp.exceptions import NotAuthorizedError
+from universal_mcp.integrations import Integration
+
+
+class GoogleDocsApp(APIApplication):
+    def __init__(self, integration: Integration) -> None:
+        super().__init__(name="google-docs", integration=integration)
+        self.base_api_url = "https://docs.googleapis.com/v1/documents"
+    
+    def _get_headers(self):
+        if not self.integration:
+            raise ValueError("Integration not configured for GoogleDocsApp")
+        credentials = self.integration.get_credentials()
+        if not credentials:
+            logger.warning("No Google credentials found via integration.")
+            action = self.integration.authorize()
+            raise NotAuthorizedError(action)
+        if "headers" in credentials:
+            return credentials["headers"]
+        return {
+            "Authorization": f"Bearer {credentials['access_token']}",
+            "Content-Type": "application/json",
+        }
+    
+    def create_document(self, title: str) -> dict[str, Any]:
+        """
+        Creates a new blank Google Document with the specified title.
+        
+        Args:
+            title: The title of the document to create
+            
+        Returns:
+            The response from the Google Docs API
+        """
+        url = self.base_api_url
+        document_data = {"title": title}
+        response = self._post(url, data=document_data)
+        response.raise_for_status()
+        return response.json()
+    
+    def get_document(self, document_id: str) -> dict[str, Any]:
+        """
+        Gets the latest version of the specified document.
+        
+        Args:
+            document_id: The ID of the document to retrieve
+            
+        Returns:
+            The response from the Google Docs API containing the document data
+        """
+        url = f"{self.base_api_url}/{document_id}"
+        response = self._get(url)
+        return response.json()
+    
+    def add_content(self, document_id: str, content: str, index: int = 1) -> dict[str, Any]:
+        """
+        Adds text content to an existing Google Document.
+        
+        Args:
+            document_id: The ID of the document to update
+            content: The text content to insert
+            index: The position at which to insert the text (default: 1, beginning of document)
+            
+        Returns:
+            The response from the Google Docs API
+        """
+        url = f"{self.base_api_url}/{document_id}:batchUpdate"
+        batch_update_data = {
+            "requests": [
+                {
+                    "insertText": {
+                        "location": {"index": index},
+                        "text": content
+                    }
+                }
+            ]
+        }
+        
+        response = self._post(url, data=batch_update_data)
+        response.raise_for_status()
+        return response.json()
+    
+    def list_tools(self):
+        return [
+           self.create_document,
+           self.get_document,
+           self.add_content
+        ]

universal_mcp/applications/google_drive/README.md

@@ -0,0 +1,44 @@
+
+# Google Drive MCP Server
+
+An MCP Server for the Google Drive API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Google Drive API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| get_drive_info | Get information about the user's Google Drive, including storage quota and user info. |
+| list_files | List files in the user's Google Drive. |
+| create_file_from_text | Create a new file from text content in Google Drive. |
+| upload_a_file | Upload a file to Google Drive from a local binary file. |
+| find_folder_id_by_name | Find a folder's ID by its name. |
+| create_folder | Create a new folder in Google Drive. |
+| get_file | Get metadata for a specific file. |
+| delete_file | Delete a file from Google Drive. |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Google Drive app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/google_drive/app.py

@@ -0,0 +1,280 @@
+from typing import Any
+
+import httpx
+from loguru import logger
+
+from universal_mcp.applications.application import APIApplication
+from universal_mcp.exceptions import NotAuthorizedError
+from universal_mcp.integrations import Integration
+
+
+class GoogleDriveApp(APIApplication):
+    """
+    Application for interacting with Google Drive API.
+    Provides tools to manage files, folders, and access Drive information.
+    """
+
+    def __init__(self, integration: Integration | None = None) -> None:
+        super().__init__(name="google-drive", integration=integration)
+        self.base_url = "https://www.googleapis.com/drive/v3"
+
+    def _get_headers(self):
+        if not self.integration:
+            raise ValueError("Integration not configured for GoogleDriveApp")
+        credentials = self.integration.get_credentials()
+        if not credentials:
+            logger.warning("No Google Drive credentials found via integration.")
+            action = self.integration.authorize()
+            raise NotAuthorizedError(action)
+
+        if "headers" in credentials:
+            return credentials["headers"]
+        return {
+            "Authorization": f"Bearer {credentials['access_token']}",
+            "Content-Type": "application/json",
+        }
+
+    def get_drive_info(self) -> dict[str, Any]:
+        """
+        Get information about the user's Google Drive, including storage quota and user info.
+        
+        Returns:
+            A dictionary containing information about the user's Drive.
+            Includes details like storage quota, user information, and features.
+        """
+        url = f"{self.base_url}/about"
+        params = {"fields": "storageQuota,user"}
+        
+        response = self._get(url, params=params)
+        return response.json()
+
+    def list_files(self, page_size: int = 10, query: str = None, order_by: str = None) -> dict[str, Any]:
+        """
+        List files in the user's Google Drive.
+        
+        Args:
+            page_size: Maximum number of files to return (default: 10)
+            query: Search query using Google Drive query syntax (e.g., "mimeType='image/jpeg'")
+            order_by: Field to sort by (e.g., "modifiedTime desc")
+        
+        Returns:
+            A dictionary containing the list of files and possibly a nextPageToken.
+        """
+        url = f"{self.base_url}/files"
+        params = {
+            "pageSize": page_size,
+        }
+        
+        if query:
+            params["q"] = query
+        
+        if order_by:
+            params["orderBy"] = order_by
+        
+        response = self._get(url, params=params)
+        response.raise_for_status()
+        return response.json()
+    
+
+    def get_file(self, file_id: str) -> dict[str, Any]:
+        """
+        Get metadata for a specific file.
+        
+        Args:
+            file_id: The ID of the file to retrieve
+        
+        Returns:
+            A dictionary containing the file's metadata.
+        """
+        url = f"{self.base_url}/files/{file_id}"
+        response = self._get(url)
+        return response.json()
+
+    def delete_file(self, file_id: str) -> dict[str, Any]:
+        """
+        Delete a file from Google Drive.
+        
+        Args:
+            file_id: The ID of the file to delete
+        
+        Returns:
+            A simple success message dictionary
+        """
+        url = f"{self.base_url}/files/{file_id}"
+        try:
+            self._delete(url)
+            return {"message": "File deleted successfully"}
+        except Exception as e:
+            return {"error": str(e)}
+    
+    def create_file_from_text(
+        self,
+        file_name: str,
+        text_content: str,
+        parent_id: str = None,
+        mime_type: str = "text/plain"
+    ) -> dict[str, Any]:
+        """
+        Create a new file from text content in Google Drive.
+        
+        Args:
+            file_name: Name of the file to create on Google Drive
+            text_content: Plain text content to be written to the file
+            parent_id: ID of the parent folder to create the file in (optional)
+            mime_type: MIME type of the file (default: text/plain)
+        
+        Returns:
+            A dictionary containing the created file's metadata.
+        """
+        metadata = {
+            "name": file_name,
+            "mimeType": mime_type
+        }
+        
+        if parent_id:
+            metadata["parents"] = [parent_id]
+            
+        create_url = f"{self.base_url}/files"
+        create_response = self._post(create_url, data=metadata)
+        file_data = create_response.json()
+        file_id = file_data.get("id")
+        
+        # Step 2: Update the file with text content
+        upload_url = f"https://www.googleapis.com/upload/drive/v3/files/{file_id}?uploadType=media"
+        upload_headers = self._get_headers()
+        upload_headers["Content-Type"] = f"{mime_type}; charset=utf-8"
+        
+        upload_response = httpx.patch(
+            upload_url,
+            headers=upload_headers,
+            content=text_content.encode("utf-8")
+        )
+        upload_response.raise_for_status()
+        
+        response_data = upload_response.json()
+        return response_data
+        
+    def find_folder_id_by_name(self, folder_name: str) -> str | None:
+        """
+        Find a folder's ID by its name.
+        
+        Args:
+            folder_name: The name of the folder to find
+            
+        Returns:
+            The folder ID if found, None otherwise
+        """
+        query = f"mimeType='application/vnd.google-apps.folder' and name='{folder_name}' and trashed=false"
+        try:
+            response = self._get(
+                f"{self.base_url}/files",
+                params={"q": query, "fields": "files(id,name)"}
+            )
+            files = response.json().get("files", [])
+            return files[0]["id"] if files else None
+        except Exception as e:
+            logger.error(f"Error finding folder ID by name: {e}")
+            return None
+    
+    def create_folder(self, folder_name: str, parent_id: str = None) -> dict[str, Any]:
+        """
+        Create a new folder in Google Drive.
+        
+        Args:
+            folder_name: Name of the folder to create
+            parent_id: ID of the parent folder (optional). Can be an actual folder ID
+                       or a folder name that will be looked up.
+                       
+        Returns:
+            A dictionary containing the created folder's metadata.
+        """
+        import re
+        
+        metadata = {
+            "name": folder_name,
+            "mimeType": "application/vnd.google-apps.folder"
+        }
+        
+        if parent_id:
+            if not re.match(r"^[a-zA-Z0-9_-]{28,33}$", parent_id):
+                found_id = self.find_folder_id_by_name(parent_id)
+                if found_id:
+                    metadata["parents"] = [found_id]
+                else:
+                    raise ValueError(f"Could not find parent folder with name: {parent_id}")
+            else:
+                metadata["parents"] = [parent_id]
+                
+        url = f"{self.base_url}/files"
+        params = {"supportsAllDrives": "true"}
+        
+        response = self._post(url, data=metadata, params=params)
+        return response.json()
+
+    def upload_a_file(
+        self,
+        file_name: str,
+        file_path: str,
+        parent_id: str = None,
+        mime_type: str = None
+    ) -> dict[str, Any]:
+        """
+        Upload a file to Google Drive from a local binary file.
+        
+        This method is suitable for files under 5MB in size. It automatically
+        reads the file from the provided path.
+        
+        Args:
+            file_name: Name to give the file on Google Drive
+            file_path: Path to the local file to upload
+            parent_id: ID of the parent folder to create the file in (optional)
+            mime_type: MIME type of the file 
+                       Examples: 'image/jpeg', 'image/png', 'application/pdf', 'text/csv'
+        
+        Returns:
+            A dictionary containing the created file's metadata.
+        """
+        
+            
+        metadata = {
+            "name": file_name,
+            "mimeType": mime_type
+        }
+        
+        if parent_id:
+            metadata["parents"] = [parent_id]
+            
+        create_url = f"{self.base_url}/files"
+        create_response = self._post(create_url, data=metadata)
+        file_data = create_response.json()
+        file_id = file_data.get("id")
+        
+        with open(file_path, 'rb') as file_content:
+            binary_content = file_content.read()
+            
+            upload_url = f"https://www.googleapis.com/upload/drive/v3/files/{file_id}?uploadType=media"
+            upload_headers = self._get_headers()
+            upload_headers["Content-Type"] = mime_type
+            
+            upload_response = httpx.patch(
+                upload_url,
+                headers=upload_headers,
+                content=binary_content
+            )
+            upload_response.raise_for_status()
+        
+        response_data = upload_response.json()
+        return response_data
+
+    def list_tools(self):
+        """Returns a list of methods exposed as tools."""
+        return [
+            self.get_drive_info,
+            self.list_files,
+            self.create_file_from_text,
+            self.upload_a_file,
+            self.find_folder_id_by_name,
+            self.create_folder,
+            self.get_file,
+            self.delete_file,
+        ]

universal_mcp/applications/google_mail/README.md

@@ -0,0 +1,47 @@
+
+# Google Mail MCP Server
+
+An MCP Server for the Google Mail API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Google Mail API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| create_draft | Create a draft email |
+| create_label | Create a new Gmail label |
+| get_draft | Get a specific draft email by ID |
+| get_message | Get a specific email message by ID |
+| get_profile | Retrieve the user's Gmail profile information. |
+| list_drafts | List drafts in the user's mailbox |
+| list_labels | List all labels in the user's Gmail account |
+| list_messages | List messages in the user's mailbox |
+| send_draft | Send an existing draft email |
+| send_email | Send an email |
+| validate | Function for validate |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Google Mail app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/google_sheet/README.md

@@ -0,0 +1,42 @@
+
+# Google Sheet MCP Server
+
+An MCP Server for the Google Sheet API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Google Sheet API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| create_spreadsheet | Creates a new blank Google Spreadsheet with the specified title. |
+| get_spreadsheet | Returns the spreadsheet details. |
+| batch_get_values | Returns one or more ranges of values from a spreadsheet. |
+| clear_values | Clears values from a spreadsheet. Only values are cleared -- all other properties 
+of the cell (such as formatting, data validation, etc.) are kept. |
+| update_values | Sets values in a range of a spreadsheet. |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Google Sheet app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/google_sheet/app.py

@@ -0,0 +1,152 @@
+from typing import Any
+
+from loguru import logger
+
+from universal_mcp.applications.application import APIApplication
+from universal_mcp.exceptions import NotAuthorizedError
+from universal_mcp.integrations import Integration
+
+
+class GoogleSheetApp(APIApplication):
+    """
+    Application for interacting with Google Sheets API.
+    Provides tools to create and manage Google Spreadsheets.
+    """
+    
+    def __init__(self, integration: Integration | None = None) -> None:
+        super().__init__(name="google-sheet", integration=integration)
+        self.base_api_url = "https://sheets.googleapis.com/v4/spreadsheets"
+    
+    def _get_headers(self):
+        if not self.integration:
+            raise ValueError("Integration not configured for GoogleSheetsApp")
+        credentials = self.integration.get_credentials()
+        if not credentials:
+            logger.warning("No Google credentials found via integration.")
+            action = self.integration.authorize()
+            raise NotAuthorizedError(action)
+        if "headers" in credentials:
+            return credentials["headers"]
+        return {
+            "Authorization": f"Bearer {credentials['access_token']}",
+            "Content-Type": "application/json",
+        }
+    
+    def create_spreadsheet(self, title: str) -> dict[str, Any]:
+        """
+        Creates a new blank Google Spreadsheet with the specified title.
+        
+        Args:
+            title: The title of the spreadsheet to create required , which is provided by the user
+            
+        Returns:
+            The response from the Google Sheets API
+        """
+        url = self.base_api_url
+        spreadsheet_data = {
+            "properties": {
+                "title": title
+            }
+        }
+        
+        response = self._post(url, data=spreadsheet_data)
+        return response.json()
+    
+    def get_spreadsheet(self, spreadsheet_id: str) -> dict[str, Any]:
+        """
+        Returns the spreadsheet details.
+        
+        Args:
+            spreadsheet_id: The ID of the spreadsheet to retrieve
+            
+        Returns:
+            The response from the Google Sheets API containing the spreadsheet data and details
+        """
+        url = f"{self.base_api_url}/{spreadsheet_id}"
+        response = self._get(url)
+        return response.json()
+    
+    def batch_get_values(self, spreadsheet_id: str, ranges: list[str] = None) -> dict[str, Any]:
+        """
+        Returns one or more ranges of values from a spreadsheet.
+        
+        Args:
+            spreadsheet_id: The ID of the spreadsheet to retrieve values from
+            ranges: Optional list of A1 notation or R1C1 notation ranges to retrieve values from
+                   (e.g. ['Sheet1!A1:B2', 'Sheet2!C3:D4'])
+            
+        Returns:
+            The response from the Google Sheets API containing the requested values
+        """
+        url = f"{self.base_api_url}/{spreadsheet_id}/values:batchGet"
+        
+        params = {}
+        if ranges:
+            params["ranges"] = ranges
+            
+        response = self._get(url, params=params)
+        return response.json()
+    
+    def clear_values(self, spreadsheet_id: str, range: str) -> dict[str, Any]:
+        """
+        Clears values from a spreadsheet. Only values are cleared -- all other properties 
+        of the cell (such as formatting, data validation, etc.) are kept.
+        
+        Args:
+            spreadsheet_id: The ID of the spreadsheet to update
+            range: The A1 notation or R1C1 notation of the values to clear
+                  (e.g. 'Sheet1!A1:B2')
+            
+        Returns:
+            The response from the Google Sheets API
+        """
+        url = f"{self.base_api_url}/{spreadsheet_id}/values/{range}:clear"
+        
+        response = self._post(url, data={})
+        return response.json()
+    
+    def update_values(
+        self, 
+        spreadsheet_id: str, 
+        range: str, 
+        values: list[list[Any]], 
+        value_input_option: str = "RAW"
+    ) -> dict[str, Any]:
+        """
+        Sets values in a range of a spreadsheet. 
+        
+        Args:
+            spreadsheet_id: The ID of the spreadsheet to update
+            range: The A1 notation of the values to update (e.g. 'Sheet1!A1:B2')
+            values: The data to write, as a list of lists (rows of values)
+            value_input_option: How the input data should be interpreted. 
+                                Accepted values are:
+                                - "RAW": The values will be stored as-is
+                                - "USER_ENTERED": The values will be parsed as if the user typed them into the UI
+                
+        Returns:
+            The response from the Google Sheets API
+        """
+        url = f"{self.base_api_url}/{spreadsheet_id}/values/{range}"
+        
+        params = {
+            "valueInputOption": value_input_option
+        }
+        
+        data = {
+            "range": range,
+            "values": values
+        }
+        
+        response = self._put(url, data=data, params=params)
+        return response.json()
+    
+    def list_tools(self):
+        """Returns a list of methods exposed as tools."""
+        return [
+           self.create_spreadsheet,
+           self.get_spreadsheet,
+           self.batch_get_values,
+           self.clear_values,
+           self.update_values
+        ]

universal_mcp/applications/perplexity/README.md

@@ -0,0 +1,37 @@
+
+# Perplexity MCP Server
+
+An MCP Server for the Perplexity API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Perplexity API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| chat | Sends a query to a Perplexity Sonar online model and returns the response. |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Perplexity app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/reddit/README.md

@@ -0,0 +1,45 @@
+
+# Reddit MCP Server
+
+An MCP Server for the Reddit API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Reddit API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| create_post | Create a new post in a specified subreddit. |
+| delete_content | Delete a Reddit post or comment. |
+| edit_content | Edit the text content of a Reddit post or comment. |
+| get_comment_by_id | Retrieve a specific Reddit comment by its full ID (t1_commentid). |
+| get_post_flairs | Retrieve the list of available post flairs for a specific subreddit. |
+| get_subreddit_posts | Get the top posts from a specified subreddit over a given timeframe. |
+| post_comment | Post a comment to a Reddit post or another comment. |
+| search_subreddits | Search for subreddits matching a query string. |
+| validate | Function for validate |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Reddit app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/resend/README.md

@@ -0,0 +1,38 @@
+
+# Resend MCP Server
+
+An MCP Server for the Resend API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Resend API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| send_email | Send an email using the Resend API |
+| validate | Function for validate |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Resend app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/serp/README.md

@@ -0,0 +1,37 @@
+
+# Serp MCP Server
+
+An MCP Server for the Serp API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Serp API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| search | Perform a search on the specified engine using SerpApi. |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Serp app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/tavily/README.md

@@ -0,0 +1,38 @@
+
+# Tavily MCP Server
+
+An MCP Server for the Tavily API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Tavily API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| search | Search the web using Tavily's search API |
+| validate | Function for validate |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Tavily app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/applications/zenquotes/README.md

@@ -0,0 +1,37 @@
+
+# Zenquotes MCP Server
+
+An MCP Server for the Zenquotes API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Zenquotes API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| get_quote | Get an inspirational quote from the Zen Quotes API |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Zenquotes app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server

universal_mcp/cli.py

@@ -110,16 +110,16 @@ def run(
 ):
     """Run the MCP server"""
     from universal_mcp.config import ServerConfig
-
-    # from universal_mcp.logger import setup_logger
+    from universal_mcp.logger import setup_logger
     from universal_mcp.servers import server_from_config
 
+    setup_logger()
+
     if config_path:
         config = ServerConfig.model_validate_json(config_path.read_text())
     else:
         config = ServerConfig()
     server = server_from_config(config)
-    # setup_logger()
     server.run(transport=config.transport)
 
 

universal_mcp/logger.py

@@ -53,16 +53,16 @@ def posthog_sink(message, user_id=get_user_id()):
 
 def setup_logger():
     logger.remove()
-    logger.add(
-        sink=sys.stdout,
-        format="<green>{time:YYYY-MM-DD HH:mm:ss}</green> | <level>{level: <8}</level> | <cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - <level>{message}</level>",
-        level="INFO",
-        colorize=True,
-    )
+    # logger.add(
+    #     sink=sys.stdout,
+    #     format="<green>{time:YYYY-MM-DD HH:mm:ss}</green> | <level>{level: <8}</level> | <cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - <level>{message}</level>",
+    #     level="INFO",
+    #     colorize=True,
+    # )
     logger.add(
         sink=sys.stderr,
         format="<red>{time:YYYY-MM-DD HH:mm:ss}</red> | <level>{level: <8}</level> | <cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - <level>{message}</level>",
-        level="ERROR",
+        level="WARNING",
         colorize=True,
     )
     telemetry_enabled = os.getenv("TELEMETRY_ENABLED", "true").lower() == "true"

universal_mcp/utils/dump_app_tools.py

@@ -0,0 +1,68 @@
+import csv
+from pathlib import Path
+
+from universal_mcp.applications import app_from_slug
+
+
+def discover_available_app_slugs():
+    apps_dir = Path(__file__).resolve().parent.parent / "applications"
+    app_slugs = []
+    
+    for item in apps_dir.iterdir():
+        if not item.is_dir() or item.name.startswith('_'):
+            continue
+        
+        if (item / "app.py").exists():
+            slug = item.name.replace("_", "-")
+            app_slugs.append(slug)
+    
+    return app_slugs
+
+def extract_app_tools(app_slugs):
+    all_apps_tools = []
+    
+    for slug in app_slugs:
+        try:
+            print(f"Loading app: {slug}")
+            app_class = app_from_slug(slug)
+            
+            app_instance = app_class(integration=None)
+            
+            tools = app_instance.list_tools()
+            
+            for tool in tools:
+                tool_name = tool.__name__
+                description = tool.__doc__.strip().split('\n')[0] if tool.__doc__ else "No description"
+                
+                all_apps_tools.append({
+                    "app_name": slug,
+                    "tool_name": tool_name,
+                    "description": description
+                })
+                
+        except Exception as e:
+            print(f"Error loading app {slug}: {e}")
+    
+    return all_apps_tools
+
+def write_to_csv(app_tools, output_file="app_tools.csv"):
+    fieldnames = ["app_name", "tool_name", "description"]
+    
+    with open(output_file, 'w', newline='') as csvfile:
+        writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
+        writer.writeheader()
+        writer.writerows(app_tools)
+    
+    print(f"CSV file created: {output_file}")
+
+def main():
+    app_slugs = discover_available_app_slugs()
+    print(f"Found {len(app_slugs)} app slugs: {', '.join(app_slugs)}")
+    
+    app_tools = extract_app_tools(app_slugs)
+    print(f"Extracted {len(app_tools)} tools from all apps")
+    
+    write_to_csv(app_tools)
+
+if __name__ == "__main__":
+    main()

{universal_mcp-0.1.5.dist-info → universal_mcp-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp
-Version: 0.1.5
+Version: 0.1.6
 Summary: Universal MCP acts as a middle ware for your API applications. It can store your credentials, authorize, enable disable apps on the fly and much more.
 Author-email: Manoj Bajaj <manojbajaj95@gmail.com>
 Requires-Python: >=3.11

{universal_mcp-0.1.5.dist-info → universal_mcp-0.1.6.dist-info}/RECORD

@@ -1,26 +1,41 @@
 universal_mcp/__init__.py,sha256=2gdHpHaDDcsRjZjJ01FLN-1iidN_wbDAolNpxhGoFB4,59
-universal_mcp/cli.py,sha256=SO-d2a4QI6e3TLjDcwP6pGF0oWzummOh3a2CJBbqA68,5262
+universal_mcp/cli.py,sha256=DG-Qxc5vQIdbhAIQuU7bKKJuRGzwyOigjfCKSWBRhBI,5258
 universal_mcp/config.py,sha256=9eb3DDg4PBBr1MlGeBrA4bja3Y6howOH-UKpo7JIbs8,828
 universal_mcp/exceptions.py,sha256=Zp2_v_m3L7GDAmD1ZyuwFtY6ngapdhxuIygrvpZAQtM,271
-universal_mcp/logger.py,sha256=8_yoD3mGbm0VpJitb0k_DJskC2kcRNi2dqpKTdz7ijo,2001
+universal_mcp/logger.py,sha256=W6A868vyvpdkEQ4Dd0rWdC_7ErSxSQ1z2uxCb77IM8Y,2015
 universal_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 universal_mcp/applications/__init__.py,sha256=qeWnbdIudyMR7ST4XTc0gpEM9o6TsM1ZnZ92dMAPSBA,754
 universal_mcp/applications/application.py,sha256=dqp8lgIi2xhY62imwo7C6769URQtNmqd6Ok6PiTr6wc,3399
+universal_mcp/applications/e2b/README.md,sha256=S4lTp-vEZ8VTCKPXqjUXu5nYlUMAF8lw8CQyBGPgxjs,700
 universal_mcp/applications/e2b/app.py,sha256=5piCipi1TC_KuKLFP17do1Y1r28fqApvRsZy76equ9w,2573
+universal_mcp/applications/firecrawl/README.md,sha256=KAWe_TQbrc9eA6bSyde5dapMP1CNvarVItV_YJH3d_0,1430
 universal_mcp/applications/firecrawl/app.py,sha256=RSy8zRn4k1A1tIpJNqrUnPI8ctEv1nKWuOuJQcp9mGo,9264
-universal_mcp/applications/github/README.md,sha256=m_6FlPpx9l5y29TkFMewCXMXSRHriDtj71qyYYeFzCw,643
+universal_mcp/applications/github/README.md,sha256=6ID-__gUJ5ZxzAS_OjzmoUAag1LamSvEB75DHcj3m-g,1294
 universal_mcp/applications/github/app.py,sha256=L201f5MSx1YVx0nqgduZ5gyHPZdX0UfcEhPmDWiWK6s,13686
 universal_mcp/applications/google_calendar/app.py,sha256=g_3vrsM2ltwpTySgC5I4SYg47n4UJiYigECO0ax1EHM,19134
+universal_mcp/applications/google_docs/README.md,sha256=SyOgJG-XU0FXhrVukvg9mxwin73mpqaCOT6rDJ64Klk,909
+universal_mcp/applications/google_docs/app.py,sha256=RGpk4xW6u2rA62zkjsokDbhff3bk_bGt261ToQlAQNY,3157
+universal_mcp/applications/google_drive/README.md,sha256=YlN8IT12oO8zVMib1MlTYRBGNP7rzW_KyVAZyyxKvME,1192
+universal_mcp/applications/google_drive/app.py,sha256=PUK19kZlYNWn3_4Us1179_gc6o_565B4hsfxUleeR68,9546
+universal_mcp/applications/google_mail/README.md,sha256=LL6TjjmwEqyuRVvIfCh-I_PlWp9ciCZOdJC0LafGZYc,1185
 universal_mcp/applications/google_mail/app.py,sha256=VXeD3_TRgYIUDFUzDPCKgR47XvovxLFulD-HG22hls8,22716
+universal_mcp/applications/google_sheet/README.md,sha256=yW1b_qlb_pbIJzCxZc58581kKzC5vyP8Mj4iwXgidtQ,1108
+universal_mcp/applications/google_sheet/app.py,sha256=zYsi_vTpJ-BtBPH6rQFRfwAJJkN_d8DJm6tFUzJBOSw,5399
 universal_mcp/applications/markitdown/app.py,sha256=Gh12f1dW6DA_AW5DuStbCkOR7KtyJp8VEjdTaIicrRI,1996
 universal_mcp/applications/notion/README.md,sha256=45NmPOmSQv99qBvWdwmnV5vbaYc9_8vq8I-FA7veVAA,2600
 universal_mcp/applications/notion/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 universal_mcp/applications/notion/app.py,sha256=XpLnmeXj0Gnf_RYHlbAFnwtSCTYsrNzk6MSMSyDmHGQ,17283
+universal_mcp/applications/perplexity/README.md,sha256=QGV1iReH5p-Np7vvkZsVHxxDKQ0YaitHEwomNmGEyQs,732
 universal_mcp/applications/perplexity/app.py,sha256=J27IDcz9pRC_uW4wABpn-EcI4RvKIzoh_o2hzysM5wA,3187
+universal_mcp/applications/reddit/README.md,sha256=YVbJ1RN6NWlB-P6w2LxCk_DuUWl7mwaKZScY-mIMnNc,1271
 universal_mcp/applications/reddit/app.py,sha256=leU__w5VxX1vMK-kfuy-dvY97Pn8Mn80X2payVshirU,13562
+universal_mcp/applications/resend/README.md,sha256=k-sb2UwbFvDPEz6qQPLWd2cJj8hDx5f3NW7dz2jAfjI,719
 universal_mcp/applications/resend/app.py,sha256=bRo-CRDuk65EUSHOJnbVHWV6TuiUHtedz6FXKRS1ym0,1386
+universal_mcp/applications/serp/README.md,sha256=hX4VeT2iL_67ZsMhKd60DAujQCh9K3IdHroHIq808RY,691
 universal_mcp/applications/serp/app.py,sha256=hPXu1sBiRZRCCzr4q2uvt54F0-B3aZK2Uz4wfKokkZ4,3131
+universal_mcp/applications/tavily/README.md,sha256=cNg4EwX5wBbkDpPtNBNC3A_GxglfSVhdAJuweSrXN20,721
 universal_mcp/applications/tavily/app.py,sha256=FSIRFz7jwm2i9wiDpRWIoQBxHaJ6dl89AjSZY9WP2VE,1776
+universal_mcp/applications/zenquotes/README.md,sha256=wA3hjqjrkrczQaffpwyolSKq6gXmkLgeHx6_EQrYEOY,709
 universal_mcp/applications/zenquotes/app.py,sha256=nidRGwVORIU25QGCCbjDIv1UNFUj5nWA3qqK4JP0Tdg,621
 universal_mcp/integrations/README.md,sha256=lTAPXO2nivcBe1q7JT6PRa6v9Ns_ZersQMIdw-nmwEA,996
 universal_mcp/integrations/__init__.py,sha256=8e11JZyctaR9CmlNkfEZ6HhGDvhlvf9iug2wdjb5pwY,270
@@ -34,9 +49,10 @@ universal_mcp/utils/__init__.py,sha256=8wi4PGWu-SrFjNJ8U7fr2iFJ1ktqlDmSKj1xYd7KS
 universal_mcp/utils/api_generator.py,sha256=-wRBpLVfJQXy1R-8FpDNs6b8_eeekVDuPc_uwjSGgiY,8883
 universal_mcp/utils/bridge.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 universal_mcp/utils/docgen.py,sha256=yK6Ijo8G-wHPU3E1AnFpnXS9vXt2j9FM77w0etTaNOA,12639
+universal_mcp/utils/dump_app_tools.py,sha256=cLB9SumKsbs-rXJ_02lpMyyNkOmKZ57gekhCjhAlcHg,2009
 universal_mcp/utils/installation.py,sha256=uSL_H76fG_7yN4QNxkfp1mEF_00iAPyiXqtdWEMVJe8,3747
 universal_mcp/utils/openapi.py,sha256=ud_ZB7_60BcS1Vao7ESKDqo0gry9JN5wzy-CFssrjm8,13140
-universal_mcp-0.1.5.dist-info/METADATA,sha256=ZnW_mze17x2bfioT-ZaurQcfxpA3j5tbNuIfvO_sCwE,10852
-universal_mcp-0.1.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-universal_mcp-0.1.5.dist-info/entry_points.txt,sha256=QlBrVKmA2jIM0q-C-3TQMNJTTWOsOFQvgedBq2rZTS8,56
-universal_mcp-0.1.5.dist-info/RECORD,,
+universal_mcp-0.1.6.dist-info/METADATA,sha256=8R7LIzbEuCr2cB6yaLxZG8HD9ISZz_H0jJqquPXSiaw,10852
+universal_mcp-0.1.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+universal_mcp-0.1.6.dist-info/entry_points.txt,sha256=QlBrVKmA2jIM0q-C-3TQMNJTTWOsOFQvgedBq2rZTS8,56
+universal_mcp-0.1.6.dist-info/RECORD,,