X(Twitter) V2 MCP Server
An MCP server implementation that provides tools for interacting with the Twitter/X API v2. This service allows AI assistants to retrieve tweets, post new content, reply to tweets, and quote tweets and more programmatically.
Tools
The X MCP Service provides the following tools for interacting with the Twitter/X API:
get_tweets_by_userid
Retrieves tweets from a specific user's timeline.
userId: The Twitter user ID to search for tweetspaginationToken (optional): Token for fetching the next page of resultsexclude (optional): Types of tweets to exclude (retweets, replies)maxResults (optional): Maximum number of tweets to return (default: 10)
get_tweet_by_id
Retrieves a single tweet by its ID.
tweetId: The ID of the tweet to retrieve
get_user_mentions
Retrieves tweets that mention a specific user.
userId: The Twitter user ID to get mentions forpaginationToken (optional): Token for fetching the next page of resultsmaxResults (optional): Maximum number of mentions to return (default: 10)
quote_tweet
Creates a quote tweet with custom text.
tweetId: The ID of the tweet to quotereplyText: The text to include with the quote
reply_to_tweet
Replies to an existing tweet.
tweetId: The ID of the tweet to reply toreplyText: The text content of the reply
post_tweet
Post a new tweet.
text: The content that you want to post.imageBase64: Image that you want to post.
like_tweet
Like a specific tweet.
tweetId: The ID of the tweet to like
follow_user
Follow a Twitter user.
targetUserId: The ID of the user to follow
unfollow_user
Unfollow a Twitter user.
targetUserId: The ID of the user to unfollow
get_user_by_username
Get information about a Twitter user by their username.
username: The Twitter username (without @ symbol)
search_tweets
Search for tweets using a query string.
query: The search querymaxResults (optional): Maximum number of results to return (default: 10)
get_trending_topics
Get trending topics for a specific location.
woeid (optional): The 'Where On Earth ID' (WOEID) for the location (1 for worldwide, default: 1)
create_list
Create a new Twitter list.
name: The name of the listdescription (optional): Optional description for the listisPrivate (optional): Whether the list should be private (default: false)
add_list_member
Add a user to a Twitter list.
listId: The ID of the listuserId: The ID of the user to add
remove_list_member
Remove a user from a Twitter list.
listId: The ID of the listuserId: The ID of the user to remove
get_owned_lists
Get all lists owned by the authenticated user.
Configuration
Env Configuration
X API Authentication
You can get all of the token below via X Developer Dashboard
TWITTER_API_KEY=your_api_key
TWITTER_API_KEY_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret
Development
npm i
npm run build
npx @modelcontextprotocol/inspector node dist/index.js
Open http://127.0.0.1:6274 set up env, and interact with the tools.
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
