universal-mcp-applications 0.1.17__py3-none-any.whl → 0.1.19__py3-none-any.whl

universal_mcp/applications/reddit/app.py

@@ -49,20 +49,20 @@ class RedditApp(APIApplication):
         self, subreddit: str, limit: int = 5, timeframe: str = "day"
     ) -> dict[str, Any]:
         """
-        Fetches top posts from a given subreddit, filterable by time.
-
+        Fetches a specified number of top-rated posts from a particular subreddit, allowing results to be filtered by a specific timeframe (e.g., 'day', 'week'). This is a simplified version compared to `get_subreddit_top_posts`, which uses more complex pagination parameters instead of a direct time filter.
+        
         Args:
             subreddit: The name of the subreddit (e.g., 'python', 'worldnews') without the 'r/' prefix
             limit: The maximum number of posts to return (default: 5, max: 100)
             timeframe: The time period for top posts. Valid options: 'hour', 'day', 'week', 'month', 'year', 'all' (default: 'day')
-
+        
         Returns:
             A formatted string containing a numbered list of top posts, including titles, authors, scores, and URLs, or an error message if the request fails
-
+        
         Raises:
             RequestException: When the HTTP request to the Reddit API fails
             JSONDecodeError: When the API response contains invalid JSON
-
+        
         Tags:
             fetch, reddit, api, list, social-media, important, read-only
         """
@@ -85,20 +85,20 @@ class RedditApp(APIApplication):
         self, query: str, limit: int = 5, sort: str = "relevance"
     ) -> str:
         """
-        Searches Reddit for subreddits matching a given query string and returns a formatted list of results including subreddit names, subscriber counts, and descriptions.
-
+        Searches for subreddits by name and description using a query string, with results sortable by relevance or activity. Unlike the broader `search_reddit` function, this method exclusively discovers subreddits, not posts, comments, or users.
+        
         Args:
             query: The text to search for in subreddit names and descriptions
             limit: The maximum number of subreddits to return, between 1 and 100 (default: 5)
             sort: The order of results, either 'relevance' or 'activity' (default: 'relevance')
-
+        
         Returns:
             A formatted string containing a list of matching subreddits with their names, subscriber counts, and descriptions, or an error message if the search fails or parameters are invalid
-
+        
         Raises:
             RequestException: When the HTTP request to Reddit's API fails
             JSONDecodeError: When the API response contains invalid JSON
-
+        
         Tags:
             search, important, reddit, api, query, format, list, validation
         """
@@ -123,18 +123,18 @@ class RedditApp(APIApplication):
 
     def get_post_flairs(self, subreddit: str):
         """
-        Retrieves a list of available post flairs for a specified subreddit using the Reddit API.
-
+        Fetches a list of available post flairs (tags) for a specified subreddit. This is primarily used to discover the correct `flair_id` needed to categorize a new submission when using the `create_post` function. It returns flair details or a message if none are available.
+        
         Args:
             subreddit: The name of the subreddit (e.g., 'python', 'worldnews') without the 'r/' prefix
-
+        
         Returns:
             A list of dictionaries containing flair details if flairs exist, or a string message indicating no flairs are available
-
+        
         Raises:
             RequestException: When the API request fails or network connectivity issues occur
             JSONDecodeError: When the API response contains invalid JSON data
-
+        
         Tags:
             fetch, get, reddit, flair, api, read-only
         """
@@ -156,8 +156,8 @@ class RedditApp(APIApplication):
         flair_id: str = None,
     ):
         """
-        Creates a new Reddit post in a specified subreddit with support for text posts, link posts, and image posts
-
+        Creates a new Reddit post in a specified subreddit. It supports text ('self') or link posts, requiring a title and corresponding content (text or URL). An optional flair can be assigned. Returns the API response or a formatted error message on failure.
+        
         Args:
             subreddit: The name of the subreddit (e.g., 'python', 'worldnews') without the 'r/'
             title: The title of the post
@@ -165,13 +165,13 @@ class RedditApp(APIApplication):
             text: The text content of the post; required if kind is 'self'
             url: The URL of the link or image; required if kind is 'link'. Must end with valid image extension for image posts
             flair_id: The ID of the flair to assign to the post
-
+        
         Returns:
             The JSON response from the Reddit API, or an error message as a string if the API returns an error
-
+        
         Raises:
             ValueError: Raised when kind is invalid or when required parameters (text for self posts, url for link posts) are missing
-
+        
         Tags:
             create, post, social-media, reddit, api, important
         """
