universal-mcp-applications 0.1.13__py3-none-any.whl → 0.1.15__py3-none-any.whl

universal_mcp/applications/twitter/api_segments/dm_conversations_api.py

@@ -7,25 +7,24 @@ class DmConversationsApi(APISegmentBase):
     def __init__(self, main_app_client: Any):
         super().__init__(main_app_client)
 
-    def dm_conversation_id_create(
+    def create_dm_conversation(
         self, conversation_type=None, message=None, participant_ids=None
     ) -> dict[str, Any]:
         """
-
-        Creates a new group Direct Message conversation and sends an initial message to the specified participants.
-
+        Creates a new group Direct Message conversation with specified participants and sends an initial message. This function specifically handles the creation of new multi-participant conversations, distinct from other methods in this class that add messages to existing one-to-one or group DMs.
+        
         Args:
             conversation_type (string): The conversation type that is being created.
             message (string): message
             participant_ids (array): Participants for the DM Conversation.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Direct Messages
         """
@@ -49,7 +48,7 @@ class DmConversationsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_dm_convo_with_patcpnts_id_dm_evnts(
+    def get_dm_events_by_participant_id(
         self,
         participant_id,
         max_results=None,
@@ -62,9 +61,8 @@ class DmConversationsApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of direct message events for a conversation with a specific participant, allowing for optional filtering by event types and pagination.
-
+        Retrieves direct message events from a conversation identified by a specific participant's ID. Supports pagination and filtering by event type. This method is distinct from `get_dm_conversations_id_dm_events`, which uses a direct conversation ID for retrieval instead of a participant's ID.
+        
         Args:
             participant_id (string): participant_id
             max_results (integer): The maximum number of direct message events to return in the response, with a default of 100.
@@ -75,14 +73,14 @@ class DmConversationsApi(APISegmentBase):
             media_fields (array): A comma separated list of Media fields to display. Example: "['alt_text', 'duration_ms', 'height', 'media_key', 'non_public_metrics', 'organic_metrics', 'preview_image_url', 'promoted_metrics', 'public_metrics', 'type', 'url', 'variants', 'width']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Direct Messages
         """
@@ -107,25 +105,24 @@ class DmConversationsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def dm_conversation_with_user_event_id_create(
+    def send_dm_by_participant_id(
         self, participant_id, attachments=None, text=None
     ) -> dict[str, Any]:
         """
-
-        Creates a new one-to-one Direct Message conversation with the specified participant or adds a message to an existing conversation using the X API.
-
+        Sends a direct message to a user specified by their participant ID. It creates a new one-on-one conversation or appends the message to an existing one. Unlike other functions, this method identifies the conversation using the participant's ID rather than a pre-existing conversation ID.
+        
         Args:
             participant_id (string): participant_id
             attachments (array): Attachments to a DM Event.
             text (string): Text of the message.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Direct Messages
         """
@@ -147,25 +144,24 @@ class DmConversationsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def dm_conversation_by_id_event_id_create(
+    def add_message_to_dm_conversation(
         self, dm_conversation_id, attachments=None, text=None
     ) -> dict[str, Any]:
         """
-
-        Creates a new Direct Message and adds it to an existing conversation specified by the provided dm_conversation_id.
-
+        Sends a new message with optional text and attachments to an existing Direct Message conversation. The target conversation is specified by its `dm_conversation_id`, distinguishing it from functions that create new conversations or send one-to-one messages using a participant ID.
+        
         Args:
             dm_conversation_id (string): dm_conversation_id
             attachments (array): Attachments to a DM Event.
             text (string): Text of the message.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Direct Messages
         """
@@ -187,7 +183,7 @@ class DmConversationsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_dm_conversations_id_dm_events(
+    def get_dm_events_by_conversation_id(
         self,
         id,
         max_results=None,
@@ -200,9 +196,8 @@ class DmConversationsApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of direct message events for a specified conversation ID, allowing for optional filtering by event types and pagination.
-
+        Retrieves direct message events for a specific conversation using its unique ID. This function, distinct from fetching by participant ID, supports pagination, event type filtering, and data field expansion for detailed results.
+        
         Args:
             id (string): id
             max_results (integer): Limits the number of DM events returned in the response, with a default value of 100, allowing users to customize the amount of data retrieved.
@@ -213,14 +208,14 @@ class DmConversationsApi(APISegmentBase):
             media_fields (array): A comma separated list of Media fields to display. Example: "['alt_text', 'duration_ms', 'height', 'media_key', 'non_public_metrics', 'organic_metrics', 'preview_image_url', 'promoted_metrics', 'public_metrics', 'type', 'url', 'variants', 'width']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Direct Messages
         """
@@ -247,9 +242,9 @@ class DmConversationsApi(APISegmentBase):
 
     def list_tools(self):
         return [
-            self.dm_conversation_id_create,
-            self.get_dm_convo_with_patcpnts_id_dm_evnts,
-            self.dm_conversation_with_user_event_id_create,
-            self.dm_conversation_by_id_event_id_create,
-            self.get_dm_conversations_id_dm_events,
+            self.create_dm_conversation,
+            self.get_dm_events_by_participant_id,
+            self.send_dm_by_participant_id,
+            self.add_message_to_dm_conversation,
+            self.get_dm_events_by_conversation_id,
         ]

universal_mcp/applications/twitter/api_segments/dm_events_api.py

@@ -19,9 +19,8 @@ class DmEventsApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of direct message events with optional filtering by event types, pagination, and field expansions for media, users, tweets, and DM event details.
-
+        Retrieves a list of direct message events, unlike `get_dm_events_by_id` which fetches a single event. Supports pagination, filtering by event type, and specifying which data fields to return for various objects to customize the API response.
+        
         Args:
             max_results (integer): Limits the number of DM events returned in the response, with a default of 100 if not specified.
             pagination_token (string): Optional token used to specify the starting point for paginating the response of DM events.
@@ -31,14 +30,14 @@ class DmEventsApi(APISegmentBase):
             media_fields (array): A comma separated list of Media fields to display. Example: "['alt_text', 'duration_ms', 'height', 'media_key', 'non_public_metrics', 'organic_metrics', 'preview_image_url', 'promoted_metrics', 'public_metrics', 'type', 'url', 'variants', 'width']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Direct Messages
         """
@@ -61,21 +60,20 @@ class DmEventsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def dm_event_delete(self, event_id) -> dict[str, Any]:
+    def delete_dm_event(self, event_id) -> dict[str, Any]:
         """
-
-        Deletes a DM event by its ID using the DELETE method, requiring authentication via OAuth2UserToken with "dm.read" and "dm.write" scopes or UserToken.
-
+        Deletes a specific Direct Message (DM) event identified by its unique ID. This function issues an authenticated HTTP DELETE request to the API to permanently remove the specified event, returning a confirmation of the deletion.
+        
         Args:
             event_id (string): event_id
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Direct Messages
         """
@@ -87,7 +85,7 @@ class DmEventsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_dm_events_by_id(
+    def get_dm_event_by_id(
         self,
         event_id,
         dm_event_fields=None,
@@ -97,9 +95,8 @@ class DmEventsApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves detailed information about a specific direct message event by its event ID with optional expansions and field selections.
-
+        Fetches a specific Direct Message event using its unique ID. Optional parameters allow customizing the response by selecting specific fields for the event, media, users, and tweets, and by including expanded object details. This differs from `get_dm_events`, which retrieves a list of events.
+        
         Args:
             event_id (string): event_id
             dm_event_fields (array): A comma separated list of DmEvent fields to display. Example: "['attachments', 'created_at', 'dm_conversation_id', 'entities', 'event_type', 'id', 'participant_ids', 'referenced_tweets', 'sender_id', 'text']".
@@ -107,14 +104,14 @@ class DmEventsApi(APISegmentBase):
             media_fields (array): A comma separated list of Media fields to display. Example: "['alt_text', 'duration_ms', 'height', 'media_key', 'non_public_metrics', 'organic_metrics', 'preview_image_url', 'promoted_metrics', 'public_metrics', 'type', 'url', 'variants', 'width']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Direct Messages
         """
@@ -137,4 +134,4 @@ class DmEventsApi(APISegmentBase):
         return response.json()
 
     def list_tools(self):
-        return [self.get_dm_events, self.dm_event_delete, self.get_dm_events_by_id]
+        return [self.get_dm_events, self.delete_dm_event, self.get_dm_event_by_id]

universal_mcp/applications/twitter/api_segments/likes_api.py

@@ -11,21 +11,20 @@ class LikesApi(APISegmentBase):
         self, backfill_minutes=None, start_time=None, end_time=None
     ) -> Any:
         """
-
-        Streams compliance-related likes data using the GET method, allowing optional filtering by backfill minutes and time range.
-
+        Streams compliance-related data for 'like' events, such as un-likes, with optional time and backfill filters. This endpoint is for compliance monitoring, differing from the firehose and sample streams which provide real-time like creation events.
+        
         Args:
             backfill_minutes (integer): Specifies the number of minutes of missed data to recover in case of a disconnection, allowing retrieval of up to five minutes of past data.
             start_time (string): The optional start_time query parameter specifies the earliest timestamp from which to retrieve compliance stream data. Example: '2021-02-01T18:40:40.000Z'.
             end_time (string): Optional end time to filter the compliance stream, specified as a string. Example: '2021-02-01T18:40:40.000Z'.
-
+        
         Returns:
             Any: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Compliance
         """
@@ -43,7 +42,7 @@ class LikesApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def likes_firehose_stream(
+    def get_likes_firehose_stream(
         self,
         partition,
         backfill_minutes=None,
@@ -55,9 +54,8 @@ class LikesApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Streams a real-time firehose of likes data filtered by partition and optional time range parameters, including expanded tweet and user fields, using Bearer Token authentication.
-
+        Streams a comprehensive, real-time 'firehose' of all like events from a specified data partition. This function allows time-based filtering and customization of returned fields, providing a complete data flow distinct from the compliance or sampled stream methods.
+        
         Args:
             partition (integer): The partition query parameter specifies the integer identifier of the data subset or bucket to stream from the firehose endpoint, enabling segmented retrieval of likes data.
             backfill_minutes (integer): The number of minutes (up to five) to backfill and recover missed data from the stream after a disconnection.
@@ -67,14 +65,14 @@ class LikesApi(APISegmentBase):
             expansions (array): A comma separated list of fields to expand. Example: "['liked_tweet_author_id', 'liked_tweet_id']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Likes
         """
@@ -97,7 +95,7 @@ class LikesApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def likes_sample_stream(
+    def likes_sample10_stream(
         self,
         partition,
         backfill_minutes=None,
@@ -109,9 +107,8 @@ class LikesApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Streams a sample of 10 likes using the GET method, optionally filtering by backfill minutes, partition, start and end times, and including specific tweet and user fields.
-
+        Streams a 10% sample of real-time like events, a low-volume alternative to the full firehose stream. It allows filtering by partition and time range, and supports data enrichment by specifying tweet, user, and expansion fields to customize the response.
+        
         Args:
             partition (integer): The partition query parameter specifies the integer identifier of the data partition to retrieve in the sample10 likes stream.
             backfill_minutes (integer): Optional integer parameter to specify the number of minutes of missed data to recover, used for reconnecting after a disconnection in the stream.
@@ -121,14 +118,14 @@ class LikesApi(APISegmentBase):
             expansions (array): A comma separated list of fields to expand. Example: "['liked_tweet_author_id', 'liked_tweet_id']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Likes
         """
@@ -154,6 +151,6 @@ class LikesApi(APISegmentBase):
     def list_tools(self):
         return [
             self.get_likes_compliance_stream,
-            self.likes_firehose_stream,
-            self.likes_sample_stream,
+            self.get_likes_firehose_stream,
+            self.likes_sample10_stream,
         ]