# X (Twitter) MCP for AI Agents AI Agent Connect

> X (Twitter) MCP lets your AI agent search recent tweets, analyze engagement metrics, and pull profile data across the platform. It turns your agent into a social listening tool that can spot trends, audit influencers, and track brand sentiment in real-time without you having to manually scrape any data.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect
- **Tags:** social-listening, sentiment-analysis, engagement-metrics, content-discovery, profile-metadata, trend-analysis

## Description

Managing a social presence or tracking what people are saying about your brand usually involves a lot of manual digging. You're constantly jumping between tabs, copy-pasting tweet text into spreadsheets, and trying to figure out if a sudden spike in mentions is a PR crisis or a viral moment. This Connector changes that by giving your AI client direct access to the X timeline. Instead of you doing the heavy lifting, you can just ask your agent to find out what people are saying about a specific keyword or competitor. It pulls in the actual content, shows you how many likes and retweets a post is getting, and even lets you see the history of how often a topic is being discussed over time. It's built for people who need to move faster on social intelligence. Whether you're looking for a specific user's follower count or trying to see how a hashtag is performing over the last week, the agent handles the data retrieval so you can focus on the strategy. It's one of the reasons why the Vinkius catalog is so popular for people who need to connect their AI tools to real-world data. You get a clear picture of the conversation without the headache of dealing with raw API endpoints or messy web scraping.

## Tools

### get_tweet_details
Get the text and engagement metrics for a specific tweet ID. This helps you see exactly how people are reacting to a post.

### get_tweet_volume
See how many tweets match a query over the last 7 days. It's perfect for spotting sudden spikes in brand mentions.

### get_tweets_batch
Pull text and metrics for up to 100 tweets at once. This saves time when you need to analyze a large group of posts.

### lookup_users_batch
Fetch profile details for up to 100 X handles in one go. Use this to quickly compare multiple influencers or competitors.

### search_recent_tweets
Find public tweets from the last 7 days using keywords or hashtags. It lets your agent scan the live timeline for specific topics.

### lookup_user_by_username
Get the bio, follower count, and location for a specific X handle. This provides a quick snapshot of any profile's reach.

## Prompt Examples

**Prompt:** 
```
Search for tweets about 'Vinkius Cloud' from the last 3 days.
```

**Response:** 
```
I found 12 recent tweets. Most people are talking about the new UI, with 3 users specifically mentioning how much faster the dashboard feels. 

**Summary of Sentiment:**
- **Positive:** 8 mentions (UI speed, ease of use)
- **Neutral:** 3 mentions (General inquiries)
- **Negative:** 1 mention (Latency issue)
```

**Prompt:** 
```
Look up the profile for @tech_guru and tell me their follower count.
```

**Response:** 
```
Profile found: **@tech_guru**
- **Followers:** 1.2M
- **Location:** San Francisco
- **Bio:** "Specializing in AI automation and future tech."

Would you like me to see their recent tweets too?
```

**Prompt:** 
```
Check the engagement on tweet ID 987654321.
```

**Response:** 
```
The tweet has the following engagement metrics:

| Metric | Count |
| :--- | :--- |
| **Likes** | 12,400 |
| **Retweets** | 3,100 |
| **Replies** | 450 |

The engagement rate is quite high for a post of this size.
```

## Capabilities

### Search recent tweets
Find public discussions from the last 7 days using keywords, hashtags, or handles.

### Fetch profile data
Get follower counts, bios, and locations for specific X handles.

### Analyze engagement
See likes, retweets, and impressions for any specific tweet ID.

### Track volume spikes
View time-series data to see when a topic starts trending over time.

### Batch process lookups
Pull data for up to 100 users or tweets in a single request.

## Use Cases

### Competitor Analysis
A product manager asks the agent to find recent tweets about a rival's new feature and summarize user complaints using search_recent_tweets.

### PR Crisis Management
A founder uses the tool to check for spikes in brand mentions to see if a news story is gaining traction using get_tweet_volume.

### Influencer Outreach
A marketing lead asks the agent to pull follower counts and bios for 50 different creators to build a target list using lookup_users_batch.

### Trend Hunting
A content creator searches for trending hashtags over the last 48 hours to find new topics for their next video.

## Benefits

- Stop manual scraping: Use search_recent_tweets to get live data without ever leaving your chat interface.
- Faster influencer audits: Use lookup_users_batch to check the reach of dozens of accounts in seconds.
- Real-time trend spotting: Use get_tweet_volume to see exactly when a topic starts blowing up.
- Bulk data analysis: Use get_tweets_batch to gather large amounts of content for your agent to summarize.
- Detailed sentiment tracking: Use get_tweet_details to see the specific engagement numbers behind every post.

## How It Works

The bottom line is that your AI agent becomes a live social listening tool that feeds you real-time X data on demand.

1. Subscribe to this Connector and get your X Developer Bearer Token ready.
2. Plug the token into your AI client's configuration.
3. Ask your agent to find tweets, check profiles, or analyze trends.

## Frequently Asked Questions

**Can the X (Twitter) MCP help me track my brand mentions?**
Yes, it lets your agent search for specific keywords or hashtags from the last 7 days to see what people are saying about you.

**How does the X (Twitter) MCP handle influencer research?**
You can ask your agent to pull profile details, like follower counts and bios, for multiple accounts at once to see who has the most reach.

**Can I use the X (Twitter) MCP to see if a topic is trending?**
Yes, it can pull tweet volume data over time, which helps you identify specific spikes in conversation or brand mentions.

**Does the X (Twitter) MCP work for sentiment analysis?**
It provides the raw tweet text and engagement metrics, which your AI client can then analyze to tell you if the vibe is positive or negative.

**Can I get data for multiple tweets at once with the X (Twitter) MCP?**
Yes, you can pull the content and metrics for up to 100 tweets in a single request, making it much faster to analyze large batches of posts.

**Is the X (Twitter) MCP good for competitor research?**
It's great for this because you can quickly search for mentions of a competitor's product and have your agent summarize the common complaints or praise.

**Can my AI search for tweets containing a specific competitor's hashtag?**
Yes. Ask the agent to run a recent search tool utilizing your query (e.g., '#competitor'). It will grab the last 10 matching tweets within seconds, giving you raw sentiment and user commentary without opening the app.

**How far back in time can the agent search for tweets?**
The tool uses the standard v2 API limited to Recent Searches. This means the agent can perfectly fetch any matching tweets published in the last 7 days. It is optimized for reactive, fast-paced monitoring workflows.

**Can it show me how many followers a user has or where they are located?**
Absolutely. Providing the agent with the user's handle will invoke the lookup tool. It returns exactly what the developer sees: follower metrics, account description, and geographic location if public.