@@ -209,18 +209,18 @@ class RedditApp(APIApplication):
 
     def get_comment_by_id(self, comment_id: str) -> dict:
         """
-        Retrieves a specific Reddit comment using its unique identifier.
-
+        Retrieves a single Reddit comment's data, such as author and score, using its unique 't1_' prefixed ID. Unlike `get_post_comments_details` which fetches all comments for a post, this function targets one specific comment directly, returning an error dictionary if it is not found.
+        
         Args:
             comment_id: The full unique identifier of the comment (prefixed with 't1_', e.g., 't1_abcdef')
-
+        
         Returns:
             A dictionary containing the comment data including attributes like author, body, score, etc. If the comment is not found, returns a dictionary with an error message.
-
+        
         Raises:
             HTTPError: When the Reddit API request fails due to network issues or invalid authentication
             JSONDecodeError: When the API response cannot be parsed as valid JSON
-
+        
         Tags:
             retrieve, get, reddit, comment, api, fetch, single-item, important
         """
@@ -235,19 +235,19 @@ class RedditApp(APIApplication):
 
     def post_comment(self, parent_id: str, text: str) -> dict:
         """
-        Posts a comment to a Reddit post or comment using the Reddit API
-
+        Posts a new comment as a reply to a specified Reddit post or another comment. Using the parent's full ID and the desired text, it submits the comment via the API and returns the response containing the new comment's details.
+        
         Args:
             parent_id: The full ID of the parent comment or post (e.g., 't3_abc123' for a post, 't1_def456' for a comment)
             text: The text content of the comment to be posted
-
+        
         Returns:
             A dictionary containing the Reddit API response with details about the posted comment
-
+        
         Raises:
             RequestException: If the API request fails or returns an error status code
             JSONDecodeError: If the API response cannot be parsed as JSON
-
+        
         Tags:
             post, comment, social, reddit, api, important
         """
@@ -262,19 +262,19 @@ class RedditApp(APIApplication):
 
     def edit_content(self, content_id: str, text: str) -> dict:
         """
-        Edits the text content of an existing Reddit post or comment using the Reddit API
-
+        Modifies the text of a specific Reddit post or comment via its unique ID. Unlike creation or deletion functions, this method specifically handles updates to existing user-generated content, submitting the new text to the API and returning a JSON response detailing the edited item.
+        
         Args:
             content_id: The full ID of the content to edit (e.g., 't3_abc123' for a post, 't1_def456' for a comment)
             text: The new text content to replace the existing content
-
+        
         Returns:
             A dictionary containing the API response with details about the edited content
-
+        
         Raises:
             RequestException: When the API request fails or network connectivity issues occur
             ValueError: When invalid content_id format or empty text is provided
-
+        
         Tags:
             edit, update, content, reddit, api, important
         """
@@ -289,18 +289,18 @@ class RedditApp(APIApplication):
 
     def delete_content(self, content_id: str) -> dict:
         """
-        Deletes a specified Reddit post or comment using the Reddit API.
-
+        Deletes a specified Reddit post or comment using its full identifier (`content_id`). It sends a POST request to the `/api/del` endpoint for permanent removal, unlike `edit_content` which only modifies. On success, it returns a confirmation message.
+        
         Args:
             content_id: The full ID of the content to delete (e.g., 't3_abc123' for a post, 't1_def456' for a comment)
-
+        
         Returns:
             A dictionary containing a success message with the deleted content ID
-
+        
         Raises:
             HTTPError: When the API request fails or returns an error status code
             RequestException: When there are network connectivity issues or API communication problems
-
+        
         Tags:
             delete, content-management, api, reddit, important
         """
