Search and retrieve tweets from X (Formerly Twitter) with comprehensive timeline, bookmark, and search capabilities

X guMCP Server

Search for tweets matching a query. Can search recent (last 7 days) or full archive.

YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Posts will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute).

A comma separated list of fields to expand. Minimum length: 1

Maximum number of results to return across all pages. 10-100 for recent, 10-500 for all

A comma separated list of Media fields to display. Minimum length: 1

A comma separated list of Place fields to display. Minimum length: 1

A comma separated list of Poll fields to display. Minimum length: 1

One query/rule/filter for matching Posts. Refer to https://t.co/rulelength to identify the max query length. Required string length: 1 - 4096

Type of search: 'recent' for last 7 days or 'all' for full archive

Returns results with a Post ID greater than (that is, more recent than) the specified ID.

YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp from which the Posts will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).

A comma separated list of Tweet fields to display. Minimum length: 1

Returns results with a Post ID less than (that is, older than) the specified ID.

A comma separated list of User fields to display. Minimum length: 1

search_tweets

Array of Post objects matching the search query. Each Post contains tweet details including text, author information, engagement metrics, and metadata.

Retrieves a list of posts authored by a specific User by their ID.

YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided. The until_id parameter takes precedence if it is also specified.

The set of entities to exclude (e.g. 'replies' or 'retweets'). Minimum length: 1

Maximum number of tweets to return across all pages.

The minimum Post ID to be included in the result set. This parameter takes precedence over start_time if both are specified.

YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Posts will be provided. The since_id parameter takes precedence if it is also specified.

The maximum Post ID to be included in the result set. This parameter takes precedence over end_time if both are specified.

get_user_tweets

Array of Post objects authored by the specified user. Each Post contains tweet details including text, creation time, engagement metrics, and metadata.

Retrieves a list of Posts that mention a specific User by their ID.

Maximum number of mentions to return across all pages .

get_user_mentions

Array of Post objects that mention the specified user. Each Post contains tweet details including text, author information, and metadata.

Retrieves a reverse chronological list of Posts in the authenticated User's Timeline.

The set of entities to exclude (e.g. 'replies' or 'retweets').

Maximum number of timeline posts to return across all pages .

get_user_timeline

Array of Post objects from the authenticated user's timeline. Each Post contains tweet details including text, author information, creation time, and engagement metrics.

Retrieves details of multiple Posts by their IDs.

A comma separated list of Post IDs. Up to 100 are allowed in a single request. Required array length: 1 - 100 elements

get_tweets_by_ids

Array of Post objects with details for the specified tweet IDs. Each Post contains complete tweet information including text, author, creation time, and engagement metrics.

Retrieves a list of Posts bookmarked by the authenticated user.

Maximum number of bookmarks to return across all pages .

get_bookmarks

Array of Post objects bookmarked by the authenticated user. Each Post contains tweet details including text, author information, and metadata.

Adds a post to the authenticated user's bookmarks.

Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

create_bookmark

Array containing a single object indicating the bookmark creation status.

Removes a Post from the authenticated user's Bookmarks by its ID.

The ID of the Post that the source User is removing from bookmarks.

delete_bookmark

Array containing a single object indicating the bookmark deletion status.

Creates a new Post for the authenticated user, or edits an existing Post when edit_options are provided.

Card Uri Parameter. This is mutually exclusive from Quote Tweet Id, Poll, Media, and Direct Message Deep Link.

Link to take the conversation from the public timeline to a private Direct Message.

Options for editing an existing Post. When provided, this request will edit the specified Post instead of creating a new one.

Place ID being attached to the Tweet for geo location.

Media information being attached to created Tweet. This is mutually exclusive from Quote Tweet Id, Poll, and Card URI.

Nullcasted (promoted-only) Posts do not appear in the public timeline and are not served to followers.

Poll options for a Tweet with a poll. This is mutually exclusive from Media, Quote Tweet Id, and Card URI.

Duration of the poll in minutes. Required range: 5 <= x <= 10080

The text of a poll choice. Required array length: 2 - 4 elements

