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

universal_mcp/applications/twitter/api_segments/lists_api.py

@@ -7,25 +7,24 @@ class ListsApi(APISegmentBase):
     def __init__(self, main_app_client: Any):
         super().__init__(main_app_client)
 
-    def list_id_create(
+    def create_list(
         self, description=None, name=None, private=None
     ) -> dict[str, Any]:
         """
-
-        Creates a new Twitter list using the X API v2 and returns the newly created list's details.
-
+        Creates a new list on X (formerly Twitter) with an optional name, description, and privacy setting. It sends a POST request to the `/2/lists` endpoint and returns the JSON data of the newly created list upon success.
+        
         Args:
             description (string): description
             name (string): name
             private (boolean): private
-
+        
         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:
             Lists, important
         """
@@ -49,21 +48,20 @@ class ListsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_id_delete(self, id) -> dict[str, Any]:
+    def delete_list(self, id) -> dict[str, Any]:
         """
-
-        Deletes a list specified by its ID using the DELETE method.
-
+        Permanently deletes a specific Twitter List identified by its unique ID. This function sends an authorized DELETE request to the API's `/2/lists/{id}` endpoint, returning a confirmation response upon successful removal. It is distinct from `list_remove_member`, which only removes a user from a list.
+        
         Args:
             id (string): 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:
             Lists
         """
@@ -75,26 +73,25 @@ class ListsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_id_get(
+    def get_list_by_id(
         self, id, list_fields=None, expansions=None, user_fields=None
     ) -> dict[str, Any]:
         """
-
-        Retrieves detailed information about a specific Twitter List by its unique identifier, including optional expansions and fields for lists and users.
-
+        Retrieves detailed information for a specific list by its ID. This function allows for response customization by specifying which list and user fields to return and supports expansions to include related objects like the owner's user data.
+        
         Args:
             id (string): id
             list_fields (array): A comma separated list of List fields to display. Example: "['created_at', 'description', 'follower_count', 'id', 'member_count', 'name', 'owner_id', 'private']".
             expansions (array): A comma separated list of fields to expand. Example: "['owner_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']".
-
+        
         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:
             Lists
         """
@@ -114,26 +111,25 @@ class ListsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_id_update(
+    def update_list(
         self, id, description=None, name=None, private=None
     ) -> dict[str, Any]:
         """
-
-        Updates a list specified by the ID using the provided JSON payload, authenticating with OAuth2 or user tokens.
-
+        Modifies an existing Twitter list identified by its unique ID. This function updates the list's name, description, or privacy status by sending a PUT request to the API and returns the updated list data upon success.
+        
         Args:
             id (string): id
             description (string): description
             name (string): name
             private (boolean): private
-
+        
         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:
             Lists
         """
@@ -159,7 +155,7 @@ class ListsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_get_followers(
+    def get_list_followers(
         self,
         id,
         max_results=None,
@@ -169,9 +165,8 @@ class ListsApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of users who follow a specified Twitter list using the list ID, with optional parameters for pagination and user data customization.
-
+        Retrieves the users who follow a specific list, identified by its ID. Supports pagination and allows for the customization of returned user, tweet, and expansion fields to tailor the response data, differentiating it from fetching list members.
+        
         Args:
             id (string): id
             max_results (integer): Specifies the maximum number of follower results to return, with a default value of 100.
@@ -179,14 +174,14 @@ class ListsApi(APISegmentBase):
             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']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             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:
             Users
         """
@@ -218,9 +213,8 @@ class ListsApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of User objects that are members of a specified Twitter List by the provided List ID.
-
+        Retrieves users who are members of a specific Twitter list, identified by its ID. Unlike `list_get_followers`, this returns users explicitly added to the list, not subscribers. Supports pagination and customization of the returned user data fields to include expanded objects and specific details.
+        
         Args:
             id (string): id
             max_results (integer): The maximum number of list members to return per page, defaulting to 100.
@@ -228,14 +222,14 @@ class ListsApi(APISegmentBase):
             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']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             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:
             Users
         """
@@ -259,20 +253,19 @@ class ListsApi(APISegmentBase):
 
     def list_add_member(self, id, user_id=None) -> dict[str, Any]:
         """
-
-        Adds one or more members to a specified list by list ID using the POST method.
-
+        Adds a user to a specified Twitter list via a POST request to the `/2/lists/{id}/members` endpoint, requiring list and user IDs. This function modifies a list's membership, distinguishing it from `list_get_members` (retrieves) and its counterpart `list_remove_member` (deletes).
+        
         Args:
             id (string): id
             user_id (string): Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. Example: '2244994945'.
-
+        
         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:
             Lists
         """
@@ -294,22 +287,21 @@ class ListsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_remove_member(self, id, user_id) -> dict[str, Any]:
+    def delete_list_member(self, id, user_id) -> dict[str, Any]:
         """
-
-        Removes a member from a list using the provided list ID and user ID, requiring appropriate permissions for the operation.
-
+        Removes a specific user from a Twitter list. This function sends a DELETE request to the `/2/lists/{id}/members/{user_id}` API endpoint, requiring both the list ID and the user ID to perform the action and confirm the member's removal.
+        
         Args:
             id (string): id
             user_id (string): user_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:
             Lists
         """
@@ -323,7 +315,7 @@ class ListsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def lists_id_tweets(
+    def get_list_tweets(
         self,
         id,
         max_results=None,
@@ -336,9 +328,8 @@ class ListsApi(APISegmentBase):
         place_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of tweets for a specified list by ID using the "GET" method, allowing optional parameters for pagination and field customization.
-
+        Retrieves tweets from a specified Twitter List using its ID. Supports pagination and allows extensive customization of returned fields for tweets, users, media, and other entities. This function uniquely fetches the list's tweet timeline, distinguishing it from functions that retrieve list members or followers.
+        
         Args:
             id (string): id
             max_results (integer): The maximum number of tweets to return per request, with a default value of 100.
@@ -349,14 +340,14 @@ class ListsApi(APISegmentBase):
             poll_fields (array): A comma separated list of Poll fields to display. Example: "['duration_minutes', 'end_datetime', 'id', 'options', 'voting_status']".
             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']".
             place_fields (array): A comma separated list of Place fields to display. Example: "['contained_within', 'country', 'country_code', 'full_name', 'geo', 'id', 'name', 'place_type']".
-
+        
         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:
             Tweets
         """
@@ -383,13 +374,13 @@ class ListsApi(APISegmentBase):
 
     def list_tools(self):
         return [
-            self.list_id_create,
-            self.list_id_delete,
-            self.list_id_get,
-            self.list_id_update,
-            self.list_get_followers,
+            self.create_list,
+            self.delete_list,
+            self.get_list_by_id,
+            self.update_list,
+            self.get_list_followers,
             self.list_get_members,
             self.list_add_member,
-            self.list_remove_member,
-            self.lists_id_tweets,
+            self.delete_list_member,
+            self.get_list_tweets,
         ]

universal_mcp/applications/twitter/api_segments/spaces_api.py

@@ -16,23 +16,22 @@ class SpacesApi(APISegmentBase):
         topic_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves detailed information about specified spaces using the "GET" method, allowing customization through parameters such as space IDs, space fields, space expansions, user fields, and topic fields, while requiring authentication via Bearer or OAuth2 tokens for authorized access.
-
+        Retrieves detailed information for a batch of spaces, specified by a list of their unique IDs. Optional parameters allow for customizing the response by including specific fields and expansions. This method is distinct from `find_space_by_id`, which fetches only a single space per call.
+        
         Args:
             ids (array): Required array of IDs for the requested spaces.
             space_fields (array): A comma separated list of Space fields to display. Example: "['created_at', 'creator_id', 'ended_at', 'host_ids', 'id', 'invited_user_ids', 'is_ticketed', 'lang', 'participant_count', 'scheduled_start', 'speaker_ids', 'started_at', 'state', 'subscriber_count', 'title', 'topic_ids', 'updated_at']".
             expansions (array): A comma separated list of fields to expand. Example: "['creator_id', 'host_ids', 'invited_user_ids', 'speaker_ids', 'topic_ids']".
             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']".
             topic_fields (array): A comma separated list of Topic fields to display. Example: "['description', 'id', 'name']".
-
+        
         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:
             Spaces
         """
@@ -61,23 +60,22 @@ class SpacesApi(APISegmentBase):
         topic_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of spaces by their creator IDs using the specified user IDs, with optional filtering by space fields, space expansions, user fields, and topic fields.
-
+        Fetches a list of spaces created by specified users, identified by their user IDs. This function is distinct from `find_spaces_by_ids`, which retrieves spaces by their own unique IDs. Optional parameters allow for customizing the fields returned for spaces, users, and topics.
+        
         Args:
             user_ids (array): **user_ids**: Required array of user IDs for filtering spaces by their creators.
             space_fields (array): A comma separated list of Space fields to display. Example: "['created_at', 'creator_id', 'ended_at', 'host_ids', 'id', 'invited_user_ids', 'is_ticketed', 'lang', 'participant_count', 'scheduled_start', 'speaker_ids', 'started_at', 'state', 'subscriber_count', 'title', 'topic_ids', 'updated_at']".
             expansions (array): A comma separated list of fields to expand. Example: "['creator_id', 'host_ids', 'invited_user_ids', 'speaker_ids', 'topic_ids']".
             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']".
             topic_fields (array): A comma separated list of Topic fields to display. Example: "['description', 'id', 'name']".
-
+        
         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:
             Spaces
         """
@@ -108,9 +106,8 @@ class SpacesApi(APISegmentBase):
         topic_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Searches for spaces using the specified query and optional filters like state, and returns the results with customizable fields and expansions.
-
+        Performs a keyword-based search for Twitter Spaces, allowing filters by state (e.g., 'live', 'scheduled'). The function supports customizing the response data by specifying fields for spaces, users, and topics, distinguishing it from methods that find spaces by specific IDs.
+        
         Args:
             query (string): The "query" parameter is a required string input for the GET operation at path "/2/spaces/search", used to specify search terms for finding spaces. Example: 'crypto'.
             state (string): Optional query parameter to filter search results by space state, which can be "live," "scheduled," or "all" (default).
@@ -119,14 +116,14 @@ class SpacesApi(APISegmentBase):
             expansions (array): A comma separated list of fields to expand. Example: "['creator_id', 'host_ids', 'invited_user_ids', 'speaker_ids', 'topic_ids']".
             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']".
             topic_fields (array): A comma separated list of Topic fields to display. Example: "['description', 'id', 'name']".
-
+        
         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:
             Spaces
         """
@@ -148,7 +145,7 @@ class SpacesApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def find_space_by_id(
+    def get_space_by_id(
         self,
         id,
         space_fields=None,
@@ -157,23 +154,22 @@ class SpacesApi(APISegmentBase):
         topic_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves details about a specific space by its ID, allowing optional customization through space fields, space expansions, user fields, and topic fields, using a Bearer or OAuth2 token for authentication.
-
+        Retrieves detailed information for a single space using its unique ID. Optional parameters allow customizing the response by specifying fields and expansions. Unlike `find_spaces_by_ids`, which fetches multiple spaces, this function targets only one specific space.
+        
         Args:
             id (string): id
             space_fields (array): A comma separated list of Space fields to display. Example: "['created_at', 'creator_id', 'ended_at', 'host_ids', 'id', 'invited_user_ids', 'is_ticketed', 'lang', 'participant_count', 'scheduled_start', 'speaker_ids', 'started_at', 'state', 'subscriber_count', 'title', 'topic_ids', 'updated_at']".
             expansions (array): A comma separated list of fields to expand. Example: "['creator_id', 'host_ids', 'invited_user_ids', 'speaker_ids', 'topic_ids']".
             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']".
             topic_fields (array): A comma separated list of Topic fields to display. Example: "['description', 'id', 'name']".
-
+        
         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:
             Spaces
         """
@@ -194,7 +190,7 @@ class SpacesApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def space_buyers(
+    def list_space_buyers(
         self,
         id,
         pagination_token=None,
@@ -204,9 +200,8 @@ class SpacesApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of buyers for a specific space using the "GET" method, allowing optional pagination and customization of returned user and tweet fields.
-
+        Retrieves a list of users who have purchased tickets for a specific ticketed Space, identified by its ID. This function supports pagination and allows for the customization of user and tweet fields in the API response.
+        
         Args:
             id (string): id
             pagination_token (string): Optional token used for pagination to retrieve the next set of results in a sequence.
@@ -214,14 +209,14 @@ class SpacesApi(APISegmentBase):
             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']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             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:
             Spaces, Tweets
         """
@@ -243,7 +238,7 @@ class SpacesApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def space_tweets(
+    def list_tweets_from_space(
         self,
         id,
         max_results=None,
@@ -255,9 +250,8 @@ class SpacesApi(APISegmentBase):
         place_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of tweets from a specified Twitter Space by its ID, with optional parameters to customize the fields and expansions included in the response.
-
+        Fetches tweets from a specific Space using its ID. Allows extensive customization of returned data fields (e.g., media, user) and limits results. Unlike `space_buyers`, which retrieves users who purchased tickets, this function returns the actual tweets shared within the Space.
+        
         Args:
             id (string): id
             max_results (integer): The `max_results` parameter limits the number of tweets returned in the response for the GET operation at "/2/spaces/{id}/tweets", with a default of 100. Example: '25'.
@@ -267,14 +261,14 @@ class SpacesApi(APISegmentBase):
             poll_fields (array): A comma separated list of Poll fields to display. Example: "['duration_minutes', 'end_datetime', 'id', 'options', 'voting_status']".
             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']".
             place_fields (array): A comma separated list of Place fields to display. Example: "['contained_within', 'country', 'country_code', 'full_name', 'geo', 'id', 'name', 'place_type']".
-
+        
         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:
             Spaces, Tweets
         """
@@ -303,7 +297,7 @@ class SpacesApi(APISegmentBase):
             self.find_spaces_by_ids,
             self.find_spaces_by_creator_ids,
             self.search_spaces,
-            self.find_space_by_id,
-            self.space_buyers,
-            self.space_tweets,
+            self.get_space_by_id,
+            self.list_space_buyers,
+            self.list_tweets_from_space,
         ]

universal_mcp/applications/twitter/api_segments/trends_api.py

@@ -7,22 +7,21 @@ class TrendsApi(APISegmentBase):
     def __init__(self, main_app_client: Any):
         super().__init__(main_app_client)
 
-    def get_trends(self, woeid, trend_fields=None) -> dict[str, Any]:
+    def get_trends_by_woeid(self, woeid, trend_fields=None) -> dict[str, Any]:
         """
-
-        Retrieves trending information by WOEID (Where On Earth ID) using the specified trend fields and returns a response with a valid Bearer token.
-
+        Fetches trending topics for a specific location identified by its Where On Earth ID (WOEID). It builds and executes an authenticated API request, optionally allowing users to specify which trend-related fields (e.g., 'tweet_count') to include in the returned JSON response.
+        
         Args:
             woeid (string): woeid
             trend_fields (array): A comma separated list of Trend fields to display. Example: "['trend_name', 'tweet_count']".
-
+        
         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:
             Trends
         """
@@ -37,4 +36,4 @@ class TrendsApi(APISegmentBase):
         return response.json()
 
     def list_tools(self):
-        return [self.get_trends]
+        return [self.get_trends_by_woeid]