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

universal_mcp/applications/google_mail/app.py

@@ -4,7 +4,6 @@ from email.message import EmailMessage
 from typing import Any
 
 from loguru import logger
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -24,23 +23,23 @@ class GoogleMailApp(APIApplication):
         thread_id: str | None = None,
     ) -> dict[str, Any]:
         """
-        Composes and immediately sends an email message via the Gmail API. It can function as a reply within an existing conversation if a `thread_id` is provided. This action is distinct from `send_draft`, which sends a previously saved draft message.
-        
+        Composes and immediately sends an email message via the Gmail API. It can function as a reply within an existing conversation if a `thread_id` is provided. This action is distinct from `send_draft`, which sends a previously saved draft message, or `create_draft`, which only saves an email.
+
         Args:
             to: The email address of the recipient
             subject: The subject line of the email
             body: The content of the email message
             body_type: The MIME subtype for the body ("plain" or "html"). Defaults to "plain".
             thread_id: Optional thread ID to make this a reply to an existing conversation
-        
+
         Returns:
             A string containing either a success confirmation message or an error description
-        
+
         Raises:
             NotAuthorizedError: When Gmail API authentication is not valid or has expired
             KeyError: When required configuration keys are missing
             Exception: For any other unexpected errors during the email sending process
-        
+
         Tags:
             send, email, api, communication, important, thread, reply, openWorldHint
         """
@@ -79,23 +78,23 @@ class GoogleMailApp(APIApplication):
         thread_id: str | None = None,
     ) -> dict[str, Any]:
         """
-        Saves a new draft email in Gmail with a specified recipient, subject, and body. An optional thread ID can be provided to create the draft as a reply within an existing conversation, distinguishing it from `send_email` which sends immediately.
-        
+        Saves a new email draft in Gmail with a specified recipient, subject, and body. An optional thread ID can create the draft as a reply within an existing conversation, distinguishing it from `send_email`, which sends immediately.
+
         Args:
             to: The email address of the recipient
             subject: The subject line of the draft email
             body: The main content/message of the draft email
             body_type: The MIME subtype for the body ("plain" or "html"). Defaults to "plain".
             thread_id: Optional thread ID to make this draft a reply to an existing conversation
-        
+
         Returns:
             A string containing either a success message with the draft ID or an error message describing the failure
-        
+
         Raises:
             NotAuthorizedError: When the user's Gmail API authorization is invalid or expired
             KeyError: When required configuration keys are missing
             Exception: For general API errors, network issues, or other unexpected problems
-        
+
         Tags:
             create, email, draft, gmail, api, important, thread, reply, html
         """
@@ -118,19 +117,19 @@ class GoogleMailApp(APIApplication):
 
     def send_draft(self, draft_id: str) -> dict[str, Any]:
         """
-        Sends a pre-existing Gmail draft identified by its unique ID. It posts to the `/drafts/send` endpoint, converting a saved draft into a sent message. This function acts on drafts created via `create_draft` and differs from `send_email`, which sends a new email in one step.
-        
+        Sends a pre-existing Gmail draft identified by its unique ID. It posts to the `/drafts/send` endpoint, converting a saved draft into a sent message. This function acts on drafts from `create_draft` and differs from `send_email`, which composes and sends an email in one step.
+
         Args:
             draft_id: The unique identifier of the Gmail draft to be sent
-        
+
         Returns:
             A string containing either a success message with the sent message ID or an error message detailing the failure reason
-        
+
         Raises:
             NotAuthorizedError: When the user's Gmail API authorization is invalid or expired
             KeyError: When required configuration keys are missing from the API response
             Exception: For other unexpected errors during the API request or response handling
-        
+
         Tags:
             send, email, api, communication, important, draft
         """