@@ -315,10 +315,11 @@ class RedditApp(APIApplication):
 
     def get_current_user_info(self) -> Any:
         """
-        Get the current user's information.
+        Retrieves the full profile information for the currently authenticated user by making a GET request to the `/api/v1/me` Reddit API endpoint. This differs from `get_user_profile`, which requires a username, and `get_current_user_karma`, which specifically fetches karma data.
+        
         Returns:
             Any: API response data.
-
+        
         Tags:
             users
         """
@@ -330,11 +331,11 @@ class RedditApp(APIApplication):
 
     def get_current_user_karma(self) -> Any:
         """
-        Get the current user's karma.
-
+        Fetches the karma breakdown for the authenticated user from the Reddit API. This function specifically targets the `/api/v1/me/karma` endpoint, returning karma statistics per subreddit, which is more specific than `get_current_user_info` that retrieves general profile information.
+        
         Returns:
             Any: API response data.
-
+        
         Tags:
             account
         """
@@ -346,14 +347,14 @@ class RedditApp(APIApplication):
 
     def get_post_comments_details(self, post_id: str) -> Any:
         """
-        Get post details and comments like title, author, score, etc.
-
+        Fetches a specific Reddit post's details and its complete comment tree using the post's unique ID. This function returns the entire discussion, including the original post and all associated comments, providing broader context than `get_comment_by_id` which only retrieves a single comment.
+        
         Args:
             post_id (string): The Reddit post ID ( e.g. '1m734tx' for https://www.reddit.com/r/mcp/comments/1m734tx/comment/n4occ77/)
-
+        
         Returns:
             Any: API response data containing post details and comments.
-
+        
         Tags:
             listings, comments, posts, important
         """
@@ -373,8 +374,8 @@ class RedditApp(APIApplication):
         sr_detail: str = None,
     ) -> Any:
         """
-        Retrieves a list of the most controversial posts across Reddit.
-
+        Fetches a global list of the most controversial posts from across all of Reddit, distinct from subreddit-specific queries. Optional parameters allow for pagination and customization of the results, returning the direct API response data with the post listings.
+        
         Args:
             after: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results after.
             before: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results before.
@@ -382,10 +383,10 @@ class RedditApp(APIApplication):
             limit: Optional. The maximum number of items desired (default: 25, maximum: 100).
             show: Optional. The string "all" to show all posts.
             sr_detail: Optional. Expand subreddit details.
-
+        
         Returns:
             Any: API response data containing a list of controversial posts.
-
+        
         Tags:
             listings, posts, controversial, read-only
         """
@@ -417,8 +418,8 @@ class RedditApp(APIApplication):
         sr_detail: str = None,
     ) -> Any:
         """
-        Retrieves a list of the hottest posts across Reddit.
-
+        Retrieves trending 'hot' posts from the global Reddit feed. Unlike `get_subreddit_hot_posts`, this operates across all of Reddit, not a specific subreddit. It supports pagination and optional filtering by geographical region to customize the listing of returned posts.
+        
         Args:
             g: Optional. A geographical region to filter posts by (e.g., 'GLOBAL', 'US', 'GB').
             after: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results after.
@@ -427,10 +428,10 @@ class RedditApp(APIApplication):
             limit: Optional. The maximum number of items desired (default: 25, maximum: 100).
             show: Optional. The string "all" to show all posts.
             sr_detail: Optional. Expand subreddit details.
-
+        
         Returns:
             Any: API response data containing a list of hot posts.
-
+        
         Tags:
             listings, posts, hot, read-only
         """
@@ -462,8 +463,8 @@ class RedditApp(APIApplication):
         sr_detail: str = None,
     ) -> Any:
         """
-        Retrieves a list of the newest posts across Reddit.
-
+        Fetches a list of the newest posts from across all of Reddit, not limited to a specific subreddit. This function supports optional pagination and filtering parameters to customize the API response, differentiating it from `get_subreddit_new_posts` which targets a single subreddit.
+        
         Args:
             after: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results after.
             before: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results before.
@@ -471,10 +472,10 @@ class RedditApp(APIApplication):
             limit: Optional. The maximum number of items desired (default: 25, maximum: 100).
             show: Optional. The string "all" to show all posts.
             sr_detail: Optional. Expand subreddit details.
-
+        
         Returns:
             Any: API response data containing a list of new posts.
-
+        
         Tags:
             listings, posts, new, read-only
         """
