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

universal_mcp/applications/twitter/app.py

@@ -1,17 +1,17 @@
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
-from .api_segments.compliance_api import ComplianceApi
-from .api_segments.dm_conversations_api import DmConversationsApi
-from .api_segments.dm_events_api import DmEventsApi
-from .api_segments.likes_api import LikesApi
-from .api_segments.lists_api import ListsApi
-from .api_segments.openapi_json_api import OpenapiJsonApi
-from .api_segments.spaces_api import SpacesApi
-from .api_segments.trends_api import TrendsApi
-from .api_segments.tweets_api import TweetsApi
-from .api_segments.usage_api import UsageApi
-from .api_segments.users_api import UsersApi
+from universal_mcp.applications.twitter.api_segments.compliance_api import ComplianceApi
+from universal_mcp.applications.twitter.api_segments.dm_conversations_api import DmConversationsApi
+from universal_mcp.applications.twitter.api_segments.dm_events_api import DmEventsApi
+from universal_mcp.applications.twitter.api_segments.likes_api import LikesApi
+from universal_mcp.applications.twitter.api_segments.lists_api import ListsApi
+from universal_mcp.applications.twitter.api_segments.openapi_json_api import OpenapiJsonApi
+from universal_mcp.applications.twitter.api_segments.spaces_api import SpacesApi
+from universal_mcp.applications.twitter.api_segments.trends_api import TrendsApi
+from universal_mcp.applications.twitter.api_segments.tweets_api import TweetsApi
+from universal_mcp.applications.twitter.api_segments.usage_api import UsageApi
+from universal_mcp.applications.twitter.api_segments.users_api import UsersApi
 
 
 class TwitterApp(APIApplication):

universal_mcp/applications/unipile/README.md

@@ -9,20 +9,20 @@ This is automatically generated from OpenAPI schema for the UnipileApp API.
 
 | Tool | Description |
 |------|-------------|
-| `list_all_chats` | Lists all chats, with options to filter by unread status, pagination, date ranges, and account. |
-| `list_chat_messages` | Lists all messages from a specific chat, with pagination and filtering options. |
-| `send_chat_message` | Sends a message in a specific chat. |
-| `retrieve_chat` | Retrieves a specific chat by its Unipile or provider ID. |
-| `list_all_messages` | Lists all messages across all chats, with pagination and filtering options. |
-| `list_all_accounts` | Lists all linked accounts. |
-| `retrieve_account` | Retrieves a specific linked account by its ID. |
-| `list_user_posts` | Lists all posts for a given user or company identifier. |
-| `retrieve_own_profile` | Retrieves the profile of the user associated with the given Unipile account_id. |
-| `retrieve_profile` | Retrieves a specific user profile by its identifier. |
-| `retrieve_post` | Retrieves a specific post by its ID. |
-| `list_post_comments` | Lists all comments from a specific post. Can also list replies to a specific comment. |
-| `create_post` | Creates a new post on LinkedIn. |
-| `list_post_reactions` | Lists all reactions from a specific post or comment. |
-| `create_post_comment` | Adds a comment to a specific post. |
-| `add_reaction_to_post` | Adds a reaction to a post or comment. |
-| `search` | Performs a comprehensive search on LinkedIn for people, companies, posts, or jobs. |
+| `list_all_chats` | Retrieves a paginated list of all chat conversations across linked accounts. Supports filtering by unread status, date range, account provider, and specific account IDs, distinguishing it from functions listing messages within a single chat. |
+| `list_chat_messages` | Retrieves messages from a specific chat identified by `chat_id`. Supports pagination and filtering by date or sender. Unlike `list_all_messages`, which fetches from all chats, this function targets the contents of a single conversation. |
+| `send_chat_message` | Sends a text message to a specific chat conversation using its `chat_id`. This function creates a new message via a POST request, distinguishing it from read-only functions like `list_chat_messages`. It returns the API's response, which typically confirms the successful creation of the message. |
+| `retrieve_chat` | Retrieves a single chat's details using its Unipile or provider-specific ID. Requires an `account_id` when using a provider ID for context. This function is distinct from `list_all_chats`, which returns a collection, by targeting one specific conversation. |
+| `list_all_messages` | Retrieves a paginated list of messages from all chats associated with the account(s). Unlike `list_chat_messages` which targets a specific conversation, this function provides a global message view, filterable by sender, account, and date range. |
+| `list_all_accounts` | Retrieves a paginated list of all social media accounts linked to the Unipile service. This is crucial for obtaining the `account_id` required by other methods to specify which user account should perform an action, like sending a message or retrieving user-specific posts. |
+| `retrieve_linked_account` | Retrieves details for a specific account linked to Unipile using its ID. It fetches metadata about the connection itself (e.g., a linked LinkedIn account), differentiating it from `retrieve_user_profile` which fetches a user's profile from the external platform. |
+| `list_profile_posts` | Retrieves a paginated list of posts from a specific user or company profile using their provider ID. An authorizing `account_id` is required, and the `is_company` flag must specify the entity type, distinguishing this from `retrieve_post` which fetches a single post by its own ID. |
+| `retrieve_own_profile` | Retrieves the profile details for the user associated with the specified Unipile account ID. This function targets the API's 'me' endpoint to fetch the authenticated user's profile, distinct from `retrieve_user_profile` which fetches profiles of other users by their public identifier. |
+| `retrieve_user_profile` | Retrieves a specific LinkedIn user's profile using their public or internal ID, authorized via the provided `account_id`. Unlike `retrieve_own_profile`, which fetches the authenticated user's details, this function targets and returns data for any specified third-party user profile on the platform. |
+| `retrieve_post` | Fetches a specific post's details by its unique ID, requiring an `account_id` for authorization. Unlike `list_profile_posts`, which retrieves a collection of posts from a user or company profile, this function targets one specific post and returns its full object. |
+| `list_post_comments` | Fetches comments for a specific post using an `account_id` for authorization. Providing an optional `comment_id` retrieves threaded replies instead of top-level comments. This read-only operation contrasts with `create_post_comment`, which publishes new comments, and `list_content_reactions`, which retrieves 'likes'. |
+| `create_post` | Publishes a new top-level post from a specified account, including text, user mentions, and an external link. This function creates original content, distinguishing it from `create_post_comment` which adds replies to existing posts. |
+| `list_content_reactions` | Retrieves a paginated list of reactions for a given post or, optionally, a specific comment. This read-only operation uses the provided `account_id` for the request, distinguishing it from the `create_reaction` function which adds new reactions. |
+| `create_post_comment` | Publishes a comment on a specified post. By providing an optional `comment_id`, it creates a threaded reply to an existing comment instead of a new top-level one. This function's dual capability distinguishes it from `list_post_comments`, which only retrieves comments and their replies. |
+| `create_reaction` | Adds a specified reaction (e.g., 'like', 'love') to a LinkedIn post or, optionally, to a specific comment. This function performs a POST request to create the reaction, differentiating it from `list_content_reactions` which only retrieves existing ones. |
+| `search` | Performs a comprehensive LinkedIn search for people, companies, posts, or jobs using granular filters like keywords and location. Alternatively, it can execute a search from a direct LinkedIn URL. Supports pagination and targets either the classic or Sales Navigator API. |