@@ -148,19 +147,19 @@ class GoogleMailApp(APIApplication):
     def get_draft(self, draft_id: str, format: str = "full") -> dict[str, Any]:
         """
         Retrieves a specific Gmail draft by its unique ID. This function allows specifying the output format (e.g., full, raw) to control the response detail. Unlike `list_drafts`, it fetches a single, known draft rather than a collection of multiple drafts.
-        
+
         Args:
             draft_id: String identifier of the draft email to retrieve
             format: Output format of the draft (options: minimal, full, raw, metadata). Defaults to 'full'
-        
+
         Returns:
             A formatted string containing the draft email details (ID, recipient, subject) or an error message if retrieval fails
-        
+
         Raises:
             NotAuthorizedError: When the user's Gmail authorization is invalid or expired
             KeyError: When required configuration keys or response data fields are missing
             Exception: For any other unexpected errors during draft retrieval
-        
+
         Tags:
             retrieve, email, gmail, draft, api, format, important
         """
@@ -183,21 +182,21 @@ class GoogleMailApp(APIApplication):
         include_spam_trash: bool = False,
     ) -> dict[str, Any]:
         """
-        Retrieves a list of email drafts from a Gmail account, supporting filtering via search query and limiting results. Can optionally include drafts from spam and trash, returning the raw API response with draft objects and metadata, distinguishing it from `get_draft` which fetches a single, specific draft.
-        
+        Fetches a list of email drafts, allowing filtering by a search query and limiting results. It can optionally include drafts from spam and trash, returning a collection of draft objects. This is distinct from `get_draft`, which retrieves only a single, specific draft by its ID.
+
         Args:
             max_results: Maximum number of drafts to return (max 500, default 20)
             q: Search query string to filter drafts using Gmail search syntax (default None)
             include_spam_trash: Boolean flag to include drafts from spam and trash folders (default False)
-        
+
         Returns:
             A formatted string containing the list of draft IDs and count information, or an error message if the request fails
-        
+
         Raises:
             NotAuthorizedError: When the Gmail API authentication is missing or invalid
             KeyError: When required configuration keys are missing
             Exception: For general errors during API communication or data processing
-        
+
         Tags:
             list, email, drafts, gmail, api, search, query, pagination, important
         """
@@ -221,14 +220,14 @@ class GoogleMailApp(APIApplication):
 
     def get_message_details(self, message_id: str) -> dict[str, Any]:
         """
-        Retrieves a specific email from Gmail by its ID. It parses the API response to extract and format key details—including sender, recipient, subject, and full body content—into a structured dictionary. This provides detailed data for other functions like `list_messages`.
-        
+        Retrieves a specific email from Gmail by its ID. It parses the API response to extract and format key details—including sender, subject, body, and attachments—into a structured dictionary. This function provides detailed data for a single message, distinguishing it from `list_messages` which fetches multiple messages.
+
         Args:
             message_id: The unique identifier of the Gmail message to retrieve
-        
+
         Returns:
             A dictionary containing the cleaned message details (serializable as JSON)
-        
+
         Tags:
             retrieve, email, format, api, gmail, message, important, body, content, attachments
         """
@@ -265,8 +264,6 @@ class GoogleMailApp(APIApplication):
             "attachments": attachments,
         }
 
-
-
     def _extract_email_body(self, payload):
         """
         Extracts the email body content from the Gmail API payload.
@@ -332,26 +329,30 @@ class GoogleMailApp(APIApplication):
             list: List of attachment dictionaries with attachment_id, filename, mime_type, and size
         """
         attachments = []
-        
+
         try:
             if payload.get("filename") and payload.get("body", {}).get("attachmentId"):
-                attachments.append({
-                    "attachment_id": payload["body"]["attachmentId"],
-                    "filename": payload["filename"],
-                    "mime_type": payload.get("mimeType", ""),
-                    "size": payload.get("body", {}).get("size", 0)
-                })
+                attachments.append(
+                    {
+                        "attachment_id": payload["body"]["attachmentId"],
+                        "filename": payload["filename"],
+                        "mime_type": payload.get("mimeType", ""),
+                        "size": payload.get("body", {}).get("size", 0),
+                    }
+                )
 
             parts = payload.get("parts", [])
             for part in parts:
                 if part.get("filename") and part.get("body", {}).get("attachmentId"):
