Social

X MCP Server

Connect your account, then chat with AI to run tools.

X (formerly Twitter) provides a social media platform for users to share and discover content, engage with others, and follow real-time events. X API v2 offers access to tweets, users, spaces, direct messages, lists, bookmarks, and more.

41 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for X — workflow patterns, data models, and gotchas for your AI agent.

X (Twitter) — Full-Archive Access

X API v2 with full tweet archive search covering the complete history of public tweets. Search, analyse, and engage with tweets, users, and conversations at scale.

Authentication

Connect via OAuth 2.0 (PKCE) to read AND write (post tweets, like, retweet, follow, bookmark). Full-archive tweet search is available to all users automatically — it uses a platform-managed token and does not require any additional setup.

Data Model

  • Users: Profile lookup by username or numeric ID; user search; follower/following graphs. Fields: id (numeric string), username (handle), name (display), description (bio), public_metrics (followers, following, tweet count), url, location, verified.
  • Tweets: Full-archive search; single-tweet lookup; per-user timelines, mentions, liked tweets; engagement analytics; conversation threads. Fields: text (always full — long tweets auto-promoted from note_tweet), public_metrics (likes, retweets, replies, quotes, bookmarks, impressions), entities (expanded URLs, mentions, hashtags), referenced_tweets (RT/quote/reply linkage), conversation_id (thread grouping).
  • Lists: Membership for any user; list metadata, members, and list timelines.
  • Bookmarks, Blocked, Muted: Private to the authenticated user (requires OAuth).

IDs and References

  • All IDs are numeric strings (e.g. "1561506468"). Never pass as integers.
  • Tweet URLs: https://x.com/{username}/status/{tweet_id}.
  • Conversation threads share a conversation_id equal to the root tweet's ID.

Full-Archive Search

Search accesses the complete tweet archive — every public tweet ever posted, not just the last 7 days. Use start_time and end_time (ISO 8601) to scope to any historical period.

Query Operators (combine freely)

Content matching:

  • keyword1 keyword2 — AND (both must appear)
  • "exact phrase" — exact match
  • keyword1 OR keyword2 — OR
  • -keyword — NOT (exclude)

Author/mention:

  • from:username — tweets by author
  • to:username — replies to user
  • @mention — tweets mentioning user

Content type:

  • has:media / has:images / has:videos — media filters
  • has:links — tweets with URLs
  • has:hashtags / has:mentions

Tweet type (critical for clean results):

  • -is:retweet — exclude retweets (always recommended)
  • -is:reply — exclude replies
  • is:verified — verified authors only
  • is:quote — only quote tweets

Language:

  • lang:en / lang:es / lang:ja / lang:de / lang:fr

Conversation:

  • conversation_id:123 — all tweets in a thread

Geography:

  • place_country:US — tweets geotagged in country
Example Queries

Research a company or product: TrueLayer -is:retweet lang:en

Find pricing/cost discussions: TrueLayer (price OR pricing OR cost OR fee OR expensive) -is:retweet lang:en

Monitor competitors: (from:stripe OR from:truelayer OR from:plaid) -is:retweet

Developer experience: "TrueLayer API" (integrate OR integration OR SDK OR developer) -is:retweet

Hiring signals: from:truelayer (hiring OR "we're looking" OR "join us") -is:retweet

Date Filtering

Use start_time and end_time parameters (ISO 8601 format):

  • start_time: "2024-01-01T00:00:00Z" — from this date
  • end_time: "2025-12-31T23:59:59Z" — up to this date
  • Omit both for default (most recent results across full archive)
Sort Order
  • recency (default) — newest first, best for monitoring
  • relevancy — most relevant first, best for topic research

Engagement Metrics

Every tweet includes public_metrics:

  • impression_count — total views
  • like_count, retweet_count, reply_count, quote_count, bookmark_count
  • Engagement rate = (likes + replies + retweets) / impressions

Research Workflows

