X logo — MCP server on Gumloop

X (Twitter) MCP Server

Connect to the X (Twitter) MCP server to search tweets, pull timelines, manage bookmarks, and post content using AI agents on Gumloop, Claude, or Cursor.

Tools

  • Search Tweets

    5 per item

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

  • Get User Tweets

    5 per item

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

  • Get User Mentions

    5 per item

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

  • Get User Timeline

    5 per item

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

  • Get Tweets By Ids

    5 per item

    Retrieves details of multiple Posts by their IDs.

  • Get Bookmarks

    5 per item

    Retrieves a list of Posts bookmarked by the authenticated user.

  • Create Bookmark

    5 credits

    Adds a post to the authenticated user's bookmarks.

  • Delete Bookmark

    5 credits

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

  • Create Tweet

    10 credits

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

  • Delete Tweet

    5 credits

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

  • Get Me

    Retrieves details of the authenticated user.

  • Search Users

    10 per item

    Retrieves a list of Users matching a search query.

  • Get Followers

    10 per item

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

  • Get Following

    10 per item

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

  • Manage Follow

    5 credits

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

  • Get Blocking

    10 per item

    Retrieves a list of Users blocked by the authenticated user.

  • Get Liked Tweets

    5 per item

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

  • Get Liking Users

    10 per item

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

  • Get Trends By Woeid

    10 per item

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

  • Get Personalized Trends

    10 per item

    Retrieves personalized trending topics for the authenticated user.

  • Get Usage

    5 credits

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

  • Hide Reply

    5 credits

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

  • Manage Mute

    5 credits

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

Installation Steps

Get StartedGet Started
1

Create a Gumloop Account

To use this MCP, you need a Gumloop account. If you don't have one yet, you can create one for free.

2

Copy Your Server URL

Copy your MCP server URL and add it to your client. You'll be prompted to authorize on first use.

What is X (Twitter) MCP?

The X MCP server (formerly Twitter MCP server) gives AI agents access to the X platform. That means searching tweets by keyword or hashtag, pulling a user’s tweet history, getting mentions, viewing your timeline, managing bookmarks, creating and deleting tweets, and searching for user profiles. The data comes back in structured formats with engagement metrics, timestamps, and user details.

If you’re a social media manager monitoring conversations, a marketer tracking brand mentions, a sales team doing research on prospects, or a content creator managing your presence, this integration puts X data into your AI workflows. Describe what you need and your AI agent handles the API calls.

MCP stands for Model Context Protocol. It’s an open standard that gives AI agents a way to connect to external tools and services. Instead of applying for X API access, managing bearer tokens, or dealing with rate limits in custom scripts, you connect the X MCP server and let your AI agent search, read, and post on X through natural language.

What you can do with X (Twitter) MCP on Gumloop

  • Search tweets by keyword or hashtagFind tweets matching any search query with options for recent or all-time results. Get full tweet data including text, engagement metrics (likes, retweets, replies), author info, and timestamps. Useful for monitoring topics, tracking conversations, or finding leads.

  • Pull a user’s tweet historyGet tweets authored by any specific user. Useful for competitive analysis, influencer research, or building prospect profiles based on their X activity.

  • Get mentions and timelinePull tweets that mention a specific user or view the reverse-chronological timeline for the authenticated account. Stay on top of conversations without scrolling through the X feed manually.

  • Manage bookmarksView, add, and remove bookmarks on X. Your AI agent can bookmark relevant tweets for later review or organize saved content based on topics.

  • Create and delete tweetsPost new tweets or edit existing ones through your AI agent. Useful for scheduled posting, automated responses, or content distribution workflows. Delete tweets by ID when needed.

  • Search and look up usersFind X users by query and get authenticated user details. Pull profile information, follower counts, and account details for prospect research or audience analysis.

  • Get tweets by IDRetrieve specific tweets by their IDs (up to 100 at a time). Useful for analyzing specific conversations or tracking engagement on known tweets.

How to connect the Gumloop X (Twitter) MCP Server

Step 1: Create a free Gumloop account

Sign up at gumloop.com. No credit card required.

Step 2: Add the X (Twitter) MCP server