universal_mcp/applications/whatsapp/README.md

@@ -9,15 +9,15 @@ This is automatically generated from OpenAPI schema for the WhatsappApp API.
 
 | Tool | Description |
 |------|-------------|
-| `search_contacts` | Search WhatsApp contacts by name or phone number. |
-| `list_messages` | Get WhatsApp messages matching specified criteria with optional context. |
-| `list_chats` | Get WhatsApp chats matching specified criteria. |
-| `get_chat` | Get WhatsApp chat metadata by JID. |
-| `get_direct_chat_by_contact` | Get WhatsApp chat metadata by sender phone number. |
-| `get_contact_chats` | Get all WhatsApp chats involving the contact. |
-| `get_last_interaction` | Get most recent WhatsApp message involving the contact. |
-| `get_message_context` | Get context around a specific WhatsApp message. |
-| `send_message` | Send a WhatsApp message to a person or group. For group chats use the JID. |
-| `send_file` | Send a file such as a picture, raw audio, video or document via WhatsApp to the specified recipient. For group messages use the JID. |
-| `send_audio_message` | Send any audio file as a WhatsApp audio message to the specified recipient. For group messages use the JID. If it errors due to ffmpeg not being installed, use send_file instead. |
-| `download_media` | Download media from a WhatsApp message and get the local file path. |
+| `search_contacts` | Searches for WhatsApp contacts by name or phone number. This function takes a query string, handles user authentication, and calls the underlying API to find and return a list of matching contacts. It serves as the primary method to look up contact information within the application. |
+| `search_messages` | Searches for and retrieves a paginated list of WhatsApp messages using various filters like date, sender, chat, or content query. It can optionally include surrounding contextual messages for each result, unlike `get_message_context` which targets a single message ID. |
+| `search_chats` | Retrieves a paginated list of WhatsApp chats, allowing filtering by a search query and sorting by activity or name. Unlike `get_chat`, which fetches a single known chat, this function provides broad search and discovery capabilities across multiple user conversations. |
+| `get_chat_by_jid` | Retrieves metadata for a specific WhatsApp chat (direct or group) using its unique JID. It can optionally include the most recent message. This precise JID-based lookup distinguishes it from `get_direct_chat_by_contact`, which uses a phone number, and `list_chats`, which performs a broader search. |
+| `get_direct_chat_by_phone_number` | Retrieves metadata for a direct (one-on-one) WhatsApp chat using a contact's phone number. Unlike `get_chat` which requires a JID, this provides a simpler way to find direct conversations. Returns a dictionary containing the chat's details, such as its JID and name. |
+| `list_chats_by_contact_jid` | Retrieves a paginated list of all WhatsApp chats, including direct messages and groups, that a specific contact participates in. The contact is identified by their unique JID. This differs from `get_direct_chat_by_contact` which only finds one-on-one chats. |
+| `get_last_message_by_jid` | Retrieves the content of the most recent message involving a specific contact, identified by their JID. It authenticates the user and returns the message directly as a string, offering a quick way to view the last communication without fetching full message objects or chat histories. |
+| `get_message_context` | Fetches the conversational context surrounding a specific WhatsApp message ID. It retrieves a configurable number of messages immediately preceding and following the target message. This provides a focused view of a dialogue, unlike `list_messages` which performs broader, filter-based searches. |
+| `send_text_message` | Authenticates the user and sends a text message to a specified WhatsApp recipient. The recipient can be an individual (via phone number) or a group (via JID). It returns a dictionary indicating the operation's success status and a corresponding message. |
+| `send_attachment` | Sends a media file (image, video, document, raw audio) as a standard attachment to a WhatsApp contact or group using their phone number or JID. Unlike `send_audio_message`, which creates a playable voice note, this function handles general file transfers. Returns a success status dictionary. |
+| `send_voice_message` | Sends a local audio file as a playable WhatsApp voice message, converting it to the required format. Unlike `send_file` which sends audio as a document attachment, this function formats the audio as a voice note. It can be sent to an individual contact or a group chat. |
+| `download_media_from_message` | Downloads media from a specific WhatsApp message, identified by its ID and chat JID. It saves the content to a local file and returns the file's path upon success. The function automatically handles user authentication before initiating the download. |