-                    attachments.append({
-                        "attachment_id": part["body"]["attachmentId"],
-                        "filename": part["filename"],
-                        "mime_type": part.get("mimeType", ""),
-                        "size": part.get("body", {}).get("size", 0)
-                    })
-                
+                    attachments.append(
+                        {
+                            "attachment_id": part["body"]["attachmentId"],
+                            "filename": part["filename"],
+                            "mime_type": part.get("mimeType", ""),
+                            "size": part.get("body", {}).get("size", 0),
+                        }
+                    )
+
                 elif part.get("parts"):
                     nested_attachments = self._extract_attachments(part)
                     attachments.extend(nested_attachments)
@@ -387,8 +388,8 @@ class GoogleMailApp(APIApplication):
         page_token: str | None = None,
     ) -> dict[str, Any]:
         """
-        Fetches a paginated list of detailed email messages from Gmail using optional search queries. It concurrently retrieves the full content (sender, subject, body) for each message, returning the results and a token to access the next page. This differs from `get_message_details` which fetches only one.
-        
+        Fetches a paginated list of detailed email messages using optional search queries. It concurrently retrieves full content (sender, subject, body) for each message, returning the results and a pagination token. This differs from `get_message_details`, which fetches only a single message.
+
         Args:
             max_results: Maximum number of messages to return (max 500, default 20)
             q: Search query string to filter messages using Gmail search syntax.
@@ -409,15 +410,15 @@ class GoogleMailApp(APIApplication):
                     - 'has:attachment' for emails with attachments
                     - 'is:unread' for unread emails
             include_spam_trash: Boolean flag to include messages from spam and trash folders (default False)
-        
+
         Returns:
             A dictionary containing the list of messages and next page token for pagination
-        
+
         Raises:
             NotAuthorizedError: When the Gmail API authentication is invalid or missing
             KeyError: When required configuration keys are missing
             Exception: For general API errors, network issues, or other unexpected problems
-        
+
         Tags:
             list, messages, gmail, search, query, pagination, important
         """
@@ -471,19 +472,19 @@ class GoogleMailApp(APIApplication):
 
     def get_email_thread(self, thread_id: str) -> dict[str, Any]:
         """
-        Retrieves a complete email conversation from the Gmail API by its thread ID. It returns a dictionary containing all messages and metadata for the entire thread, providing the full context of the conversation.
-        
+        Fetches a complete email conversation by its unique thread ID. Unlike `get_message_details`, which retrieves a single message, this returns all messages and metadata for the entire thread, providing the full context of the conversation.
+
         Args:
             thread_id: The unique identifier of the Gmail thread to retrieve
-        
+
         Returns:
             A dictionary containing the thread details and all messages in the thread
-        
+
         Raises:
             NotAuthorizedError: When Gmail API authentication is invalid or missing
             KeyError: When required configuration keys are missing
             Exception: For general errors during API communication or data processing
-        
+
         Tags:
             retrieve, email, thread, gmail, api, conversation, important, readOnlyHint, openWorldHint
         """
@@ -494,18 +495,18 @@ class GoogleMailApp(APIApplication):
 
     def list_labels(self) -> dict[str, Any]:
         """
-        Fetches a complete list of all available labels from the user's Gmail account via the API. This includes both system-defined (e.g., INBOX) and user-created labels, returning details such as their names, IDs, and types after standard response handling.
-        
+        Fetches a complete list of all available labels from the user's Gmail account via the API. It retrieves both system-defined (e.g., INBOX) and user-created labels, returning their names and IDs, complementing management functions like `create_label` and `update_label`.
+
         Args:
             None: This method takes no arguments
-        
+
         Returns:
             A formatted string containing a list of Gmail labels categorized by type (system and user), with their IDs, or an error message if the operation fails.
-        
+
         Raises:
             NotAuthorizedError: Raised when the user's Gmail authorization is invalid or missing
             Exception: Raised when any other unexpected error occurs during the API request or data processing
-        
+
         Tags:
             list, gmail, labels, fetch, organize, important, management
         """