Deep topic research:

  1. Search full archive for topic with broad query and date range
  2. Iterate with narrower queries based on initial findings
  3. Use max_results=100 and pagination (next_token) for full coverage
  4. Identify key voices by examining author profiles in results

Competitive intelligence:

  1. Monitor multiple accounts with batch monitor tool
  2. Search for brand mentions and sentiment across full history
  3. Compare engagement metrics across competitors
  4. Track narrative shifts over time with date-bounded searches

Account analysis:

  1. Fetch user profile for follower/following metrics
  2. Get recent tweets (exclude retweets) for content analysis
  3. Run engagement analytics for performance overview
  4. Review liked tweets for interest and partnership signals

Thread deep-dive:

  1. Find interesting tweet via search
  2. Use its conversation_id to fetch the full thread
  3. Read all replies for context and community sentiment

Pagination

Paged results return next_token; pass it on the next call to get more results. Page sizes: 10-100. For thorough research, paginate through multiple pages.

Rate Limits

X enforces per-endpoint burst limits (typically 300 requests/15 minutes for search). When throttled, back off and retry after the 15-minute window resets.

Tools in this Server (41)

X Add Bookmark

Bookmark a tweet. Bookmarked tweets are saved privately and can be retrieved later with x_get_bookmarks. Idempotent — bookmarking an already-bookmarke...

X Block User

Block a user. Blocked users cannot see your tweets, follow you, or send you direct messages. Also removes them as a follower.

X Create Tweet

Post a new tweet. Can also create replies (reply_to_tweet_id) and quote tweets (quote_tweet_id). Returns the created tweet's ID and text.

X Delete Tweet

Permanently delete a tweet you own. Cannot be undone — all engagement data (likes, retweets, replies) is lost.

X Engagement Analytics