@@ -507,8 +508,8 @@ class RedditApp(APIApplication):
         sr_detail: str = None,
     ) -> Any:
         """
-        Retrieves a list of the hottest posts in a specified subreddit.
-
+        Retrieves a list of 'hot' posts from a specified subreddit, supporting pagination and geographical filtering. Unlike `get_hot_posts`, which queries all of Reddit, this function targets a single subreddit to fetch its currently trending content, distinct from top or new posts.
+        
         Args:
             subreddit: The name of the subreddit (e.g., 'python', 'worldnews') without the 'r/' prefix.
             g: Optional. A geographical region to filter posts by (e.g., 'GLOBAL', 'US', 'GB').
@@ -518,10 +519,10 @@ class RedditApp(APIApplication):
             limit: Optional. The maximum number of items desired (default: 25, maximum: 100).
             show: Optional. The string "all" to show all posts.
             sr_detail: Optional. Expand subreddit details.
-
+        
         Returns:
             Any: API response data containing a list of hot posts from the subreddit.
-
+        
         Tags:
             listings, posts, subreddit, hot, read-only
         """
@@ -556,8 +557,8 @@ class RedditApp(APIApplication):
         sr_detail: str = None,
     ) -> Any:
         """
-        Retrieves a list of the newest posts in a specified subreddit.
-
+        Retrieves a list of the newest posts from a specified subreddit, sorted chronologically. Unlike `get_new_posts` which targets all of Reddit, this function is subreddit-specific and supports standard pagination parameters like `limit` and `after` to navigate through the listing of recent submissions.
+        
         Args:
             subreddit: The name of the subreddit (e.g., 'python', 'worldnews') without the 'r/' prefix.
             after: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results after.
@@ -566,10 +567,10 @@ class RedditApp(APIApplication):
             limit: Optional. The maximum number of items desired (default: 25, maximum: 100).
             show: Optional. The string "all" to show all posts.
             sr_detail: Optional. Expand subreddit details.
-
+        
         Returns:
             Any: API response data containing a list of new posts from the subreddit.
-
+        
         Tags:
             listings, posts, subreddit, new, read-only
         """
@@ -603,8 +604,8 @@ class RedditApp(APIApplication):
         sr_detail: str = None,
     ) -> Any:
         """
-        Retrieves a list of the top posts in a specified subreddit.
-
+        Fetches top-rated posts from a specific subreddit using standard API pagination parameters. Unlike the simpler `get_subreddit_posts` which filters by timeframe, this function offers more direct control over retrieving listings, distinguishing it from the site-wide `get_top_posts` which queries all of Reddit.
+        
         Args:
             subreddit: The name of the subreddit (e.g., 'python', 'worldnews') without the 'r/' prefix.
             after: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results after.
@@ -613,10 +614,10 @@ class RedditApp(APIApplication):
             limit: Optional. The maximum number of items desired (default: 25, maximum: 100).
             show: Optional. The string "all" to show all posts.
             sr_detail: Optional. Expand subreddit details.
-
+        
         Returns:
             Any: API response data containing a list of top posts from the subreddit.
-
+        
         Tags:
             listings, posts, subreddit, top, read-only
         """
@@ -649,8 +650,8 @@ class RedditApp(APIApplication):
         sr_detail: str = None,
     ) -> Any:
         """
-        Retrieves a list of the rising posts across Reddit.
-
+        Retrieves a list of rising posts from across all of Reddit. Unlike subreddit-specific listing functions (e.g., `get_subreddit_hot_posts`), this operates globally. It supports optional pagination and filtering parameters, such as `limit` and `after`, to customize the API response and navigate through results.
+        
         Args:
             after: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results after.
             before: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results before.
@@ -658,10 +659,10 @@ class RedditApp(APIApplication):
             limit: Optional. The maximum number of items desired (default: 25, maximum: 100).
             show: Optional. The string "all" to show all posts.
             sr_detail: Optional. Expand subreddit details.
-
+        
         Returns:
             Any: API response data containing a list of rising posts.
-
+        
         Tags:
             listings, posts, rising, read-only
         """