Settings to indicate who can reply to the Tweet.

Tweet information of the Tweet being replied to.

A list of User Ids to be excluded from the reply Tweet.

create_tweet

Array containing a single Post object with details of the created or edited tweet. Contains tweet ID and text content.

Deletes a specific Post by its ID, if owned by the authenticated user.

delete_tweet

Array containing a single object indicating the deletion status of the tweet.

Retrieves details of the authenticated user.

get_me

Array containing a single User object with details of the authenticated user including profile information, verification status, and public metrics.

Retrieves a list of Users matching a search query.

Maximum number of users to return across all pages .

The query string by which to query for users.

search_users

Array of User objects matching the search query. Each User contains profile information including name, username, verification status, and public metrics.

Retrieves a list of Users who follow a specific User by their ID.

Maximum number of followers to return across all pages .

get_followers

Array of User objects representing followers of the specified user. Each User contains profile information including name, username, and public metrics.

Retrieves a list of Users followed by a specific User by their ID.

Maximum number of following users to return across all pages .

get_following

Array of User objects representing users followed by the specified user. Each User contains profile information including name, username, and public metrics.

Causes the authenticated user to follow or unfollow a specific user by their ID or username.

Unique identifier of the User to follow/unfollow. Either target_user_id or target_username must be provided.

Username of the User to follow/unfollow (e.g., 'gumloop'). Either target_user_id or target_username must be provided.

manage_follow

Array containing a single object indicating the follow/unfollow status.

Retrieves a list of Users blocked by the authenticated user.

Maximum number of blocked users to return across all pages .

get_blocking

Array of User objects representing users blocked by the authenticated user. Each User contains profile information including name, username, and public metrics.

Retrieves a list of Posts liked by a specific User by their ID.

Maximum number of liked tweets to return across all pages .

get_liked_tweets

Array of Post objects liked by the specified user. Each Post contains tweet details including text, author information, and metadata.

Retrieves a list of Users who liked a specific Post by its ID.

Maximum number of liking users to return across all pages .

get_liking_users

Array of User objects representing users who liked the specified tweet. Each User contains profile information including name, username, and public metrics.

Retrieves trending topics for a specific location identified by its WOEID.

The maximum number of results. Required range: 1 <= x <= 50

A comma separated list of Trend fields to display. Minimum length: 1

The WOEID of the place to lookup a trend for.

get_trends_by_woeid

Array of Trend objects for the specified location. Each Trend contains trend name and tweet count.

Retrieves personalized trending topics for the authenticated user.

A comma separated list of PersonalizedTrend fields to display. Minimum length: 1

get_personalized_trends

Array of PersonalizedTrend objects for the authenticated user. Each PersonalizedTrend contains trend name, category, post count, and trending since information.

Retrieves usage statistics for Posts over a specified number of days.

The number of days for which you need usage for. Required range: 1 <= x <= 90

A comma separated list of Usage fields to display. Minimum length: 1

get_usage

Array containing a single Usage object with usage statistics for Posts. Contains project usage, daily usage, cap information, and daily client app usage.

Hides or unhides a reply to a conversation owned by the authenticated user.

Whether to hide (true) or unhide (false) the reply.

The ID of the reply that you want to hide or unhide.

hide_reply

Array containing a single object indicating the hide/unhide status of the reply.

Causes the authenticated user to mute or unmute a specific User by their ID.

The ID of the User that the source User is requesting to mute/unmute.

manage_mute

Array containing a single object indicating the mute/unmute status.

X guMCP Server

Tools

Search Tweets

Get User Tweets

Get User Mentions

Get User Timeline

Get Tweets By Ids

Get Bookmarks

Create Bookmark

Delete Bookmark

Create Tweet

Delete Tweet

Get Me

Search Users

Get Followers

Get Following

Manage Follow

Get Blocking

Get Liked Tweets

Get Liking Users

Get Trends By Woeid

Get Personalized Trends

Get Usage

Hide Reply

Manage Mute

Installation Steps

Create a Gumloop Account

Generate Your Server URL