postTweetLABSCO SUMMARY
A full X client, gated by X's own pricing.
The tool surface is broad — write, read, lists, follower graphs — and what you can actually run is set by the API tier you are on, which the server reports rather than hides.
What it is
An X (Twitter) API client covering the write path as well as the read one: posting and replying, searching and reading timelines, follower and following lists, and list curation. An optional SocialData.tools key adds research tools that work without X's higher API tiers.
What you get
- Tweets posted, replied to, liked and deleted from the conversation you are already in
- Search across tweets, a specific tweet fetched by id, and its retweets
- A user's profile, timeline, followers, following and liked tweets
- Lists created, members added, list members read back, and the lists a user belongs to
- Hashtag analytics, for the question of whether a tag is actually moving
- Workflow prompts and live API documentation exposed alongside the tools, so the client can see current status
Requirements
X API credentials — key, secret, access token and access token secret — on the Basic tier or above, which X sells as a paid monthly plan. A SocialData.tools key is optional and enables the research tools without an X Pro tier. Node.js 18 or higher and a local build.
Setup effort
Build from source — git clone https://github.com/crazyrabbitLTC/mcp-twitter-server.git
USE CASES
01
Publishing without leaving the draft
The post goes out from the same conversation it was written in, and replies thread from there.
02
Researching what is being said about a topic
Search the conversation and check whether the hashtag around it is actually moving.
03
Understanding an account before engaging with it
Profile, recent timeline and follower picture together, rather than three tabs.
04
Curating a list of people worth following
Create the list, add the accounts as you find them, and read the membership back.
05
Cleaning up after a post that went wrong
Fetch the tweet to confirm which one it is, then delete it.
38 tools
Listed in project docs. Your client may show a different list.
getTweetByIdreplyToTweetdeleteTweetlikeTweetunlikeTweetretweetundoRetweetgetRetweetsgetUserInfogetUserTimelinefollowUserunfollowUsergetFollowersgetFollowingcreateListgetUserListsaddUserToListremoveUserFromListgetListMemberssearchTweetsgetHashtagAnalyticsgetLikedTweetsadvancedTweetSearchhistoricalTweetSearchtrendingTopicsSearchbulkUserProfilesuserGrowthAnalyticsuserInfluenceMetricsgetFullThreadgetConversationTreegetThreadMetricsfindMutualConnectionsanalyzeFollowerDemographicsmapInfluenceNetworkgetHashtagTrendsanalyzeSentimenttrackViralityBEFORE YOU INSTALL
What to know first
Tools you get
38 tools named in the project's documentation.
Requires
- Node.js 18+
- X_API_KEY in your environment
- X_API_SECRET in your environment
- X_ACCESS_TOKEN in your environment
- X_ACCESS_TOKEN_SECRET in your environment
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/crazyrabbitLTC/mcp-twitter-server.git
cd mcp-twitter-server
npm install
npm run buildPut your X API key, secret, access token and access token secret in the env block of the configuration below
MCP Clients
Cursor, Claude Desktop
JSON
{
"mcpServers": {
"x-twitter": {
"command": "node",
"args": [
"<YOUR_PATH_TO_MCP_TWITTER_SERVER>/dist/index.js"
],
"env": {
"X_API_KEY": "<YOUR_API_KEY>",
"X_API_SECRET": "<YOUR_API_SECRET>",
"X_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
"X_ACCESS_TOKEN_SECRET": "<YOUR_ACCESS_TOKEN_SECRET>"
}
}
}
}