universal_mcp/applications/whatsapp/app.py

@@ -1,43 +1,43 @@
 from typing import Any
 
 import requests
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     WHATSAPP_API_BASE_URL,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     download_media as whatsapp_download_media,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     get_chat as whatsapp_get_chat,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     get_contact_chats as whatsapp_get_contact_chats,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     get_direct_chat_by_contact as whatsapp_get_direct_chat_by_contact,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     get_last_interaction as whatsapp_get_last_interaction,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     get_message_context as whatsapp_get_message_context,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     list_chats as whatsapp_list_chats,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     list_messages as whatsapp_list_messages,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     search_contacts as whatsapp_search_contacts,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     send_audio_message as whatsapp_audio_voice_message,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     send_file as whatsapp_send_file,
 )
-from .whatsapp import (
+from universal_mcp.applications.whatsapp.whatsapp import (
     send_message as whatsapp_send_message,
 )
 

universal_mcp/applications/whatsapp_business/README.md

@@ -9,26 +9,26 @@ This is automatically generated from OpenAPI schema for the WhatsappBusinessApp
 
 | Tool | Description |
 |------|-------------|
-| `get_analytics` | Retrieves details of a specified WhatsApp Business Account (WABA) with customizable fields using the GET method. |
-| `get_credit_lines` | Retrieves the extended credit lines available for a specified business account using its ID. |
-| `get_business_account` | Retrieves information about a business account using the specified API version and business account ID, optionally filtering the response fields via a query parameter. |
-| `get_commerce_settings` | Retrieves the commerce settings configured for a specific WhatsApp Business phone number. |
-| `set_or_update_commerce_settings` | Updates WhatsApp Business commerce settings (cart availability and catalog visibility) for a specific business phone number. |
-| `upload_file` | Uploads a file using the specified API version and application ID, with optional query parameters for file length and type, and returns a successful status message upon completion. |
-| `resume_session` | Initiates a session using the provided SESSION_ID and file offset specified in the header, supporting further session-related operations via the POST method at the "/{api-version}/<SESSION_ID>" endpoint. |
-| `get_business_phone_number` | Retrieves details for a specific business phone number ID using query parameters to specify returned fields. |
-| `get_all_business_phone_numbers` | Retrieves a list of phone numbers associated with a specific WhatsApp Business Account (WABA), allowing for filtering and customization of the response fields. |
-| `get_qr_code` | Retrieves a message linked to a specific QR code for a business phone number using the GET method via the API. |
-| `delete_qr_code` | Deletes a specific WhatsApp Business QR code using the provided QR code ID and returns a success message if the operation is completed successfully. |
-| `get_all_qr_codes_default_fields` | Retrieves a list of message QR code deep links associated with a business phone number, filtered by specified fields and QR code identifiers. |
-| `create_qr_code` | Creates a WhatsApp Business QR code with a predefined message and returns the generated code details. |
-| `get_template_by_id_default_fields` | Retrieves a template using the specified template ID from the API version path. |
-| `edit_template` | Creates or processes a resource using the specified template ID based on the API version and returns a successful status upon completion. |
-| `get_template_by_name_default_fields` | Retrieves a list of WhatsApp message templates associated with a specific WhatsApp Business Account using the "GET" method, allowing filtering by template name. |
-| `create_message_template` | Creates a new WhatsApp message template for a business account, allowing businesses to send standardized messages to customers. |
-| `delete_template_by_name` | Deletes WhatsApp message templates by name (all languages) or specific ID using query parameters and returns a success status. |
-| `get_subscribed_apps` | Retrieves a list of apps subscribed to webhooks for a WhatsApp Business Account using the GET method. |
-| `subscribe_app_to_waba_swebhooks` | Subscribes an app to webhooks for a WhatsApp Business Account (WABA) using the POST method at the `/subscribed_apps` endpoint, allowing the app to receive updates and notifications from the WABA. |
-| `unsubscribe_apps_by_waba_id` | Unsubscribes an app from webhook notifications for a WhatsApp Business Account. |
-| `get_all_shared_wabas` | Retrieves information about WhatsApp Business accounts associated with a business client, using the specified business account ID and API version. |
-| `get_all_owned_wabas` | Retrieves a list of WhatsApp Business Accounts owned by or shared with the specified business account using a GET request to the given endpoint. |
+| `get_whatsapp_business_account` | Fetches customizable data, primarily analytics, for a specific WhatsApp Business Account (WABA) using its ID. The `fields` parameter allows detailed queries, including date ranges and granularity for metrics like message volume, to refine the returned data. |
+| `get_business_account_credit_lines` | Retrieves the extended credit lines for a specified business account ID. This function fetches billing information by querying the `/extendedcredits` endpoint, returning financial details such as available credit for platform services. |
+| `get_business_account` | Fetches details for a specific Meta Business Account using its ID. This function retrieves the core account object, unlike others that get associated resources like owned/shared WhatsApp Business Accounts (WABAs) or credit lines for the same ID. The response payload can be customized using the 'fields' parameter. |
+| `get_commerce_settings` | Retrieves the commerce settings, such as cart availability and catalog visibility, for a specific WhatsApp Business phone number. This function reads the current configuration, contrasting with `set_or_update_commerce_settings` which modifies them. |
+| `update_commerce_settings` | Updates the commerce settings for a specific business phone number by enabling or disabling cart functionality and catalog visibility. This function differentiates from `get_commerce_settings` by using a POST request to modify data, rather than retrieving it. |
+| `create_upload_session` | Initiates a resumable upload session by providing file metadata (size, type). This function creates an upload session ID and is the first of a two-step process for uploading media, preceding the actual data transfer performed by `resume_session`. |
+| `upload_file_to_session` | Continues a media file upload by sending file data to an existing session. This function is the second step in the upload process, following `upload_file`, which creates the session and provides the required session ID. |
+| `get_business_phone_number` | Retrieves details for a specific WhatsApp Business phone number by its unique ID. The optional `fields` parameter allows for customizing the response to include only desired data, differentiating it from `get_all_business_phone_numbers`, which retrieves a list of all numbers for a WABA. |
+| `list_waba_phone_numbers` | Fetches a list of phone numbers for a specified WhatsApp Business Account (WABA). This function allows for result filtering and customizable field selection, distinguishing it from `get_business_phone_number` which retrieves a single number by its unique ID. |
+| `get_qr_code_by_id` | Retrieves the details of a single QR code, such as its pre-filled message, by its unique ID for a specific business phone number. It fetches a specific code, distinguishing it from `get_all_qr_codes_default_fields` which retrieves a list of codes. |
+| `delete_qr_code_by_id` | Deletes a specific WhatsApp message QR code by its ID for a given business phone number. The function sends a DELETE request to the Graph API's `message_qrdls` endpoint to remove the specified QR code. |
+| `list_qr_codes` | Retrieves a list of QR codes for a business phone number. This function allows optional filtering by a specific QR code identifier and customization of the fields returned in the response, such as the image format. |
+| `create_qr_code` | Generates a WhatsApp Business QR code for a specific phone number. This function allows setting a prefilled message for user convenience and can optionally include a custom identifier. It returns the details of the newly created QR code upon successful generation. |
+| `get_template_by_id` | Retrieves a specific WhatsApp message template by its unique identifier. Unlike `get_template_by_name`, which searches within a business account, this function directly fetches a single template resource. Note: The function signature is missing the required `template_id` parameter to build a valid URL. |
+| `update_template_by_id` | Updates an existing WhatsApp message template, identified by its ID within the request URL. This function modifies the template's category, components, language, and name by submitting new data via a POST request, returning the API response upon successful completion. |
+| `get_message_templates` | Retrieves message templates for a specific WhatsApp Business Account (WABA). It can list all templates or, if a name is provided, filter for an exact match. This differs from `get_template_by_id_default_fields`, which fetches a single template by its unique ID. |
+| `create_message_template` | Creates a new message template for a specified WhatsApp Business Account (WABA). This function sends a POST request with the template's name, language, category, and structural components, enabling the creation of standardized, reusable messages. |
+| `delete_message_template` | Deletes a message template from a WhatsApp Business Account. Templates can be targeted for deletion by providing either a template name, which deletes all language versions, or a specific template ID (`hsm_id`). |
+| `get_subscribed_apps` | Retrieves a list of all applications subscribed to receive webhook notifications for a given WhatsApp Business Account (WABA). This function provides a read-only view of current webhook subscriptions, complementing the functions for subscribing and unsubscribing apps. |
+| `subscribe_app_to_webhooks` | Subscribes an application to a specific WhatsApp Business Account's (WABA) webhooks using its ID. This enables the app to receive real-time event notifications, differentiating it from functions that list or remove subscriptions. |
+| `unsubscribe_app_from_waba` | Removes the webhook subscription for the calling app from a specified WhatsApp Business Account (WABA), stopping it from receiving notifications. This function complements `get_subscribed_apps` and `subscribe_app_to_waba_swebhooks` by handling the deletion of a subscription. |
+| `get_all_client_wabas` | Retrieves all client WhatsApp Business Accounts (WABAs) associated with a specific business account ID. It's used by Solution Partners to list WABAs they manage for other businesses, distinguishing them from accounts they directly own (`get_all_owned_wabas`). |
+| `get_all_owned_wabas` | Retrieves a list of all WhatsApp Business Accounts (WABAs) directly owned by a specified business account. This is distinct from `get_all_shared_wabas`, which fetches WABAs shared with clients, providing specific access to owned assets instead of associated ones. |

universal_mcp/applications/youtube/README.md

@@ -9,49 +9,49 @@ This is automatically generated from OpenAPI schema for the YoutubeApp API.
 
 | Tool | Description |
 |------|-------------|
-| `get_jobs_job_reports` | Retrieves job reports for a specified job based on provided filters and parameters. |
-| `get_jobs_job_reports_report` | Retrieves a specific report associated with a job using the provided job and report identifiers. |
-| `delete_jobs_job` | Deletes a job with the specified ID, optionally acting on behalf of a content owner. |
-| `get_jobs` | Retrieves a list of jobs from the server with optional filtering by query parameters. |
-| `get_media_resource_name` | Retrieves a media resource by name and returns its JSON representation. |
-| `get_reporttypes` | Retrieves a paginated list of report types from the API with optional filtering. |
-| `delete_captions` | Deletes specified captions from a YouTube resource and returns the API response. |
-| `get_captions` | Retrieves caption tracks for a specified video ID from a remote API, supporting optional query parameters for request customization. |
-| `delete_comments` | Deletes a comment or comments from the server based on the specified ID. |
-| `add_comments_mark_as_spam` | Marks a comment as spam by sending a POST request to the API endpoint. |
-| `add_comments_set_moderation_status` | Sets the moderation status for a comment and optionally bans the author through a POST request to a defined endpoint. |
-| `delete_live_broadcasts` | Deletes specified live broadcasts using query parameters to filter requests. |
-| `add_live_broadcasts_bind` | Binds a live broadcast to a stream on YouTube, using specified parameters for authentication and identification. |
-| `add_live_broadcasts_control` | Controls a live broadcast by sending a POST request with specified parameters. |
-| `add_live_broadcasts_transition` | Transitions a live broadcast to a specified status for a given broadcast ID via API. |
-| `delete_live_chat_bans` | Deletes a live chat ban identified by the specified ID from the server. |
-| `delete_live_chat_messages` | Deletes live chat messages based on the specified message ID. |
-| `delete_live_chat_moderators` | Deletes a live chat moderator by ID using the specified endpoint. |
-| `delete_videos` | Deletes specified videos from a video platform using API endpoints. |
-| `get_videos_get_rating` | Retrieves the rating of a video using its ID and optional content owner specification. |
-| `add_videos_rate` | Submits a rating for a video on the server using the provided video ID and rating value. |
-| `add_videos_report_abuse` | Sends an abuse report for videos via the YouTube API, typically used to flag inappropriate content. |
-| `add_watermarks_set` | Sets watermarks on a specified YouTube channel using optional content owner credentials. |
-| `add_watermarks_unset` | Removes watermarks from a YouTube channel specified by channel ID. |
-| `get_activities` | Retrieve YouTube channel activities based on specified filters and parameters. |
-| `add_channel_banners_insert` | Inserts a new channel banner for a YouTube channel using the YouTube Data API. |
-| `delete_channel_sections` | Deletes one or more channel sections from the specified platform using the provided identifiers. |
-| `get_channels` | Retrieves YouTube channels based on specified parameters. |
-| `get_comment_threads` | Retrieve YouTube comment threads based on specified filters and pagination parameters. |
-| `get_fanfundingevents` | Retrieves fan funding events based on specified filter criteria. |
-| `get_guecategories` | Fetches guide categories from a remote service based on specified parameters. |
-| `get_languages` | Fetches a list of supported languages from the internationalization API, returning localized names when specified. |
-| `get_regions` | Retrieves a list of i18n regions from an API endpoint. |
-| `delete_livestreams` | Deletes a YouTube livestream resource using the YouTube Data API with optional filtering parameters. |
-| `delete_play_list_items` | Deletes playlist items identified by the given ID or on behalf of the specified content owner. |
-| `delete_playlists` | Deletes playlists via the YouTube Data API based on specified criteria. |
-| `get_search` | Submits a search query to the YouTube Data API with optional filters. |
-| `get_sponsors` | Fetches a list of sponsors from a server with optional filtering and pagination. |
-| `delete_subscriptions` | Deletes one or all subscriptions by sending a DELETE request to the API endpoint. |
-| `get_superchatevents` | Fetches a list of super chat events from the YouTube API with optional filtering parameters. |
-| `add_thumbnails_set` | Sets a thumbnail for a specified video on behalf of a content owner using the YouTube API. |
-| `get_video_abuse_report_reasons` | Fetches video abuse report reasons with optional localization and response filtering. |
-| `get_veocategories` | Fetches video categories from an external API using specified query parameters and returns the parsed JSON response. |
-| `delete_groupitems` | Deletes group items based on the provided parameters. |
-| `delete_groups` | Deletes specified groups via API, optionally on behalf of a content owner. |
-| `get_reports` | Fetches and returns report data based on specified filtering, sorting, and range criteria. |
+| `list_job_reports` | Retrieves a paginated list of all reports for a specific job ID, with options for filtering by date. Unlike `get_jobs_job_reports_report`, which fetches a single report by its ID, this function returns a collection of reports associated with a job. |
+| `get_job_report` | Fetches a single, specific report identified by its `reportId` from within a given `jobId`. This retrieves an individual record, distinguishing it from `get_jobs_job_reports`, which returns a list of reports for a job. The request can be made on behalf of a content owner. |
+| `delete_job` | Deletes a specific job resource using its unique `jobId`, optionally on behalf of a content owner. This action permanently removes the job itself, differentiating it from functions that only retrieve or manage job reports. |
+| `list_jobs` | Retrieves a paginated list of asynchronous jobs from the YouTube Reporting API. Supports filtering by content owner and including system-managed jobs. This function lists multiple jobs, distinct from `get_jobs_job_reports` which retrieves reports for a single job. |
+| `download_report_media` | Downloads the content of a bulk data report from the YouTube Reporting API by its unique `resourceName`. This function retrieves the actual media file generated by a reporting job, distinct from functions that only fetch report metadata. |
+| `get_reporttypes` | Retrieves a list of available report types from the YouTube Reporting API, supporting pagination and filtering. This function returns metadata about what kinds of reports can be generated, distinct from functions like `get_reports` that fetch actual report content. |
+| `delete_captions` | Deletes a specific YouTube caption resource using its unique ID, with optional delegation for content owners. This management function removes the entire caption track, unlike `get_captions` which only retrieves the transcript text for a given video ID. |
+| `get_transcript_text` | Fetches the full text transcript for a YouTube video using its ID. Unlike other methods using the official API, this function utilizes the `youtube-transcript-api` library to extract and concatenate all caption snippets into a single, timestamp-free string of the video's spoken content. |
+| `delete_comments` | Permanently removes a specific comment identified by its unique ID via a DELETE request. Unlike moderation functions like `add_comments_mark_as_spam`, which only alter a comment's state, this action is irreversible and deletes the resource. An `id` is required to specify the target comment. |
+| `mark_comment_as_spam` | Marks a specified YouTube comment as spam via a POST request to the API. This moderation action is distinct from deleting comments (`delete_comments`) or setting other statuses like 'approved' or 'rejected' (`add_comments_set_moderation_status`). |
+| `set_comment_moderation_status` | Sets the moderation status (e.g., 'approved', 'rejected') for specified comments and can optionally ban the author. Unlike `add_comments_mark_as_spam`, this function allows for various moderation states, providing more granular control over comment management. |
+| `delete_live_broadcasts` | Deletes a YouTube live broadcast event by its unique ID via the API. This request can be made on behalf of a content owner or channel. It targets the `/liveBroadcasts` endpoint, distinguishing it from `delete_livestreams` which manages the actual content stream. |
+| `bind_live_broadcast_to_stream` | Binds a YouTube live broadcast to a video stream using their respective IDs. This action associates the broadcast's metadata with the content stream, optionally performing the action on behalf of a content owner, facilitating the link between a planned event and its live video feed. |
+| `control_live_broadcast` | Sends control commands to a YouTube live broadcast, identified by its ID. It can display a slate or schedule an action using a time offset. Unlike `add_live_broadcasts_transition`, which alters broadcast status (e.g., 'live'), this function manages in-stream state. |
+| `transition_live_broadcast` | Changes a YouTube live broadcast's status (e.g., making it 'live' or 'complete') by posting to the API's transition endpoint. This function alters the broadcast's lifecycle state, distinct from other control actions like binding it to a stream, and returns the API's JSON response. |
+| `delete_live_chat_ban` | Deletes a specific YouTube live chat ban using its unique ID. It sends a DELETE request to the `/liveChat/bans` endpoint to revoke the ban, allowing the user to participate in the chat again. |
+| `delete_live_chat_message` | Deletes a specific YouTube live chat message identified by its unique ID. This function targets the `/liveChat/messages` endpoint, distinguishing it from `delete_live_chat_bans` and `delete_live_chat_moderators`, which manage different aspects of a live chat. |
+| `delete_live_chat_moderators` | Deletes a specific YouTube live chat moderator using their unique ID. This function sends a DELETE request to the `/liveChat/moderators` API endpoint and returns the server's JSON response, confirming the successful removal or detailing errors. The moderator ID is a required parameter for this action. |
+| `delete_videos` | Deletes a specified YouTube video using its unique ID. The operation can be performed on behalf of a content owner by sending an HTTP DELETE request to the `/videos` endpoint. It's distinct from other video functions that only modify or retrieve metadata, like rating or abuse reports. |
+| `get_video_ratings` | Retrieves the authenticated user's rating (e.g., 'like', 'dislike') for specified videos. This function fetches existing rating data, distinct from `add_videos_rate` which submits a new rating, and can be performed on behalf of a content owner. |
+| `rate_video` | Submits a rating (e.g., 'like', 'dislike') for a video specified by its unique ID. This function sends a POST request to the YouTube API's `/videos/rate` endpoint and returns the server's JSON response upon successful submission. |
+| `report_video_for_abuse` | Reports a video for abuse via a POST request to the YouTube API. An optional parameter allows a content owner to submit the report on behalf of their account, flagging potentially inappropriate content for review by YouTube. |
+| `set_channel_watermark` | Sets a branding watermark on a specified YouTube channel. The operation targets the channel using its ID and can be executed on behalf of a content owner. This function contrasts with `add_watermarks_unset`, which removes the watermark. |
+| `unset_channel_watermark` | Removes the branding watermark for a specified YouTube channel via an API POST request. This operation, the inverse of `add_watermarks_set`, can be executed on behalf of a content owner to unset the channel's current watermark. |
+| `get_activities` | Retrieves a list of YouTube activities, such as video uploads or social posts. Supports filtering by channel, authenticated user's feed, publication date, and region. The function also handles pagination to navigate through large result sets and returns the JSON response from the API. |
+| `insert_channel_banner` | Uploads and sets a new banner image for a specified YouTube channel. This function makes a POST request to the `/channelBanners/insert` endpoint, optionally on behalf of a content owner, and returns details of the newly created banner. |
+| `delete_channel_sections` | Deletes a YouTube channel section by its unique ID via an API request. The operation can be performed on behalf of a content owner for delegated management, returning a JSON response upon success or raising an HTTPError for failures like invalid IDs or insufficient permissions. |
+| `list_channels` | Retrieves channel data from the YouTube API using specific filters like ID, username, or ownership status (`mine`, `managedByMe`). The function supports pagination and localization, returning a JSON object containing details for the targeted channels. |
+| `get_comment_threads` | Retrieves YouTube comment threads using filters like channel ID, video ID, or search terms. It supports pagination and sorting, serving as the primary method for fetching comment data, distinct from other functions in the script that moderate or delete individual comments. |
+| `get_fanfundingevents` | Fetches a list of fan funding events from the YouTube API for the authenticated user's channel. Supports pagination, localization, and partial responses to retrieve customized event data like Super Chat or Super Stickers based on specified filter criteria and response parts. |
+| `get_guide_categories` | Retrieves a list of official YouTube guide categories (e.g., Music, Sports). This function queries the `/guideCategories` endpoint, allowing results to be filtered by ID or region and localized for a specific language. These are distinct from the categories assigned to individual videos. |
+| `get_i18n_languages` | Retrieves a list of supported internationalization (i18n) languages from the YouTube API's `/i18nLanguages` endpoint. It can optionally localize the language names in the response. This function is distinct from `get_regions`, which fetches supported geographical regions. |
+| `get_i18n_regions` | Fetches a list of geographic regions supported by the YouTube API for content localization. It can localize region names using the 'hl' parameter. This is distinct from get_languages, which retrieves supported languages, not geographic areas. |
+| `delete_livestreams` | Deletes one or more YouTube livestreams by ID via the `/liveStreams` API endpoint, optionally on behalf of a content owner. This function is distinct from `delete_live_broadcasts`, which targets a different live video resource, and returns the server's JSON response upon successful deletion. |
+| `delete_playlist_items` | Deletes one or more YouTube playlist items by their unique IDs. The operation can be performed on behalf of a content owner for delegated authorization, sending a DELETE request to the `/playlistItems` endpoint and returning the server's response. |
+| `delete_playlists` | Deletes a YouTube playlist by its unique ID via a DELETE request to the API. The operation can be performed on behalf of a specific content owner for delegated management. This function targets the entire playlist, distinct from `delete_play_list_items` which removes individual videos from a playlist. |
+| `get_search` | Performs a versatile search on YouTube for videos, channels, or playlists. This function supports extensive filters, including keywords, publication dates, location, and specific video attributes like category or duration, returning a paginated list of matching resources from the YouTube Data API. |
+| `list_sponsors` | Retrieves a list of sponsors for the authenticated user's YouTube channel. This function supports filtering, pagination, and specifying which resource parts to include in the response, allowing for flexible and customized data fetching of sponsor information. |
+| `delete_subscriptions` | Deletes a specific YouTube channel subscription identified by its unique ID. This function sends a DELETE request to the `/subscriptions` API endpoint and returns the server's JSON response, confirming the operation's success or failure. |
+| `get_super_chat_events` | Retrieves a paginated list of Super Chat events from the YouTube Data API. Allows for localization and specifying which resource parts to include in the response. This function is distinct from `get_fanfundingevents`, which fetches a different type of monetary contribution event. |
+| `set_video_thumbnail` | Sets a custom thumbnail for a specified YouTube video via a POST request to the `/thumbnails/set` API endpoint. The operation can be performed on behalf of a content owner for delegated management of video assets. |
+| `get_video_abuse_report_reasons` | Retrieves a list of valid reasons (e.g., spam, hate speech) for reporting abusive video content. Supports response localization using a language code (`hl`) and allows filtering which parts of the reason resource (e.g., ID, snippet) are returned, providing metadata before submitting a report. |
+| `get_video_categories` | Retrieves official YouTube video categories used for classifying uploaded videos, allowing filtering by ID, region, or language. This is distinct from `get_guecategories`, which fetches channel browsing guides, not categories for individual video uploads. |
+| `delete_group_items` | Deletes specified items from a YouTube Analytics group via an API request. An item can be targeted by its unique ID, and the action can be performed on behalf of a content owner. This function is distinct from `delete_groups`, which removes the entire group. |
+| `delete_groups` | Deletes a YouTube group by its ID via an API request, optionally on behalf of a content owner. Unlike `delete_groupitems`, which only removes an item from a group, this function deletes the entire group entity. |
+| `get_analytics_report` | Queries the YouTube Analytics API for performance reports, allowing customization via metrics, dimensions, and filters. Unlike `get_jobs_job_reports` which manages bulk report jobs, this function fetches analytical data directly, providing on-demand insights into channel or content performance. |

universal_mcp/applications/youtube/app.py

@@ -1,6 +1,8 @@
 from typing import Any
 
 from youtube_transcript_api import YouTubeTranscriptApi
+from youtube_transcript_api.proxies import GenericProxyConfig
+
 
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
@@ -296,7 +298,11 @@ class YoutubeApp(APIApplication):
             raise ValueError("Missing required parameter 'video_id'")
 
         try:
-            api = YouTubeTranscriptApi()
+            api = YouTubeTranscriptApi(
+                proxy_config=GenericProxyConfig(
+                    http_url="http://xgixgown:lp2wabq23752@142.111.48.253:7030/"
+                )
+            )
             transcript = api.fetch(video_id)
 
             transcript_text = " ".join(

universal_mcp/applications/zenquotes/README.md

@@ -9,4 +9,4 @@ This is automatically generated from OpenAPI schema for the ZenquotesApp API.
 
 | Tool | Description |
 |------|-------------|
-| `get_quote` | Fetches a random inspirational quote from the Zen Quotes API. |
+| `get_random_quote` | Fetches a random inspirational quote from the Zen Quotes API via an HTTP request. It parses the JSON response to extract the quote and author, returning them as a single formatted string ('quote - author'). This function is the primary tool provided by the ZenquotesApp. |

{universal_mcp_applications-0.1.18.dist-info → universal_mcp_applications-0.1.19.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-applications
-Version: 0.1.18
+Version: 0.1.19
 Summary: A Universal MCP Application: universal_mcp_applications
 Project-URL: Homepage, https://github.com/universal-mcp/applications
 Project-URL: Repository, https://github.com/universal-mcp/applications
@@ -85,91 +85,4 @@ result = app.some_method(param1="value1")
 
 # Process and print the output
 process_output(result)
-```
-
-## Included Applications
-
-This package includes the following 82 applications:
-
-- `ahrefs`
-- `airtable`
-- `apollo`
-- `asana`
-- `aws-s3`
-- `bill`
-- `box`
-- `braze`
-- `cal-com-v2`
-- `calendly`
-- `canva`
-- `clickup`
-- `coda`
-- `confluence`
-- `contentful`
-- `crustdata`
-- `dialpad`
-- `digitalocean`
-- `domain-checker`
-- `e2b`
-- `elevenlabs`
-- `exa`
-- `falai`
-- `figma`
-- `firecrawl`
-- `fireflies`
-- `fpl`
-- `ghost-content`
-- `github`
-- `gong`
-- `google-ads`
-- `google-calendar`
-- `google-docs`
-- `google-drive`
-- `google-gemini`
-- `google-mail`
-- `google-searchconsole`
-- `google-sheet`
-- `hashnode`
-- `heygen`
-- `http-tools`
-- `hubspot`
-- `jira`
-- `klaviyo`
-- `linkedin`
-- `mailchimp`
-- `markitdown`
-- `miro`
-- `ms-teams`
-- `neon`
-- `notion`
-- `openai`
-- `outlook`
-- `perplexity`
-- `pipedrive`
-- `posthog`
-- `reddit`
-- `replicate`
-- `resend`
-- `retell`
-- `rocketlane`
-- `semanticscholar`
-- `semrush`
-- `sendgrid`
-- `sentry`
-- `serpapi`
-- `sharepoint`
-- `shopify`
-- `shortcut`
-- `slack`
-- `spotify`
-- `supabase`
-- `tavily`
-- `trello`
-- `twillo`
-- `twitter`
-- `unipile`
-- `whatsapp`
-- `whatsapp-business`
-- `wrike`
-- `youtube`
-- `zenquotes`
+```