Tools
| Name & Description | Type |
|---|---|
| TWITTER_CREATE_LISTCreates a new, empty list on X (formerly twitter), for which the provided name must be unique for the authenticated user; accounts are added separately. | action |
| TWITTER_CREATION_OF_A_POSTCreates a tweet on twitter; `teXt` is required unless `card uri`, `media media ids`, `poll options`, or `quote tweet id` is provided. | action |
| TWITTER_DELETE_LISTPermanently deletes a specified twitter list using its id, which must be owned by the authenticated user; this action is irreversible and the list must already eXist. | action |
| TWITTER_FOLLOW_USERAllows an authenticated user (path `id`) to follow another user (`target user id`), which results in a pending request if the target user's tweets are protected. | action |
| TWITTER_GET_BLOCKED_USERSRetrieves user objects for accounts blocked by the specified user id; this is a read-only view of a user's block list. | action |
| TWITTER_POST_DELETE_BY_POST_IDIrreversibly deletes a specific tweet by its id; the tweet may persist in third-party caches after deletion. | action |
| TWITTER_UNFOLLOW_USERAllows the authenticated `source user id` to unfollow an eXisting twitter user (`target user id`), which removes the follow relationship. | action |
| TWITTER_USER_LOOKUP_BY_USERNAMEFetches public profile information for a valid and eXisting twitter user by their username, optionally eXpanding related data like pinned tweets; results may be limited for protected profiles not followed by the authenticated user. | action |
| TWITTER_USER_LOOKUP_MEReturns profile information for the currently authenticated X user, customizable via request fields. | action |
| TWITTER_ADD_A_LIST_MEMBERAdds a user to a specified twitter list; the list must be owned by the authenticated user. | action |
| TWITTER_ADD_POST_TO_BOOKMARKSAdds a specified, eXisting, and accessible tweet to a user's bookmarks, with success indicated by the 'bookmarked' field in the response. | action |
| TWITTER_BOOKMARKS_BY_USERRetrieves tweets bookmarked by the authenticated user, where the provided user id must match the authenticated user's id. | action |
| TWITTER_CREATE_A_NEW_DM_CONVERSATIONCreates a new group direct message (dm) conversation on twitter with specified participant ids and an initial message, which can include teXt and media attachments. | action |
| TWITTER_CREATE_COMPLIANCE_JOB_REQUESTCreates a new compliance job to check the status of tweet or user ids; upload ids as a plain teXt file (one id per line) to the `upload url` received in the response. | action |
| TWITTER_DELETE_DMPermanently deletes a specific twitter direct message (dm) event using its `event id` if the authenticated user sent it; this action is irreversible and does not delete entire conversations. | action |
| TWITTER_FETCH_LIST_MEMBERS_BY_IDFetches members of a specific twitter list, identified by its unique id. | action |
| TWITTER_FETCH_SPACE_TICKET_BUYERS_LISTRetrieves a list of users who purchased tickets for a specific, valid, and ticketed twitter space. | action |
| TWITTER_FOLLOWERS_BY_USER_IDRetrieves a list of users who follow a specified public twitter user id. | action |
| TWITTER_FOLLOWING_BY_USER_IDRetrieves users followed by a specific twitter user, allowing pagination and customization of returned user and tweet data fields via eXpansions. | action |
| TWITTER_FOLLOW_A_LISTAllows the authenticated user (`id`) to follow a specific twitter list (`list id`) they are permitted to access, subscribing them to the list's timeline; this does not automatically follow individual list members. | action |
| TWITTER_FULL_ARCHIVE_SEARCHSearches the full archive of public tweets from march 2006 onwards; use 'start time' and 'end time' together for a defined time window. | action |
| TWITTER_FULL_ARCHIVE_SEARCH_COUNTSReturns a count of tweets from the full archive that match a specified query, aggregated by day, hour, or minute; `start time` must be before `end time` if both are provided, and `since id`/`until id` cannot be used with `start time`/`end time`. | action |
| TWITTER_GET_A_USER_S_LIST_MEMBERSHIPSRetrieves all twitter lists a specified user is a member of, including public lists and private lists the authenticated user is authorized to view. | action |
| TWITTER_GET_A_USER_S_OWNED_LISTSCall this action to retrieve lists created (owned) by a specific twitter user, not lists they follow or are subscribed to. | action |
| TWITTER_GET_A_USER_S_PINNED_LISTSRetrieves the lists a specific, eXisting twitter user has pinned to their profile to highlight them. | action |
| TWITTER_GET_DM_EVENTS_BY_IDFetches a specific direct message (dm) event by its unique id, allowing optional eXpansion of related data like users or tweets; ensure the `event id` refers to an eXisting dm event accessible to the authenticated user. | action |
| TWITTER_GET_DM_EVENTS_FOR_A_DM_CONVERSATIONFetches direct message (dm) events for a one-on-one conversation with a specified participant id, ordered chronologically newest to oldest; does not support group dms. | action |
| TWITTER_GET_LIST_FOLLOWERSFetches a list of users who follow a specific twitter list, identified by its id; ensure the authenticated user has access if the list is private. | action |
| TWITTER_GET_MUTED_USERSReturns user objects muted by the X user identified by the `id` path parameter. | action |
| TWITTER_GET_POST_RETWEETERS_ACTIONRetrieves users who publicly retweeted a specified public post id, eXcluding quote tweets and retweets from private accounts. | action |
| TWITTER_GET_RECENT_DM_EVENTSReturns recent direct message events for the authenticated user, such as new messages or changes in conversation participants. | action |
| TWITTER_GET_USER_S_FOLLOWED_LISTSReturns metadata (not tweets) for lists a specific twitter user follows, optionally including eXpanded owner details. | action |
| TWITTER_HIDE_REPLIESHides or unhides an eXisting reply tweet. | action |
| TWITTER_LIST_LOOKUP_BY_LIST_IDReturns metadata for a specific twitter list, identified by its id; does not return list members but can eXpand the owner's user object via the `eXpansions` parameter. | action |
| TWITTER_LIST_POSTS_TIMELINE_BY_LIST_IDFetches the most recent tweets posted by members of a specified twitter list. | action |
| TWITTER_LIST_POST_LIKERSRetrieves users who have liked the post (tweet) identified by the provided id. | action |
| TWITTER_MUTE_USER_BY_USER_IDMutes a target user on behalf of an authenticated user, preventing the target's tweets and retweets from appearing in the authenticated user's home timeline without notifying the target. | action |
| TWITTER_PIN_A_LISTPins a specified list to the authenticated user's profile, provided the list eXists, the user has access rights, and the pin limit (typically 5 lists) is not eXceeded. | action |
| TWITTER_POSTS_LABEL_STREAMEstablishes a persistent stream of real-time events for when tweet labels are applied or removed, offering insights into content categorization. | action |
| TWITTER_POST_LOOKUP_BY_POST_IDFetches comprehensive details for a single tweet by its unique id, provided the tweet eXists and is accessible. | action |
| TWITTER_POST_LOOKUP_BY_POST_IDSRetrieves detailed information for one or more posts (tweets) identified by their unique ids, allowing selection of specific fields and eXpansions. | action |
| TWITTER_POST_USAGEFetches tweet usage statistics for a project (e. | action |
| TWITTER_RECENT_SEARCHSearches tweets from the last 7 days matching a query (using X's search syntaX), ideal for real-time analysis and trend monitoring. | action |
| TWITTER_RECENT_SEARCH_COUNTSRetrieves the count of tweets matching a specified search query within the last 7 days, aggregated by 'minute', 'hour', or 'day'. | action |
| TWITTER_REMOVE_A_BOOKMARKED_POSTRemoves a tweet, specified by `tweet id`, from the authenticated user's bookmarks; the tweet must have been previously bookmarked by the user for the action to have an effect. | action |
| TWITTER_REMOVE_A_LIST_MEMBERRemoves a user from a twitter list; the response `is member` field will be `false` if removal was successful or the user was not a member, and the updated list of members is not returned. | action |
| TWITTER_RETRIEVE_COMPLIANCE_JOBSReturns a list of recent compliance jobs, filtered by type (tweets or users) and optionally by status. | action |
| TWITTER_RETRIEVE_COMPLIANCE_JOB_BY_IDRetrieves status, download/upload urls, and other details for an eXisting twitter compliance job specified by its unique id. | action |
| TWITTER_RETRIEVE_DM_CONVERSATION_EVENTSRetrieves direct message (dm) events for a specific conversation id on twitter, useful for analyzing messages and participant activities. | action |
| TWITTER_RETRIEVE_POSTS_FROM_A_SPACERetrieves tweets from a specified twitter space id; the space must be accessible and results are batched (not streamed). | action |
| TWITTER_RETRIEVE_POSTS_THAT_QUOTE_A_POSTRetrieves tweets that quote a specified tweet, requiring a valid tweet id. | action |
| TWITTER_RETRIEVE_POSTS_THAT_REPOST_A_POSTRetrieves tweets that retweeted a specified public or authenticated-user-accessible tweet id, optionally customizing the response with fields and eXpansions. | action |
| TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_IDRetrieves tweets liked by a specified twitter user, provided their liked tweets are public or accessible. | action |
| TWITTER_RETURNS_THE_OPEN_API_SPECIFICATION_DOCUMENTFetches the openAPI specification (json) for twitter's API v2, used to programmatically understand the API's structure for developing client libraries or tools. | action |
| TWITTER_RETWEET_POSTRetweets a tweet (`tweet id`) for a given user (`id`), provided the tweet is public (or user follows if protected), not already retweeted by the user, and its author has not blocked the user. | action |
| TWITTER_SEARCH_FOR_SPACESSearches for twitter spaces by a teXtual query, optionally filtering by state (live, scheduled, all) to discover audio conversations. | action |
| TWITTER_SEND_A_NEW_MESSAGE_TO_A_DM_CONVERSATIONSends a message, with optional teXt and/or media attachments (using pre-uploaded `media id`s), to a specified twitter direct message conversation. | action |
| TWITTER_SEND_A_NEW_MESSAGE_TO_A_USERSends a new direct message with teXt and/or media (media id for attachments must be pre-uploaded) to a specified twitter user; this creates a new dm and does not modify eXisting messages. | action |
| TWITTER_SPACE_LOOKUP_BY_SPACE_IDRetrieves details for a twitter space by its id, allowing for customization and eXpansion of related data, provided the space id is valid and accessible. | action |
| TWITTER_SPACE_LOOKUP_BY_THEIR_CREATORSRetrieves twitter spaces created by a list of specified user ids, with options to customize returned data fields. | action |
| TWITTER_SPACE_LOOKUP_UP_SPACE_IDSFetches detailed information for one or more twitter spaces (live, scheduled, or ended) by their unique ids; at least one space id must be provided. | action |
| TWITTER_UNFOLLOW_A_LISTEnables a user (via `id`) to unfollow a specific twitter list (via `list id`), which removes its tweets from their timeline and stops related notifications; the action reports `following: false` on success, even if the user was not initially following the list. | action |
| TWITTER_UNLIKE_POSTAllows an authenticated user (`id`) to remove their like from a specific post (`tweet id`); the action is idempotent and completes successfully even if the post was not liked. | action |
| TWITTER_UNMUTE_USER_BY_USER_IDUnmutes a `target user id` for the `source user id` (authenticated user), allowing the source user to see tweets and notifications from the target user again. | action |
| TWITTER_UNPIN_A_LISTUnpins a list (specified by list id) from a user's profile (specified by id), provided the list is currently pinned by that user. | action |
| TWITTER_UNRETWEET_POSTRemoves a user's retweet of a specified post, if the user had previously retweeted it. | action |
| TWITTER_UPDATE_LISTUpdates an eXisting twitter list's name, description, or privacy status, requiring the list id and at least one mutable property. | action |
| TWITTER_USER_HOME_TIMELINE_BY_USER_IDRetrieves the most recent tweets and retweets posted by a specified twitter user in reverse chronological order, eXcluding replies/mentions unless part of self-threads/retweets; useful for showing latest activity without algorithmic sorting. | action |
| TWITTER_USER_LIKE_POSTAllows the authenticated user (`id`) to like a specific, accessible tweet (`tweet id`), provided neither user has blocked the other and the authenticated user is not restricted from liking. | action |
| TWITTER_USER_LOOKUP_BY_IDRetrieves detailed public information for a twitter user by their id, optionally eXpanding related data (e. | action |
| TWITTER_USER_LOOKUP_BY_IDSRetrieves detailed information for specified X (formerly twitter) user ids, optionally customizing returned fields and eXpanding related entities. | action |
| TWITTER_USER_LOOKUP_BY_USERNAMESRetrieves detailed information for 1 to 100 twitter users by their usernames (each 1-15 alphanumeric characters/underscores), allowing customizable user/tweet fields and eXpansion of related data like pinned tweets. | action |