@@ -692,8 +693,8 @@ class RedditApp(APIApplication):
         sr_detail: str = None,
     ) -> Any:
         """
-        Retrieves a list of the top posts across Reddit.
-
+        Fetches top-rated posts from across all of Reddit, distinct from `get_subreddit_top_posts`, which operates on a specific subreddit. The function supports standard API pagination parameters like `limit`, `after`, and `before` to navigate results, providing a broad, site-wide view of top content.
+        
         Args:
             after: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results after.
             before: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results before.
@@ -701,10 +702,10 @@ class RedditApp(APIApplication):
             limit: Optional. The maximum number of items desired (default: 25, maximum: 100).
             show: Optional. The string "all" to show all posts.
             sr_detail: Optional. Expand subreddit details.
-
+        
         Returns:
             Any: API response data containing a list of top posts.
-
+        
         Tags:
             listings, posts, top, read-only
         """
@@ -742,8 +743,8 @@ class RedditApp(APIApplication):
         type: str = None,
     ) -> Any:
         """
-        Searches for posts, comments, and users across Reddit.
-
+        Executes a broad, keyword-based search across Reddit for various content types like posts, comments, or users. This general-purpose function offers extensive filtering options, distinguishing it from the more specialized `search_subreddits` which only finds communities.
+        
         Args:
             after: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results after.
             before: Optional. The fullname of a thing (e.g., 't3_xxxxxx') to return results before.
@@ -758,10 +759,10 @@ class RedditApp(APIApplication):
             sr_detail: Optional. Expand subreddit details.
             t: Optional. One of ('hour', 'day', 'week', 'month', 'year', 'all') to filter by time.
             type: Optional. A comma-separated list of result types ('sr', 'link', 'user').
-
+        
         Returns:
             Any: API response data containing search results.
-
+        
         Tags:
             search, reddit, posts, comments, users, read-only
         """
@@ -791,14 +792,14 @@ class RedditApp(APIApplication):
 
     def get_user_profile(self, username: str) -> Any:
         """
-        Retrieves the profile information for a given Reddit user.
-
+        Retrieves public profile information for a specified Reddit user via the `/user/{username}/about` endpoint. Unlike `get_current_user_info`, which targets the authenticated user, this function fetches data like karma and account age for any user identified by their username.
+        
         Args:
             username: The username of the user to look up.
-
+        
         Returns:
             A dictionary containing the user's profile data.
-
+        
         Tags:
             users, profile, fetch
         """

universal_mcp/applications/replicate/README.md

@@ -1,18 +1,18 @@
-# Replicate MCP Server
+# ReplicateApp MCP Server
 
-An MCP Server for the Replicate API.
+An MCP Server for the ReplicateApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Replicate API.
+This is automatically generated from OpenAPI schema for the ReplicateApp API.
 
 
 | Tool | Description |
 |------|-------------|