@@ -520,18 +521,18 @@ class GoogleMailApp(APIApplication):
 
     def create_label(self, name: str) -> dict[str, Any]:
         """
-        Creates a new Gmail label with a specified name. The function hardcodes the label's visibility settings to ensure it appears in both the label and message lists. It returns the API response, which includes the new label's details upon success or an error message on failure.
-        
+        Creates a new Gmail label with a specified name, hardcoding its visibility to ensure it appears in both label and message lists. This function complements `update_label` and `delete_label` by adding new organizational tags to the user's account via the API.
+
         Args:
             name: The display name of the label to create
-        
+
         Returns:
             A formatted string containing the creation status, including the new label's name and ID if successful, or an error message if the creation fails
-        
+
         Raises:
             NotAuthorizedError: Raised when the request lacks proper Gmail API authorization
             Exception: Raised for any other unexpected errors during label creation
-        
+
         Tags:
             create, label, gmail, management, important
         """
@@ -554,17 +555,17 @@ class GoogleMailApp(APIApplication):
     def get_profile(self) -> dict[str, Any]:
         """
         Retrieves the authenticated user's Gmail profile from the API. The profile includes the user's email address, total message and thread counts, and the mailbox's history ID, offering a high-level summary of the account's state.
-        
+
         Args:
             None: This method takes no arguments besides self
-        
+
         Returns:
             A formatted string containing the user's Gmail profile information or an error message if the request fails
-        
+
         Raises:
             NotAuthorizedError: Raised when the user's credentials are invalid or authorization is required
             Exception: Raised for any other unexpected errors during the API request or data processing
-        
+
         Tags:
             fetch, profile, gmail, user-info, api-request, important
         """
@@ -594,8 +595,8 @@ class GoogleMailApp(APIApplication):
         message=None,
     ) -> dict[str, Any]:
         """
-        Updates a specific Gmail draft by its ID, replacing its existing content and metadata. The new message body and headers are provided in a message object, allowing for complete modification of the draft before it is sent.
-        
+        Replaces the entire content of a specific Gmail draft, identified by its ID, with a new message object. This allows complete modification of the recipient, subject, and body, serving as the primary "edit" function for drafts created via `create_draft`.
+
         Args:
             userId (string): userId
             id (string): id
@@ -658,10 +659,10 @@ class GoogleMailApp(APIApplication):
                   }
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: Successful response
-        
+
         Tags:
             Drafts
         """
@@ -713,8 +714,8 @@ class GoogleMailApp(APIApplication):
         xgafv=None,
     ) -> dict[str, Any]:
         """
-        Moves a specific Gmail message to the trash folder using its unique ID. This action serves as a soft delete and is the direct counterpart to `untrash_messages`, which restores a trashed message. It requires both a user ID and message ID to execute.
-        
+        Moves a specific Gmail message to the trash folder by its unique ID. This action performs a soft delete and is the direct counterpart to `untrash_message`, which restores a message. It requires both a user ID and the specific message ID to make the API call.
+
         Args:
             userId (string): userId
             id (string): id
@@ -729,10 +730,10 @@ class GoogleMailApp(APIApplication):
             upload_protocol (string): Upload protocol for media (e.g. "raw", "multipart"). Example: '{{upload_protocol}}'.
             uploadType (string): Legacy upload protocol for media (e.g. "media", "multipart"). Example: '{{uploadType}}'.
             xgafv (string): V1 error format. Example: '{{$.xgafv}}'.
-        
+
         Returns:
             dict[str, Any]: Successful response
-        
+
         Tags:
             Messages, important
         """
