Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@X (Twitter) MCPPost a tweet saying 'Hello world from my new MCP integration!'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
X (Twitter) MCP
A simple Model Context Protocol server for Twitter/X. Post tweets, threads, and get metrics.
Features
Tool | Description |
| Verify auth, get your profile info |
| Post a single tweet (max 280 chars) |
| Post a thread (separate tweets with |
| Get tweet details and metrics |
| Delete a tweet |
| Reply to a tweet |
Requirements
Python 3.10+
Twitter API credentials (OAuth 1.0a)
Setup
1. Get Twitter API Credentials
Go to Twitter Developer Portal
Create a project and app
Enable OAuth 1.0a with read and write permissions
Generate Access Token and Secret
2. Install
git clone https://github.com/arnaldo-delisio/x-mcp.git
cd x-mcp
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt3. Configure
cp .env.example .envEdit .env with your credentials:
TWITTER_API_KEY=your_api_key
TWITTER_API_KEY_SECRET=your_api_key_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret4. Add to Claude Code
Add to your .mcp.json or Claude Code config:
{
"mcpServers": {
"x": {
"command": "/path/to/x-mcp/venv/bin/python",
"args": ["/path/to/x-mcp/server.py"],
"env": {}
}
}
}Usage
Post a tweet
x_post_tweet("Hello world!")Post a thread
Separate tweets with \n\n---\n\n:
x_post_thread("1/ First tweet here
---
2/ Second tweet continues
---
3/ Final tweet")Get tweet metrics
x_get_tweet("1234567890")Returns likes, retweets, replies, impressions, quotes, and bookmarks.
Roadmap
Upload media (images, video)
Quote tweet
Batch metrics
License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.