-| `chat_deepseek_ai_deepseek_r1` | Generates predictions for AI-powered conversations and tasks using the DeepSeek AI model, enabling applications such as chatbot interactions and text completion, by sending HTTP POST requests to the specified endpoint. |
-| `chat_deepseek_ai_deepseek_r11` | Retrieves the details of a specific prediction identified by {prediction_id}. |
-| `meta_meta_llama31405b_instruct` | Generates predictions using Meta's multilingual instruction-tuned Llama 3.1 405B model for dialogue and returns the result. |
-| `meta_meta_llama370b_instruct` | Submits a prediction request to the Meta Llama 3 70B Instruct model and returns the generated result. |
-| `meta_meta_llama38b_instruct` | Initiates a prediction using the Meta-Llama-3-8B-Instruct model and returns the generated text or code output. |
-| `mistralai_mistral7b_v01` | Generates predictions using the Mistral-7B model and returns the output. |
-| `black_forest_labs_flux_schnell` | Generates high-quality images from text descriptions using a 12 billion parameter rectified flow transformer model. |
+| `run` | Executes a Replicate model synchronously, blocking until it completes and returns the final output. This abstracts the polling logic required by asynchronous jobs. If a model streams results, this function conveniently collects all items into a list before returning, unlike the non-blocking `submit_prediction` method. |
+| `submit_prediction` | Submits a model execution request to Replicate for non-blocking, asynchronous processing. It immediately returns a prediction ID for tracking, unlike the synchronous `run` method which waits for the final result. The returned ID can be used with `get_prediction` or `fetch_prediction_output` to monitor the job. |
+| `get_prediction` | Retrieves the full details and current state of a Replicate prediction by its ID. This function performs a non-blocking status check, returning the prediction object immediately. Unlike `fetch_prediction_output`, it does not wait for the job to complete and is used for monitoring progress. |
+| `await_prediction_result` | Retrieves the final output for a given prediction ID, waiting for the job to complete if it is still running. This function complements `submit_prediction` by blocking until the asynchronous task finishes, raising an error if the prediction fails or is canceled. |
+| `cancel_prediction` | Sends a request to cancel a running or queued Replicate prediction. It first checks the prediction's status, only proceeding if it is not already in a terminal state (e.g., succeeded, failed), and gracefully handles jobs that cannot be canceled. |
+| `upload_file` | Uploads a local file from a given path to Replicate's storage, returning a public URL. This URL is essential for providing file-based inputs to Replicate models via functions like `run` or `submit_prediction`. Fails if the file is not found or the upload encounters an error. |
+| `generate_image` | Generates images synchronously using a specified model, defaulting to SDXL. As a convenience wrapper around the generic `run` function, it simplifies image creation by exposing common parameters like `prompt` and `width`, and waits for the model to complete before returning the resulting image URLs. |

universal_mcp/applications/resend/README.md

@@ -9,32 +9,32 @@ This is automatically generated from OpenAPI schema for the ResendApp API.
 
 | Tool | Description |
 |------|-------------|