@@ -779,8 +780,8 @@ class GoogleMailApp(APIApplication):
         xgafv=None,
     ) -> dict[str, Any]:
         """
-        Restores a specific Gmail message from the trash to the user's mailbox, identified by its unique ID. It serves as the direct counterpart to `trash_messsages`, undoing the deletion action and making the message visible again in the user's account via an API call.
-        
+        Restores a specific Gmail message from the trash to the user's mailbox, identified by its unique ID. It serves as the direct counterpart to `trash_message`, undoing the deletion action and making the message visible again in the user's account via an API call.
+
         Args:
             userId (string): userId
             id (string): id
@@ -795,10 +796,10 @@ class GoogleMailApp(APIApplication):
             upload_protocol (string): Upload protocol for media (e.g. "raw", "multipart"). Example: '{{upload_protocol}}'.
             uploadType (string): Legacy upload protocol for media (e.g. "media", "multipart"). Example: '{{uploadType}}'.
             xgafv (string): V1 error format. Example: '{{$.xgafv}}'.
-        
+
         Returns:
             dict[str, Any]: Successful response
-        
+
         Tags:
             Messages
         """
@@ -846,8 +847,8 @@ class GoogleMailApp(APIApplication):
         xgafv=None,
     ) -> dict[str, Any]:
         """
-        Retrieves a specific email attachment's content by its unique ID from a specified message. It requires the user, message, and attachment IDs to make a targeted API request, returning the attachment's size and base64-encoded data.
-        
+        Fetches the raw, base64-encoded content of a specific email attachment using its unique ID. It requires the parent message and user IDs for a targeted API request, returning the file's size and data for download or processing, unlike functions that only list attachment metadata.
+
         Args:
             userId (string): userId
             messageId (string): messageId
@@ -863,10 +864,10 @@ class GoogleMailApp(APIApplication):
             upload_protocol (string): Upload protocol for media (e.g. "raw", "multipart"). Example: '{{upload_protocol}}'.
             uploadType (string): Legacy upload protocol for media (e.g. "media", "multipart"). Example: '{{uploadType}}'.
             xgafv (string): V1 error format. Example: '{{$.xgafv}}'.
-        
+
         Returns:
             dict[str, Any]: Successful response
-        
+
         Tags:
             Messages
         """
@@ -924,8 +925,8 @@ class GoogleMailApp(APIApplication):
         type=None,
     ) -> dict[str, Any]:
         """
-        Updates an existing Gmail label's properties, such as its name, color, or visibility, using its unique ID. It sends a PUT request to the Gmail API and returns the full, updated label resource as a dictionary upon successful modification.
-        
+        Updates an existing Gmail label's properties, such as its name, color, or visibility, using its unique ID. This modification function is distinct from `create_label` and `delete_label`, returning the full, updated label resource from the API upon successful completion.
+
         Args:
             userId (string): userId
             id (string): id
@@ -967,10 +968,10 @@ class GoogleMailApp(APIApplication):
                   "type": "system"
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: Successful response
-        
+
         Tags:
             Labels
         """
@@ -1030,8 +1031,8 @@ class GoogleMailApp(APIApplication):
         xgafv=None,
     ) -> Any:
         """
-        Permanently removes a specific Gmail label from a user's account, identified by its unique ID. This function performs an irreversible deletion via an API call, requiring both the `userId` and the label `id`. It is the destructive counterpart to `create_label` and `update_labels`.
-        
+        Permanently removes a specific Gmail label from a user's account, identified by its unique ID. This function performs an irreversible deletion via an API call, requiring both the `userId` and the label `id`. It is the destructive counterpart to `create_label` and `update_label`.
+
         Args:
             userId (string): userId
             id (string): id
@@ -1046,10 +1047,10 @@ class GoogleMailApp(APIApplication):
             upload_protocol (string): Upload protocol for media (e.g. "raw", "multipart"). Example: '{{upload_protocol}}'.
             uploadType (string): Legacy upload protocol for media (e.g. "media", "multipart"). Example: '{{uploadType}}'.
             xgafv (string): V1 error format. Example: '{{$.xgafv}}'.
-        
+
         Returns:
             Any: No Content
-        
+
         Tags:
             Labels
         """