Copy your MCP server URL from Gumloop and add it to your preferred client (Claude, Cursor, or Gumloop workflows). You'll authorize on first use.

Step 3: Start using X (Twitter) in your AI workflows

That's it. Your AI agent can now search tweets, pull timelines, manage bookmarks, and post content on X (Twitter). Use it inside a Gumloop automation, in Claude Desktop, or in Cursor.

X (Twitter) MCP use cases

Social listening and brand monitoring

Set up a Gumloop workflow that searches X for mentions of your brand, product, or key terms on a schedule. An AI agent analyzes sentiment, categorizes mentions (support issues, feature requests, praise, complaints), and pushes a digest to Slack. You catch every relevant conversation without monitoring X manually.

Competitive intelligence

Pull recent tweets from competitor accounts, industry thought leaders, or target companies. Have an AI agent summarize their messaging, identify trending themes, and flag any announcements. Feed the analysis into a Google Sheet or Slack channel for your marketing team.

Sales prospecting with social signals

Search for tweets from people discussing problems your product solves. Pull their profile data, recent tweet history, and engagement patterns. Your AI agent drafts personalized outreach based on their specific tweets and adds them to your CRM via HubSpot or Salesforce MCP.

Content distribution and scheduling

Create and post tweets from Gumloop workflows. Have an AI agent repurpose blog posts, newsletters, or other content into tweet threads. Schedule distribution workflows that post at optimal times and track engagement metrics on previous posts.

Influencer identification and tracking

Search for users discussing relevant topics, pull their engagement metrics and follower counts, and have an AI agent score them against your influencer criteria. Build a prospect list of potential brand ambassadors or partnership targets, complete with their most relevant content.

Why use Gumloop for X (Twitter) MCP

  • No X API application or bearer token managementGetting X API access typically requires applying for a developer account, creating a project, generating bearer tokens, and managing OAuth 2.0 flows. Gumloop handles all of that. Connect your X account and start building workflows.

  • Works with multiple MCP clientsUse the X MCP server in Claude Desktop, Cursor, or directly inside Gumloop workflows. Same endpoint, multiple clients.

  • Chain X with 100+ other integrationsCombine X data with Slack, Google Sheets, HubSpot, Salesforce, and other MCP tools in a single workflow. Pull social data, process it with AI, and push insights wherever your team works.

  • Enterprise-grade and scalableSOC 2 compliant, built for teams, with role-based permissions and dedicated support. Works for solo creators and enterprise social media teams.

  • Free plan availableTest the X MCP integration on Gumloop’s free tier. Paid plans start at $37/month.

Frequently asked questions

What is X (Twitter) MCP?

X MCP (formerly Twitter MCP) is a Model Context Protocol server that gives AI agents access to the X platform. It provides functionality for searching tweets, pulling timelines, managing bookmarks, creating posts, and looking up users through a standardized endpoint that works with MCP clients like Claude, Cursor, and Gumloop.

Is X MCP free to use?

Gumloop has a free plan that includes access to MCP integrations, including X. Each action uses credits (typically 5 per item for read operations, 10 for posting). Paid plans start at $37/month with higher limits.

Do I need an X API developer account?

No. Gumloop handles authentication for you. You don’t need to apply for X API access, create a developer project, or manage bearer tokens. Connect your X account through Gumloop and you’re set.

What AI clients work with the Gumloop X MCP server?

Any MCP client that supports the Model Context Protocol. That includes Claude Desktop, Cursor, and Gumloop’s built-in workflow builder.

Can I post tweets through the MCP server?

Yes. The X MCP server supports creating new tweets, editing existing ones, and deleting tweets. Your AI agent can draft and post content as part of automated workflows.

Can I combine X MCP with other integrations?

Yes. With AI agents in Gumloop, you can chain X with any other MCP integration. Pull tweets, analyze them with AI, push insights to Slack, sync prospect data to your CRM, or save research to Google Sheets.

Can I search historical tweets?

Yes. The search endpoint supports both recent tweets and an all-time search option. You can find tweets by keyword, hashtag, from a specific user, or matching complex search queries.

Related MCP servers