-| `send_email` | Sends an email to specified recipients using the Resend API. |
-| `send_batch_emails` | Sends a batch of emails using the Resend API. |
-| `get_email` | Retrieves a single email by its specified ID. |
-| `update_scheduled_email` | Updates the scheduling of an email to a new time. |
-| `cancel_scheduled_email` | Cancels a scheduled email using the provided email ID. |
-| `create_domain` | Creates a new domain with the specified name. |
-| `get_domain` | Retrieves a single domain by its ID. |
-| `verify_domain` | Verifies an existing domain using the provided domain ID. |
-| `update_domain` | Updates an existing domain's settings regarding open tracking, click tracking, and TLS enforcement. |
-| `list_domains` | Retrieves a list of all domains for the authenticated user. |
-| `remove_domain` | Removes an existing domain by its ID using the Resend API. |
-| `create_api_key` | Creates a new API key for authenticating with Resend. |
-| `list_api_keys` | Retrieves a list of all API keys available through the resend service. |
-| `remove_api_key` | Removes an existing API key using the specified key ID. |
-| `create_broadcast` | Creates a new broadcast to send to a specified audience. |
-| `get_broadcast` | Retrieves a single broadcast by its ID. |
-| `update_broadcast` | Updates a broadcast by modifying its HTML content and/or subject line. |
-| `send_broadcast` | Starts sending a broadcast via the API. |
-| `remove_broadcast` | Removes an existing broadcast with 'draft' status. |
-| `list_broadcasts` | Retrieves a list of all available broadcasts using the configured API key. |
-| `create_audience` | Creates a new audience (a list of contacts) with the specified name. |
-| `get_audience` | Retrieves a single audience object from the API using the specified audience ID. |
-| `remove_audience` | Removes an existing audience using the provided audience ID and returns the API response. |
-| `list_audiences` | Retrieves a list of all audiences. |
-| `create_contact` | Creates a contact within a specific audience. |
-| `get_contact` | Retrieves a single contact from an audience by providing either a unique contact ID or an email address, ensuring exactly one identifier is given. |
-| `update_contact` | Updates an existing contact, identified by ID or email, within a specified audience. |
-| `remove_contact` | Removes a contact from an audience, identified by ID or email. |
-| `list_contacts` | Lists all contacts from a specified audience. |
+| `send_email` | Sends a single email with a specified subject and text body to a list of recipients via the Resend API. Unlike `send_batch_emails`, which processes multiple distinct emails at once, this function is designed for dispatching one individual email composition per API call. |
+| `send_batch_emails` | Sends multiple emails (1-100) in a single API request. Unlike the `send_email` function which handles a single message, this accepts a list of email objects for efficient, high-volume delivery. It validates that the batch size is within the allowed limits before making the API call. |
+| `retrieve_email_by_id` | Retrieves the details and status of a single email from the Resend API using its unique identifier. This function allows for looking up a specific email that has already been sent or scheduled, distinct from functions that initiate sending. |
+| `reschedule_email` | Modifies the delivery time for a specific, previously scheduled email using its ID. It updates the `scheduled_at` attribute to a new ISO 8601 formatted time, effectively rescheduling its dispatch. This differs from `cancel_scheduled_email`, which permanently stops the send. |
+| `cancel_scheduled_email` | Cancels a previously scheduled email using its unique ID, preventing it from being sent. This function calls the Resend API's cancellation endpoint, returning a confirmation response. It is distinct from `update_scheduled_email`, which reschedules the email instead of stopping its transmission. |
+| `create_domain` | Registers a new sending domain with the Resend service using the provided name. This is a prerequisite for sending emails from your own domain and returns a dictionary containing details of the new domain object, which can then be verified and managed with other domain-related functions. |
+| `get_domain` | Retrieves the details of a specific domain from the Resend API using its unique ID. Unlike `list_domains`, which fetches all domains, this function targets a single record and returns a dictionary containing the domain's properties, like its verification status and tracking settings. |
+| `verify_domain` | Triggers the verification process for a registered domain using its unique ID. This action is crucial for authorizing the domain to send emails via Resend and returns an API response containing the verification status and necessary DNS records to complete the process. |
+| `update_domain_settings` | Updates settings for a specific domain identified by its ID. This function can modify configurations like open and click tracking, and TLS enforcement. It returns the updated domain object from the API, raising a ToolError if the update fails. Only the provided settings are modified. |
+| `list_domains` | Fetches a complete list of all domains registered with the Resend account. Unlike `get_domain`, which retrieves a single domain by ID, this provides a comprehensive overview of all configured domains for management and verification tasks. |
+| `remove_domain` | Permanently removes a specific domain from the Resend account using its unique ID. This function makes an authenticated API call to delete the domain, distinguishing it from retrieval (`get_domain`) or modification (`update_domain`) operations, and raises an error if the process fails. |
+| `create_api_key` | Creates a new API key for authenticating with the Resend service, identified by a specified name. It returns a dictionary containing the new key object, including the generated token required for subsequent API requests. |
+| `list_api_keys` | Retrieves a list of all API keys for the authenticated Resend account. This read-only operation allows for auditing and viewing existing credentials, contrasting with `create_api_key` and `remove_api_key` which are used to add or delete keys. |
+| `remove_api_key` | Deletes a specific Resend API key identified by its unique ID. This function, part of the key management suite alongside `create_api_key` and `list_api_keys`, returns an API confirmation response or raises a `ToolError` if the operation fails. |
+| `register_broadcast` | Registers a new email broadcast campaign for a specific audience using the Resend API. This function creates the broadcast object but does not send it; use the `send_broadcast` function to dispatch the created campaign to the audience. |
+| `get_broadcast` | Retrieves a specific broadcast's complete details, including its status and content, by its unique ID. Unlike `list_broadcasts` which retrieves all broadcasts, this function targets a single entry for inspection. |
+| `update_broadcast` | Updates the HTML content and/or subject of an existing broadcast, identified by its ID. Requires that at least one modifiable field (html or subject) is provided. This function alters a broadcast's content, differing from `send_broadcast` which triggers its delivery. |
+| `send_or_schedule_broadcast` | Initiates the delivery of a pre-existing broadcast, identified by its ID, to its target audience. The broadcast can be sent immediately or scheduled for a future time via the optional `scheduled_at` parameter. It returns the API response upon execution. |
+| `remove_draft_broadcast` | Deletes a broadcast from the Resend service using its unique ID. This action is restricted to broadcasts that have a 'draft' status and have not been sent, returning the API's response upon successful removal or raising an error if the operation fails. |
+| `list_broadcasts` | Retrieves a list of all broadcasts associated with the authenticated account. Unlike `get_broadcast` which fetches a single item by ID, this function returns a list of dictionaries, each containing the attributes of a specific broadcast. Raises a `ToolError` on API failure. |
+| `create_audience` | Creates a new audience, a named list for contacts, within the Resend service. This function requires a name for the audience and returns a dictionary representing the newly created object, enabling subsequent management of contacts within that specific list. |
+| `get_audience` | Retrieves the details of a single audience using its unique ID. This provides a targeted lookup for one audience, distinct from `list_audiences` which fetches all available audiences in the account. |
+| `remove_audience` | Deletes a specific audience from the Resend service using its unique identifier. This function wraps the Resend API's remove operation, returning the API's response. Unlike `remove_contact`, which targets individuals, this function removes the entire contact list defined by the audience ID. |
+| `list_audiences` | Retrieves a complete list of all audiences from the Resend account. It returns a list of dictionaries, with each containing the details of a specific audience. This function is distinct from `get_audience`, which fetches a single audience by its ID. |
+| `create_contact` | Creates a new contact with a given email, optional name, and subscription status, adding it to a specific audience. This function populates audience lists, differing from `update_contact` which modifies existing entries, and requires a valid `audience_id` to function. |
+| `get_contact` | Fetches a single contact's details from a specified audience by its unique ID or email address. The function requires exactly one identifier for the lookup, raising an error if the identifier is missing, ambiguous, or if the API call fails. |
+| `update_contact` | Updates an existing contact's details (e.g., name, subscription status) within a specific audience. The contact is identified by its unique ID or email address. This function validates inputs and returns the Resend API response, raising a ToolError on failure or if arguments are invalid. |
+| `remove_contact` | Removes a contact from a specified audience. The contact must be identified by either its unique ID or email address, but not both. Raises an error if the identifier is missing, ambiguous, or if the API call to the Resend service fails. |
+| `list_contacts` | Retrieves a complete list of contacts belonging to a specific audience, identified by its unique ID. This function returns all contacts within the audience, unlike `get_contact` which retrieves only a single contact by its ID or email. |