@@ -1096,8 +1097,8 @@ class GoogleMailApp(APIApplication):
         xgafv=None,
     ) -> dict[str, Any]:
         """
-        Fetches the configuration for a single Gmail filter using its unique ID. It returns the specific criteria (e.g., from, subject) and the automated actions (e.g., add label, archive) defined for that filter.
-        
+        Fetches a single Gmail filter's configuration by its unique ID for a specified user. It returns the filter’s criteria (e.g., sender) and actions (e.g., add label). This differs from `get_all_filters`, which retrieves a complete list of all filters for the user.
+
         Args:
             userId (string): userId
             id (string): id
@@ -1112,10 +1113,10 @@ class GoogleMailApp(APIApplication):
             upload_protocol (string): Upload protocol for media (e.g. "raw", "multipart"). Example: '{{upload_protocol}}'.
             uploadType (string): Legacy upload protocol for media (e.g. "media", "multipart"). Example: '{{uploadType}}'.
             xgafv (string): V1 error format. Example: '{{$.xgafv}}'.
-        
+
         Returns:
             dict[str, Any]: Successful response
-        
+
         Tags:
             settings, Filters
         """
@@ -1162,8 +1163,8 @@ class GoogleMailApp(APIApplication):
         xgafv=None,
     ) -> Any:
         """
-        Deletes a specific Gmail filter using its unique ID for a specified user account. This action permanently removes the filter and its associated automation rules, such as applying labels or forwarding messages, from the user's Gmail settings.
-        
+        Permanently removes a specific Gmail filter, identified by its unique ID, from a user's account. This action deletes the filter's criteria and all associated automation rules, making it the destructive counterpart to `create_filter` and `get_filter`.
+
         Args:
             userId (string): userId
             id (string): id
@@ -1178,10 +1179,10 @@ class GoogleMailApp(APIApplication):
             upload_protocol (string): Upload protocol for media (e.g. "raw", "multipart"). Example: '{{upload_protocol}}'.
             uploadType (string): Legacy upload protocol for media (e.g. "media", "multipart"). Example: '{{uploadType}}'.
             xgafv (string): V1 error format. Example: '{{$.xgafv}}'.
-        
+
         Returns:
             Any: No Content
-        
+
         Tags:
             settings, Filters
         """
@@ -1227,8 +1228,8 @@ class GoogleMailApp(APIApplication):
         xgafv=None,
     ) -> dict[str, Any]:
         """
-        Retrieves all configured email filters for a specified Gmail user ID. It fetches a list of a user's filters, including their matching criteria and automated actions, providing a comprehensive overview of their email organization rules via the Gmail API.
-        
+        Retrieves all configured email filters for a specified Gmail user ID. It fetches a list of a user's filters, including their matching criteria and automated actions, distinguishing it from `get_filter`, which retrieves only a single filter.
+
         Args:
             userId (string): userId
             access_token (string): OAuth access token. Example: '{{access_token}}'.
@@ -1242,10 +1243,10 @@ class GoogleMailApp(APIApplication):
             upload_protocol (string): Upload protocol for media (e.g. "raw", "multipart"). Example: '{{upload_protocol}}'.
             uploadType (string): Legacy upload protocol for media (e.g. "media", "multipart"). Example: '{{uploadType}}'.
             xgafv (string): V1 error format. Example: '{{$.xgafv}}'.
-        
+
         Returns:
             dict[str, Any]: Successful response
-        
+
         Tags:
             settings, Filters
         """
