Skip to main content
Automate your X (formerly Twitter) presence with AI-powered workflows. Search tweets, monitor mentions, track engagement, manage bookmarks, and post content - all by writing plain-language prompts instead of code.
Access your entire X ecosystem including tweets, timelines, followers, trends, and bookmarks to build powerful social media automations.

​
How to Use MCP Nodes

​
What is X MCP?

X MCP creates a custom node that understands the X API for you. Just describe what you want in natural language, and the node handles the request - no API keys or coding required.

​
What Can It Do for You?

  • Monitor brand mentions, competitor activity, or industry conversations in real time
  • Research trending topics and viral content to inform your content strategy
  • Analyze follower demographics and engagement patterns for audience insights
  • Automate tweet posting, bookmark management, and content curation workflows

​
Available Tools

ToolWhat It DoesCredit CostExample Use
Search TweetsSearch for tweets matching a query (recent or full archive)5 per item”Search tweets containing ‘AI automation’ from the last 7 days and return text, author_id, created_at, public_metrics”
Get User TweetsRetrieve tweets authored by a specific user5 per item”Get the last 50 tweets from user ID 12345 excluding retweets and return text, created_at, public_metrics”
Get User MentionsGet tweets that mention a specific user5 per item”Get tweets mentioning user ID 12345 from the last 24 hours and return text, author_id, created_at”
Get User TimelineGet the authenticated user’s home timeline5 per item”Get my timeline with the last 100 posts and return text, author_id, public_metrics”
Get Tweets By IDsRetrieve multiple tweets by their IDs (up to 100)5 per item”Get tweets with IDs [123, 456, 789] and return text, author_id, created_at, public_metrics”
Get BookmarksGet bookmarked tweets for the authenticated user5 per item”Get my bookmarked tweets and return text, author_id, created_at”
Create BookmarkBookmark a tweet5 credits”Bookmark tweet ID 1234567890”
Delete BookmarkRemove a tweet from bookmarks5 credits”Remove tweet ID 1234567890 from my bookmarks”
Create TweetPost a new tweet or edit an existing one10 credits”Create a tweet with text ‘Excited to announce our new product launch!’”
Delete TweetDelete a specific tweet by ID5 credits”Delete tweet ID 1234567890”
Get MeGet authenticated user detailsFree”Get my user profile details”
Search UsersSearch for users matching a query10 per item”Search for users matching ‘data science’ and return id, name, username, public_metrics”
Get FollowersGet users who follow a specific user10 per item”Get followers of user ID 12345 and return id, name, username, public_metrics”
Get FollowingGet users followed by a specific user10 per item”Get accounts followed by user ID 12345 and return id, name, username”
Manage FollowFollow or unfollow a user5 credits”Follow user ID 12345”
Get BlockingGet users blocked by the authenticated user10 per item”Get my blocked users and return id, name, username”
Get Liked TweetsGet tweets liked by a specific user5 per item”Get tweets liked by user ID 12345 and return text, author_id, public_metrics”
Get Liking UsersGet users who liked a specific tweet10 per item”Get users who liked tweet ID 1234567890 and return id, name, username, public_metrics”
Get Trends By WOEIDGet trending topics for a location10 per item”Get trending topics for WOEID 23424977 (United States) and return name, tweet_volume”
Get Personalized TrendsGet personalized trending topics10 per item”Get my personalized trending topics and return name, tweet_volume”
Get UsageGet tweet usage statistics5 credits”Get my tweet usage statistics for the last 30 days”
Hide ReplyHide or unhide a reply to your tweet5 credits”Hide reply with tweet ID 1234567890”
Manage MuteMute or unmute a user5 credits”Mute user ID 12345”

​
How to Use

1

Create Your X MCP Node

Go to your node library, search for X, and click “Create a node with AI”
2

Add Your Prompt

Drag the X MCP node onto the canvas and enter a clear, specific prompt that uses one tool.
3

Test Your Node

Run the node to view results. Adjust the prompt or output fields until it returns exactly what you need.
4

Save and Reuse

Save the finalized X MCP node to your library so you can drop it into any future workflow.

​
Example Prompts

With 23 available tools, these examples showcase common use cases. Feel free to experiment with natural language to discover more possibilities. Monitor Brand Mentions 
Search tweets mentioning "gumloop" OR "@gumloop" from the last 7 days
and return text, author_id, created_at, public_metrics
Track Competitor Activity 
Get the last 100 tweets from user ID `competitor_user_id`
excluding retweets and return text, created_at, public_metrics
Find Viral Content in Your Niche 
Search tweets about "AI automation" with more than 100 likes
from the last 7 days and return text, author_id, public_metrics
Analyze Engagement on a Tweet 
Get users who liked tweet ID `tweet_id`
and return id, name, username, followers_count
Research Trending Topics 
Get trending topics for WOEID 1 (Worldwide)
and return name, tweet_volume
Curate Content with Bookmarks 
Get my bookmarked tweets and return text, author_id, created_at
Post an Update 
Create a tweet with text provided in the `tweet_content` input
Audit Your Following List 
Get accounts I'm following and return id, name, username, public_metrics
Start with a single action like “Search tweets” or “Get user tweets” to verify your X MCP node, then chain multiple nodes for multi-step workflows like content curation or competitor analysis.

​
Troubleshooting

If your X MCP node isn’t working as expected, try these best practices:

​
Keep Prompts Simple and Specific

  • Good: “Search tweets containing ‘product launch’ from the last 7 days and return text, author_id, public_metrics”
  • Less Efficient: “Search tweets about product launches, analyze sentiment, and create a report”
While the longer prompt might work, it’s more efficient to break it into separate nodes. X MCP works best with focused, single-action prompts.

​
Match What X Can Do

  • Good: “Get followers of user ID 12345 and return id, name, followers_count”
  • Less Efficient: “Get followers of user ID 12345 and add them to my HubSpot CRM”
X MCP excels at X platform operations. For CRM updates, combine it with HubSpot or another appropriate node in your workflow.

​
Break Complex Tasks Into Steps

Instead of trying to do everything in one prompt (which might cause timeouts or complexity): 
Search for tweets mentioning our brand, analyze sentiment,
identify influencers, and send them a DM
Break this into smaller, focused nodes that each handle one task:
1

Step 1: Search Mentions

Search tweets mentioning “your_brand” from the last 7 days and return text, author_id, public_metrics
2

Step 2: Analyze Sentiment

Use Ask AI to categorize each tweet as positive, negative, or neutral
3

Step 3: Identify Influencers

Filter for authors with high follower counts using a Filter node
Connect these nodes sequentially in your workflow. The tweet data from Step 1 becomes the input for Step 2, and filtered results feed into Step 3.

​
Focus on Data Retrieval

X MCP is great at getting information from X. For analysis or content creation, connect it to other nodes. Example:
  • Good prompt: “Get the last 50 tweets from user ID 12345 and return text, created_at, public_metrics”
  • Less Efficient: “Get the last 50 tweets from user ID 12345 and summarize their content strategy”
Use X MCP to fetch the tweets, then pass its output to Ask AI for summarization and analysis.

​
Troubleshooting Node Creation

In the node creation window, ask Gummie to add debug logs and verify the API response.
In the node creation window, describe to Gummie what you expected versus what you received.
MCP node creation often requires a few tweaks. Use Gummie chat during node creation to refine filters, output fields, or pagination.

​
Need More Help?