Before accessing any Twitter tools, connect your Twitter account via the App Connection page. Without this, tool calls will fail due to missing authorization.
Twitter Tool Categories
Tweet Management
TWITTER_CREATION_OF_A_POST– Posts a new tweet (text required unless you attach media, poll, card, or quote another tweet).TWITTER_POST_DELETE_BY_POST_ID– Irreversibly deletes a tweet by its ID.TWITTER_RETWEET_POST– Retweets a tweet on behalf of the authenticated user.TWITTER_UNRETWEET_POST– Removes your retweet of a specified tweet.TWITTER_USER_LIKE_POST– Likes a tweet on behalf of the authenticated user.TWITTER_UNLIKE_POST– Removes a like from a tweet.TWITTER_ADD_POST_TO_BOOKMARKS– Bookmarks a tweet for the authenticated user.TWITTER_REMOVE_A_BOOKMARKED_POST– Removes a tweet from your bookmarks.TWITTER_POST_LOOKUP_BY_POST_ID– Fetches details for a specific tweet.TWITTER_POST_LOOKUP_BY_POST_IDS– Fetches details for multiple tweets by ID.TWITTER_RECENT_SEARCH– Searches tweets from the last 7 days.TWITTER_RECENT_SEARCH_COUNTS– Returns counts of recent-search results by time intervals.TWITTER_FULL_ARCHIVE_SEARCH– Searches the full public tweet archive (since March 2006).TWITTER_FULL_ARCHIVE_SEARCH_COUNTS– Returns counts of archive-search results aggregated by time intervals.TWITTER_POSTS_LABEL_STREAM– Opens a real-time stream of tweet label events.TWITTER_POST_USAGE– Retrieves your app’s tweet-usage stats (limits, breakdowns).TWITTER_RETRIEVE_POSTS_FROM_A_SPACE– Retrieves tweets from a specified space (batched).TWITTER_RETRIEVE_POSTS_THAT_QUOTE_A_POST– Retrieves tweets quoting a given tweet.TWITTER_RETRIEVE_POSTS_THAT_REPOST_A_POST– Retrieves retweets of a given tweet.TWITTER_LIST_POSTS_TIMELINE_BY_LIST_ID– Fetches recent tweets from members of a list.TWITTER_LIST_POST_LIKERS– Lists users who liked a specific tweet.TWITTER_GET_POST_RETWEETERS_ACTION– Lists users who retweeted a given tweet.
List Management
TWITTER_CREATE_LIST– Creates a new, empty list for the authenticated user (name must be unique).TWITTER_DELETE_LIST– Permanently deletes one of your lists by ID.TWITTER_UPDATE_LIST– Updates a list’s name, description, or privacy.TWITTER_ADD_A_LIST_MEMBER– Adds a user to one of your lists.TWITTER_REMOVE_A_LIST_MEMBER– Removes a member from one of your lists.TWITTER_FETCH_LIST_MEMBERS_BY_ID– Lists members of a specified list.TWITTER_LIST_LOOKUP_BY_LIST_ID– Retrieves metadata for a single list.TWITTER_GET_LIST_FOLLOWERS– Lists users who follow a specified list.TWITTER_FOLLOW_A_LIST– Subscribes the authenticated user to a list’s timeline (doesn’t automatically follow members).TWITTER_UNFOLLOW_A_LIST– Unsubscribes the user from a list.TWITTER_PIN_A_LIST– Pins a list to the authenticated user’s profile.TWITTER_UNPIN_A_LIST– Unpins a list from the user’s profile.TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS– Lists all lists a user is a member of.TWITTER_GET_A_USER_S_OWNED_LISTS– Lists all lists created by a given user.TWITTER_GET_A_USER_S_PINNED_LISTS– Lists the lists a user has pinned on their profile.TWITTER_GET_USER_S_FOLLOWED_LISTS– Lists the lists a user follows.
User & Follower Management
TWITTER_FOLLOW_USER– Makes the authenticated user follow another user (may send a request if their tweets are protected).TWITTER_UNFOLLOW_USER– Makes the authenticated user unfollow another user.TWITTER_GET_BLOCKED_USERS– Retrieves the accounts blocked by a given user.TWITTER_GET_MUTED_USERS– Retrieves accounts muted by the user.TWITTER_MUTE_USER_BY_USER_ID– Mutes a target user for the authenticated user.TWITTER_UNMUTE_USER_BY_USER_ID– Unmutes a previously muted user.TWITTER_FOLLOWERS_BY_USER_ID– Lists followers of a specified user.TWITTER_FOLLOWING_BY_USER_ID– Lists accounts a specified user follows.TWITTER_USER_LOOKUP_BY_USERNAME– Fetches public profile info for a user by their username.TWITTER_USER_LOOKUP_BY_ID– Fetches a user’s public profile by their ID.TWITTER_USER_LOOKUP_BY_IDS– Fetches multiple users’ profiles by IDs.TWITTER_USER_LOOKUP_BY_USERNAMES– Fetches multiple users’ profiles by usernames.TWITTER_USER_LOOKUP_ME– Returns profile info for the authenticated user.TWITTER_USER_HOME_TIMELINE_BY_USER_ID– Retrieves a user’s home timeline (their tweets/retweets).
Direct Messages (DMs)
TWITTER_CREATE_A_NEW_DM_CONVERSATION– Starts a new group DM with participants and an initial message.TWITTER_SEND_A_NEW_MESSAGE_TO_A_DM_CONVERSATION– Sends a message (text/media) to an existing DM conversation.TWITTER_SEND_A_NEW_MESSAGE_TO_A_USER– Sends a new DM to a user (creates a new conversation).TWITTER_GET_DM_EVENTS_BY_ID– Fetches a single DM event by its event ID.TWITTER_GET_DM_EVENTS_FOR_A_DM_CONVERSATION– Fetches DM events in a one-on-one conversation (newest first).TWITTER_GET_RECENT_DM_EVENTS– Returns recent DM events for the authenticated user.TWITTER_DELETE_DM– Deletes a DM event sent by the authenticated user (doesn’t delete the whole conversation).TWITTER_RETRIEVE_DM_CONVERSATION_EVENTS– Fetches DM events for a conversation.
Spaces & Compliance
TWITTER_SEARCH_FOR_SPACES– Searches for live or scheduled spaces by query.TWITTER_SPACE_LOOKUP_BY_SPACE_ID– Retrieves details for a space by its ID.TWITTER_SPACE_LOOKUP_BY_THEIR_CREATORS– Retrieves spaces created by specified user IDs.TWITTER_SPACE_LOOKUP_UP_SPACE_IDS– Fetches details for multiple spaces by ID.TWITTER_FETCH_SPACE_TICKET_BUYERS_LIST– Lists users who bought tickets for a ticketed space.TWITTER_CREATE_COMPLIANCE_JOB_REQUEST– Creates a compliance job (e.g. to check tweet/user IDs), returning an upload URL.TWITTER_RETRIEVE_COMPLIANCE_JOBS– Lists your recent compliance jobs.TWITTER_RETRIEVE_COMPLIANCE_JOB_BY_ID– Retrieves details for a single compliance job.
Other Actions
TWITTER_HIDE_REPLIES– Hides or unhides a reply tweet.
Usage Notes
- Handle tweet, user, and list IDs carefully to avoid errors.
- Use search and streaming tools for advanced analytics and monitoring.
- Combine tweet, list, and DM tools for powerful automation and engagement workflows.