@@ -1292,8 +1293,8 @@ class GoogleMailApp(APIApplication):
         id=None,
     ) -> dict[str, Any]:
         """
-        Sets up a new automated email filter in Gmail. It requires defining matching criteria (like sender or subject) and an action (like adding a label) to apply to emails that meet those criteria for a specified user account.
-        
+        Creates a new automated email filter in Gmail for a specified user. It requires defining matching criteria (e.g., sender, subject) and an action (e.g., add label). This function adds new rules, distinguishing it from `get_all_filters` and `delete_filter` which manage existing ones.
+
         Args:
             userId (string): userId
             access_token (string): OAuth access token. Example: '{{access_token}}'.
@@ -1338,10 +1339,10 @@ class GoogleMailApp(APIApplication):
                   "id": "in aute anim"
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: Successful response
-        
+
         Tags:
             settings, Filters
         """

universal_mcp/applications/google_searchconsole/README.md

@@ -9,13 +9,13 @@ This is automatically generated from OpenAPI schema for the GoogleSearchconsoleA
 
 | Tool | Description |
 |------|-------------|
-| `get_sitemap` | Retrieves information about a specific sitemap. |
-| `list_sitemaps` | Lists the sitemaps-entries submitted for this site, or included in the sitemap index file  |
-| `submit_sitemap` | Submits a sitemap for a site. Typically returns HTTP 204 No Content on success. |
-| `delete_sitemap` | Deletes a sitemap from this site. Typically returns HTTP 204 No Content on success. |
-| `get_site` | Retrieves information about a specific site. |
-| `list_sites` | Lists the user's Search Console sites. |
-| `add_site` | Adds a site to the set of the user's sites in Search Console. |
-| `delete_site` | Removes a site from the set of the user's Search Console sites. |
-| `index_inspect_url` | Inspects a URL in Google Index and provides information about its status. |
-| `query_search_analytics` | Queries your search traffic data with filters and parameters that you define. |
+| `get_sitemap` | Retrieves detailed information for a single sitemap from a specified Google Search Console property. Unlike `list_sitemaps` which fetches all sitemaps, this function targets one sitemap by its URL (`feedpath`) to return its resource details, including status and last processed date. |
+| `list_sitemaps` | Retrieves a list of sitemaps for a specific site property. It can optionally list sitemaps contained within a specified sitemap index file. This function contrasts with `get_sitemap`, which fetches details for only a single, specified sitemap rather than a collection. |
+| `submit_sitemap` | Submits a sitemap to a specified Google Search Console property using its URL (feedpath). It notifies Google to crawl the sitemap's location, complementing other sitemap management functions (`list_sitemaps`, `delete_sitemap`) by adding or updating a sitemap's registration for a given site. |
+| `delete_sitemap` | Deletes a specific sitemap from a Google Search Console property using its URL (`feedpath`). This function is distinct from `delete_site`, which removes the entire site property, not just a single sitemap file. It issues an HTTP DELETE request to the specified API endpoint. |
+| `get_site` | Retrieves detailed information for a specific site property from Google Search Console using its URL. Unlike `list_sites`, which fetches all properties associated with the user's account, this function targets and returns the resource for a single, known site. |
+| `list_sites` | Retrieves all websites and domain properties the authenticated user manages in Google Search Console. While `get_site` fetches a single, specific property, this function returns a comprehensive list of all sites linked to the user's account, providing a complete overview of managed properties. |
+| `add_site` | Adds a site property to the user's Google Search Console account using its URL. This action requires subsequent ownership verification. Unlike `list_sites`, which only retrieves existing properties, this function creates a new entry and returns the corresponding site resource upon successful creation. |
+| `delete_site` | Removes a website property from the user's Google Search Console account using its URL. Unlike `delete_sitemap`, which only targets a sitemap file, this function deletes the entire site property, revoking management access and removing it from the user's list of managed sites. |
+| `inspect_url` | Retrieves the Google Index status for a specified URL within a given Search Console property. This function queries the URL Inspection API to return detailed information about how Google sees the page, including its indexing eligibility and any detected issues. |
+| `query_search_analytics` | Queries and retrieves search traffic data for a specified site within a given date range. Supports advanced filtering, grouping by various dimensions (e.g., query, page, device), and aggregation to customize the analytics report from the Google Search Console API. |