# X (Twitter) MCP

> X (Twitter) OAuth MCP provides full read and write access to your account directly from any AI agent. Post tweets, track every mention, pull follower lists, or delete old content—all without opening X. This connector gives you total control over publishing, analytics, and engagement management right where you're building your applications.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** social-listening, tweet-management, engagement-metrics, content-creation, profile-metadata, timeline-browsing, mention-tracking, trend-analysis

## Description

Connecting your X (Twitter) account through this MCP means you can manage your entire presence from inside your usual development environment. You don't need to switch tabs or copy/paste data anymore. Your agent can automatically find discussions about you, track which accounts are following competitors, and even post updates when a specific event happens.

For example, instead of spending time manually sifting through mentions or running searches for trends, your AI client does the heavy lifting. You can ask it to pull detailed stats on any tweet by ID, check who liked content from last week, or follow an account and then immediately retweet their key message. Everything is consolidated here, making Vinkius the go-to spot for connecting complex social accounts.

## Tools

### get_user_liked_tweets
Retrieves all the tweets a specific user has liked by number ID.

### delete_tweet
Removes one of your own published tweets from X (Twitter).

### follow_user
Makes the authenticated account follow another user.

### get_my_profile
Gets a summary of your own profile, including follower count and bio.

### get_tweet_details
Pulls the full text and engagement metrics for one specific tweet by its ID.

### get_tweet_volume
Calculates how many tweets matching a search query appeared over the last seven days, broken down hourly or daily.

### get_user_followers
Gets up to 50 profiles of users who follow a specific account.

### like_tweet
Adds or removes your like from any given tweet.

### get_user_mentions
Retrieves recent tweets that specifically mention a target user's profile.

### get_user_timeline
Fetches the most recent original posts made by a specific user, excluding replies or retweets.

### post_tweet
Publishes brand-new content to X (Twitter) from your account. You can optionally reply to an existing tweet ID.

### retweet
Amplify a message by retweeting a specific piece of content.

### search_recent_tweets
Searches for public tweets using keywords, hashtags, or handles within the last seven days.

### unfollow_user
Stops the authenticated account from following another user.

### unlike_tweet
Removes your like from a specific tweet.

### lookup_user_by_username
Fetches the full profile details for any user using only their @username.

## Prompt Examples

**Prompt:** 
```
Post a tweet saying 'Just shipped our new AI integration — try it now!'
```

**Response:** 
```
Done! Tweet posted successfully with ID 1234567890. Your followers can now see it. Want me to check the engagement metrics in a few minutes?
```

**Prompt:** 
```
Show me my latest mentions and like any positive ones.
```

**Response:** 
```
You have 5 recent mentions. 3 are positive — I've liked all three. One is a question about pricing and another is neutral feedback. Want me to reply to the pricing question?
```

**Prompt:** 
```
Follow @openai and check their latest tweets.
```

**Response:** 
```
Done — now following @openai (ID: 4398626122). Their latest tweets discuss GPT-5 benchmarks and a new safety paper. Want me to retweet any of them?
```

## Capabilities

### Monitor mentions and conversations
Retrieve all recent public tweets that mention a specific user or profile.

### Publish content and reply to threads
Create new tweets, reply to existing posts, or amplify content by retweeting messages.

### Audit profiles and connections
Get a user's full profile metadata, check their follower list, or see which accounts they follow.

### Track specific content metrics
Pull exact engagement stats for any tweet by ID, or find out how many tweets match a query over the last seven days.

### Manage user actions and deletes
Like or unlike posts, follow new accounts, unfollow others, or delete your own published content.

## Use Cases

### Crisis response and reputation management
A PR specialist detects negative sentiment. They ask their agent to use `get_user_mentions` first, identify the problematic tweets, draft a formal reply using `post_tweet`, and then flag it for human review before sending.

### Competitor content auditing
A growth team needs to know what their top three competitors are talking about. They use `lookup_user_by_username` on each, pull the last 10 tweets via `get_user_timeline`, and then run `search_recent_tweets` for common industry keywords.