Compute engagement analytics across your recent tweets. Returns aggregate stats (avg impressions, avg likes, avg replies, avg bookmarks, engagement ra...

X Fetch Tweet

Fetch a single tweet by its numeric ID. Returns the full tweet including text, author profile (display name, bio, website URL, location, followers), e...

X Fetch User

Fetch a user profile by numeric ID. Returns username, display name, bio, website URL (profile link — often their company domain), location (geography)...

X Fetch User By Username

Fetch a user profile by their @username (e.g. 'elonmusk'). Returns the user's numeric ID, display name, bio, website URL (profile link), location, fol...

X Follow User

Follow a user. Their tweets will appear in your home timeline. Idempotent — following someone you already follow is a no-op.

X Get Blocked Users

Get your list of blocked users. Returns user profiles with username, display name, bio, and follower counts.

X Get Bookmarks

Get the authenticated user's bookmarked tweets. Returns up to 800 most recent bookmarks with full text, inline author profiles (bio, website URL, loca...

X Get Followers

Get a user's followers. Returns up to 1000 user profiles per page with username, display name, bio, website URL, location, follower count, and verific...

X Get Following

Get users that a specific user follows. Returns up to 1000 user profiles per page with username, display name, bio, website URL, location, follower co...

X Get List

Look up a list by its numeric ID. Returns list name, description, member count, follower count, owner ID, creation date, and privacy status. Use this ...

X Get List Members

Get members of a list. Returns user profiles with username, display name, bio, website URL, location, follower count, and verification status. Curated...

X Get List Tweets

Get recent tweets from a list. Returns tweets with full text, inline author profiles (bio, website URL, location, followers), engagement metrics, enti...

X Get Me

Get the authenticated user's own profile. Returns your user ID, username, display name, bio, website URL, location, follower/following counts, tweet c...

X Get Muted Users

Get your list of muted users. Returns user profiles with username, display name, bio, and follower counts.

X Get Thread

Fetch a full conversation thread. Given a conversation_id (shared by all tweets in a thread, equal to the root tweet's ID), returns the complete threa...

X Get Tweet Likes

Get the users who liked a specific tweet. Returns user profiles with username, display name, bio, website URL, location, follower count, and verificat...

X Get Tweet Quotes

Get tweets that quote a specific tweet. Returns the quoting tweets with full text, inline author profiles (bio, website, location, followers), engagem...

X Get Tweet Retweets

Get the users who retweeted a specific tweet. Returns user profiles with username, display name, bio, website URL, location, follower count, and verif...

X Get User Liked Tweets

Get tweets that a user has liked. Returns the liked tweets with full text, inline author profiles (bio, website, location, followers), engagement metr...

X Get User List Memberships

Get all lists a user is a member of. Returns list name, description, member count, follower count, owner, and privacy status. Reveals what curated com...

X Get User Mentions

Get tweets that @mention a user. Returns tweets from other users that mention the specified user, with full text, inline author profiles (bio, website...

X Get User Timeline

Get the authenticated user's home timeline — the reverse-chronological feed of tweets from accounts they follow. The user_id must be the authenticated...

X Get User Tweets

Get tweets posted by a user (their authored tweets). Returns tweets in reverse-chronological order with text, timestamps, engagement metrics, entities...

X Hide Tweet

Hide or unhide a reply to one of your tweets. Hidden replies are collapsed in the thread and require an extra click to view.

X Like Tweet

Like a tweet as the authenticated user. Idempotent — liking an already-liked tweet is a no-op.

X List Tweets

Search the full tweet archive. This is an alias for x_search_tweets. Pass a 'query' parameter using X API v2 query operators: 'from:username' (author)...

X Monitor Accounts

Batch-fetch recent tweets from multiple accounts in a single API call. Pass a list of usernames and get their combined recent tweets sorted by recency...

X Mute User

Mute a user. Muted users' tweets will not appear in your home timeline or notifications, but they can still follow you and see your tweets (unlike blo...

X Remove Bookmark

Remove a tweet from your bookmarks. Idempotent — removing a tweet that isn't bookmarked is a no-op.

X Retweet

Retweet a tweet as the authenticated user. The retweet appears on your profile and in your followers' timelines.

X Search Tweets

Search the full tweet archive (all of Twitter/X history) using X API v2 query operators. Combine operators like 'from:username lang:en -is:retweet has...

X Search Users

Search for X users by keyword. Matches usernames, display names, and bios. Returns user profiles with numeric ID, username, display name, bio, website...

X Unblock User

Unblock a user. They will be able to see your tweets and follow you again.

X Unfollow User

Unfollow a user. Their tweets will no longer appear in your home timeline.

X Unlike Tweet

Remove your like from a tweet. Idempotent — unliking a tweet you haven't liked is a no-op.

X Unmute User

Unmute a user. Their tweets will appear in your home timeline again.

X Unretweet

Remove your retweet of a tweet. The retweet disappears from your profile.

Frequently Asked Questions

What is the X MCP server?

X (formerly Twitter) provides a social media platform for users to share and discover content, engage with others, and follow real-time events. X API v2 offers access to tweets, users, spaces, direct messages, lists, bookmarks, and more. It provides 41 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect X to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/x. Authentication is handled automatically.

How many tools does X provide?

X provides 41 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does X require?

X uses One-click sign in. X requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect X to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/x

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Related MCP Servers

More social integrations you might like

Ayrshare

Ayrshare is a full-featured social media management API that enables posting, scheduling, and analyt...

34 tools
Social
Blogger

Blogger is Google's free blog-publishing platform. Create, edit, search, and manage blog posts and p...

10 tools
Social
Dev.to

Dev.to is a community of software developers sharing articles, tutorials, and discussions. Publish b...

16 tools
Social
Hacker News

Complete Hacker News toolkit. Browse live ranked lists (top, best, new, Show HN, Ask HN, jobs), sear...

10 tools
Social
Hashnode

Hashnode is a blogging platform for developers. Publish articles, manage drafts, search posts, brows...

14 tools
Social
LinkedIn

LinkedIn API. Manage company pages, post content, engage with comments and reactions, run ad campaig...

34 tools
Social

Ready to use X?

Sign in to connect your credentials and start running tools from the chat.

X MCP Server & Skill — 41 Tools