# X (Twitter) OAuth MCP for AI Agents AI Agent Connect > X (Twitter) OAuth MCP gives your AI agent full read and write access to your X account. You can post tweets, like content, follow users, and track mentions in real-time. It connects your profile to any MCP-compatible client so you can handle your social media presence without switching tabs. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect - **Tags:** social-listening, tweet-management, engagement-metrics, content-creation, profile-metadata, timeline-browsing, mention-tracking, trend-analysis ## Description Managing a social brand usually means jumping between tabs, copy-pasting text, and constantly refreshing feeds to see who is talking. This Connector changes that by letting your agent handle the heavy lifting. Instead of manually checking mentions or drafting replies, you can ask your agent to monitor specific handles, summarize recent discussions, or post updates on the fly. If you are trying to keep up with a growing community, you can have your agent pull follower lists or check who is liking your content to see what is actually resonating. It handles the OAuth 2.0 handshake and token refreshes behind the scenes, so you just get to focus on the content. You will find it is a lot easier to stay consistent when your agent can actually execute actions like following strategic accounts or deleting old posts. This is one of the reasons people choose the Vinkius catalog; it makes connecting these types of social tools feel like a native part of your workflow rather than a chore. You get a direct line of communication between your agent and your X feed, making it way easier to stay on top of trends without the constant context switching. ## Tools ### get_user_followers Fetch up to 50 followers for a specific user. Use this to see who is following your competitors or partners. ### get_my_profile Get your own profile details like your bio and follower count. It is the first step to getting your own user ID. ### get_tweet_details Get the text and engagement metrics for a specific tweet. Use this to see how well a post is performing. ### get_tweet_volume Show how many tweets match a query over the last 7 days. It is great for spotting trending spikes in specific topics. ### like_tweet Like a tweet from your account. Your agent can use this to engage with positive mentions. ### get_user_liked_tweets Get the list of tweets a specific user has liked. This helps you see what content a target account enjoys. ### delete_tweet Remove a tweet from your own account. Use this to clean up mistakes or outdated posts quickly. ### follow_user Follow another user from your account. This helps your agent build out your network automatically. ### get_user_mentions Pull recent tweets where a specific user is mentioned. This is how you monitor what people are saying about you. ### get_user_timeline Fetch a user's original tweets while skipping retweets and replies. It is the best way to see a user's primary content. ### post_tweet Publish a new tweet or a reply to an existing one. This is the primary way to share updates with your audience. ### retweet Share someone else's content to your own feed. Use this to amplify important news or partner content. ### search_recent_tweets Search for public tweets from the last 7 days. It helps your agent find new discussions on specific hashtags. ### unfollow_user Remove a user from your following list. Use this to keep your feed clean of irrelevant accounts. ### unlike_tweet Remove a like from a previous tweet. This helps you manage your engagement history. ### lookup_user_by_username Fetch full profile details for any public user. It is the best way to get a numeric ID from a handle. ## Prompt Examples **Prompt:** ``` Check our mentions from the last hour and tell me if anyone is upset. ``` **Response:** ``` I've scanned the recent mentions for your account. Here is the summary: **Recent Mentions:** - @user1: 'The new update is a bit slow.' (Neutral) - @user2: 'I love the new UI!' (Positive) - @user3: 'Why is the login button broken?' (Negative/Urgent) **Summary:** You have 3 new mentions. One user is reporting a login issue that needs attention, while the rest are generally positive or neutral. ``` **Prompt:** ``` Who are the top followers of @competitor_handle? ``` **Response:** ``` I've looked up the profile for @competitor_handle and pulled their recent followers: | Username | Bio | Follower Count | | :--- | :--- | :--- | | @tech_guru | Tech reviewer | 12.5k | | @dev_daily | Daily coding tips | 8.2k | | @startup_hub | VC news | 5.1k | It looks like their audience is heavily skewed toward tech reviewers and developers. ``` **Prompt:** ``` Post a tweet saying we're live! ``` **Response:** ``` Done! I've posted the following tweet: **"We're live! Come check out the new features now."** Tweet ID: 1723456789012. Your followers can see it now. ``` ## Capabilities ### Post and reply to tweets Your agent can publish new updates or respond to existing conversations on your behalf. ### Monitor real-time mentions Get notified and summarized when people talk about your brand or handle. ### Track follower growth See who is following your account and how your audience is expanding. ### Analyze tweet volume trends Identify spikes in conversation volume to spot what topics are trending. ### Manage likes and follows Have your agent engage with content by liking posts or following new accounts. ### Fetch user profile metadata Get detailed information about any public profile by their username. ## Use Cases ### Monitoring brand sentiment A community manager asks their agent to check for mentions of a new product launch and summarize the general mood of the conversation using get_user_mentions. ### Competitor audience auditing A growth lead uses lookup_user_by_username and get_user_followers to see which accounts are driving the most engagement for a rival brand. ### Automated status updates A founder asks their agent to post a quick update about a shipping delay using post_tweet to keep their followers informed in real-time. ### Trend identification A content creator uses get_tweet_volume to see if a specific hashtag is gaining traction before they decide to write a new thread. ## Benefits - Get real-time mention tracking with get_user_mentions so you never miss a fan interaction. - Monitor content trends using get_tweet_volume to see what topics are spiking right now. - Manage your network at scale by using follow_user and unfollow_user to curate your feed. - Audit competitor engagement by pulling their follower lists with get_user_followers. - Automate your content distribution by using post_tweet and retweet to keep your feed active. - Keep your profile data current by using get_my_profile to check your stats and bio. ## How It Works The bottom line is you get a direct bridge between your agent and your X account. 1. Subscribe to the Connector on Vinkius. 2. Enter your X Developer App Client ID and Client Secret. 3. Click Connect and authorize the connection in the popup. ## Frequently Asked Questions **Can I use X (Twitter) OAuth to post tweets automatically?** Yes. This Connector lets your agent post new tweets or replies directly to your account, making it easy to share updates without manual typing. **How do I track mentions of my brand using X (Twitter) OAuth?** The Connector can monitor your mentions in real-time. Your agent can pull these mentions and summarize them so you know what people are saying about you. **Can my AI agent follow people for me with X (Twitter) OAuth?** Yes. You can instruct your agent to follow specific accounts or unfollow others to help curate your feed and stay connected to the right people. **Is X (Twitter) OAuth good for monitoring social trends?** It is excellent for real-time trends. You can ask your agent to check tweet volumes for specific keywords to see what is spiking right now. **Can I use X (Twitter) OAuth to see who liked my posts?** Yes. Your agent can retrieve the list of tweets a specific user has liked, which helps you understand what content is resonating with your audience. **How do I connect my X account to my AI agent?** You just need to subscribe to the Connector on Vinkius and provide your X Developer App credentials. Vinkius handles the secure connection and token refreshing for you. **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.