### Personal brand curation
A creator wants to make sure they're following key thought leaders. They ask the agent to use `follow_user` on a list of target accounts and then run `get_my_profile` to confirm their own follower count increased.

### Tracking content performance
A marketing team launched a campaign tweet. They immediately ask the agent to use `get_tweet_details` on that specific ID and also run `get_tweet_volume` for related keywords to see if the discussion spiked.

## Benefits

- Stop manually checking mentions. Use the `get_user_mentions` tool to pull all conversations about you, letting your agent triage them instantly.
- Audit accounts at scale. You can use `lookup_user_by_username` to get full profile details on anyone, and then run `get_user_followers` to map out their connections.
- Control your brand narrative. With tools like `post_tweet` and `retweet`, you can publish updates or amplify partner content without leaving your workspace.
- Build deep analytics. Don't just look at counts; use `get_tweet_volume` to spot when specific topics spike in discussion over a 7-day period.
- Clean up old data effortlessly. Need to remove an old tweet? Use `delete_tweet`. Want to correct a mistake? You can even run `unlike_tweet`.

## How It Works

The bottom line is that Vinkius handles all the messy token refresh and security stuff; you just focus on telling your agent what action you need performed.

1. First, subscribe to this MCP in the Vinkius catalog and input your X Developer App Client ID and Secret.
2. Next, click 'Connect' and authorize access via the popup window. This establishes the secure OAuth 2.0 connection.
3. Your AI client now sees the full toolset, allowing you to call functions like `search_recent_tweets` or `get_user_timeline` directly from your prompt.

## Frequently Asked Questions

**How do I find out who a user is without knowing their ID using get_user_mentions?**
You first run `lookup_user_by_username` to fetch the target user's numeric ID. The mention tracking tools require this specific ID as input.

**Can I use post_tweet to reply to an old tweet?**
Yes, you can. When calling `post_tweet`, just pass the specific Tweet ID of the content you want to respond to in the optional ID parameter.

**Does get_user_timeline only show original posts?**
That's correct. The `get_user_timeline` tool specifically fetches only the user's original tweets, filtering out retweets and replies to keep the feed clean.

**What is the limit on how many followers I can retrieve with get_user_followers?**
The `get_user_followers` tool retrieves up to 50 followers in a single call. You may need multiple calls if you need more than that.

**How do I use the get_tweet_details tool to check a post's performance?**
It retrieves both the text content and all engagement metrics for a specific Tweet ID. You simply pass in the numeric ID of the tweet you want details on.

**What information does get_my_profile return about my account?**
It provides your own account details, including your full name, bio text, follower count, and unique numeric ID. This is helpful for linking other tools correctly.

**Can I use delete_tweet to remove content from X (Twitter)?**
Yes, you can delete tweets using this tool. Keep in mind that it only allows deleting posts written by the authenticated account.

**How does search_recent_tweets function for finding trending topics?**
You provide a simple search query string. The tool finds all recent public tweets matching your specified keywords, hashtags, or handles within the last seven days.

**Can I post tweets and reply to mentions directly from my AI agent?**
Yes. This server gives your agent full write access through OAuth 2.0. Just say 'post a tweet saying...' or 'reply to tweet ID 123 with...' and the agent handles the rest. You can also like, retweet, follow, and unfollow through natural conversation.

**How does the OAuth 2.0 connection work?**
After entering your Client ID and Client Secret from the X Developer Portal, click the 'Connect' button. A popup opens for you to authorize the app on X. Once approved, tokens are securely stored and automatically refreshed — no manual token management needed.

**What's the difference between this and the read-only X (Twitter) server?**
The read-only version uses a Bearer Token and can only search tweets, look up profiles, and analyze volume. This OAuth version connects to your personal account and adds 7 write tools (post, delete, like, unlike, follow, unfollow, retweet) plus access to private endpoints like timelines and mentions.