X Twitter MCP Server (Node.js)

A Model Context Protocol (MCP) server that provides tools for interacting with Twitter/X API.

Installation

npx x-twitter-mcp

Or install globally:

npm install -g x-twitter-mcp

Setup

1. Create a Twitter/X Developer account and app at https://developer.twitter.com
2. Copy .env.example to .env and fill in your credentials:

cp .env.example .env

3. Edit .env with your Twitter API credentials:
   • TWITTER_API_KEY: Your API Key
   • TWITTER_API_SECRET: Your API Secret
   • TWITTER_ACCESS_TOKEN: Your Access Token
   • TWITTER_ACCESS_TOKEN_SECRET: Your Access Token Secret
   • TWITTER_BEARER_TOKEN: Your Bearer Token

Usage

Run the server:

npx x-twitter-mcp

The server provides the following tools:

User Management

• get_user_profile - Get detailed profile information for a user
• get_user_by_screen_name - Fetch a user by their username
• get_user_by_id - Fetch a user by their ID
• get_user_followers - Get a list of followers for a user
• get_user_following - Get users that a specific user is following

Tweet Management

• post_tweet - Post a new tweet with optional media, reply, and hashtags
• delete_tweet - Delete a tweet by ID
• get_tweet_details - Get detailed information about a specific tweet
• create_poll_tweet - Create a tweet with a poll
• favorite_tweet - Like a tweet
• unfavorite_tweet - Unlike a tweet
• bookmark_tweet - Add a tweet to bookmarks
• delete_bookmark - Remove a tweet from bookmarks

Timeline & Search

• get_timeline - Get tweets from your home timeline
• search_twitter - Search Twitter with a query
• get_trends - Get trending topics
• get_user_mentions - Get tweets mentioning a specific user

Rate Limiting

The server includes built-in rate limiting to comply with Twitter API limits:

• Tweet actions: 300 per 15 minutes
• DM actions: 1000 per 15 minutes
• Follow actions: 400 per 24 hours
• Like actions: 1000 per 24 hours

License

MIT