universal_mcp/applications/scraper/README.md

@@ -9,7 +9,7 @@ This is automatically generated from OpenAPI schema for the ScraperApp API.
 
 | Tool | Description |
 |------|-------------|
-| `linkedin_post_search` | Performs a LinkedIn search for posts. |
-| `linkedin_list_all_posts` | Lists all LinkedIn posts for a given user  identifier |
-| `linkedin_retrieve_profile` | Retrieves a specific LinkedIn user profile by its identifier. |
-| `linkedin_list_post_comments` | Lists all comments from a specific LinkedIn post. Can also list replies to a specific comment. |
+| `linkedin_post_search` | Performs a general LinkedIn search for posts using keywords and filters like date and content type. It supports pagination and can utilize either the 'classic' or 'sales_navigator' API, searching broadly across the platform rather than fetching posts from a specific user's profile. |
+| `linkedin_list_profile_posts` | Fetches a paginated list of all LinkedIn posts from a specific user or company profile using their unique identifier. This function retrieves content directly from a profile, unlike `linkedin_post_search` which finds posts across LinkedIn based on keywords and other filters. |
+| `linkedin_retrieve_profile` | Retrieves a specific LinkedIn user's profile by their unique identifier, which can be an internal provider ID or a public username. This function simplifies data access by delegating the actual profile retrieval request to the integrated Unipile application, distinct from functions that list posts or comments. |
+| `linkedin_list_post_comments` | Fetches comments for a specified LinkedIn post. If a `comment_id` is provided, it retrieves replies to that comment instead of top-level comments. This function supports pagination and specifically targets comments, unlike others in the class that search for or list entire posts. |