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