{
"mcpServers": {
"x-mcp-server": {
"command": "<see-readme>",
"args": []
}
}
}No install config available. Check the server's README for setup instructions.
Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
MIT. View license →
Is it maintained?
Last commit 24 days ago. 64 stars.
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
No automated test available for this server. Check the GitHub README for setup instructions.
No known vulnerabilities.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationHave you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Persistent memory using a knowledge graph
Privacy-first. MCP is the protocol for tool access. We're the virtualization layer for context.
Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.
Monitor browser logs directly from Cursor and other MCP compatible IDEs.
MCP Security Weekly
Get CVE alerts and security updates for X Mcp Server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
A Model Context Protocol (MCP) server for X (Twitter) integration. Provides 16 tools for reading timelines, posting, searching, engagement (likes, retweets, bookmarks), and user lookup. Designed for use with Claude desktop and other MCP-compatible clients.
| Tier | Cost | Post Reads | Post Writes | Notes | |------|------|-----------|-------------|-------| | Free | $0 | ~100/month | ~500/month | No likes/follows; media upload requires OAuth 2.0 | | Basic | $200/month | 10,000/month | 3,000/month | Search, limited read access | | Pro | $5,000/month | 1,000,000/month | 300,000/month | Full search, filtered stream | | Pay-Per-Use | Credit-based | ~$0.005/read | Varies | Launched Feb 2026, 2M reads cap |
Like and Follow endpoints were removed from the Free tier in August 2025. Follows/Blocks endpoints are Enterprise-only as of 2025.
git clone https://github.com/DataWhisker/x-mcp-server.git
cd x-mcp-server
npm install
npm run build
The server supports two authentication methods. You need at least one configured.
Works for all post/engagement/search/user operations.
| Environment Variable | Description |
|---------------------|-------------|
| TWITTER_API_KEY | Consumer Key (API Key) |
| TWITTER_API_SECRET | Consumer Secret (API Key Secret) |
| TWITTER_ACCESS_TOKEN | User Access Token |
| TWITTER_ACCESS_SECRET | User Access Token Secret |
Setup: In the X Developer Portal:
The v1.1 media upload endpoint was sunset in June 2025. Media upload now requires OAuth 2.0 via the v2 upload API.
Option A — Direct access token:
| Variable | Description |
|----------|-------------|
| TWITTER_OAUTH2_ACCESS_TOKEN | OAuth 2.0 user access token (expires in 2 hours) |
Option B — Auto-refresh (recommended for long-running servers):
| Variable | Description |
|----------|-------------|
| TWITTER_CLIENT_ID | OAuth 2.0 Client ID |
| TWITTER_CLIENT_SECRET | OAuth 2.0 Client Secret (optional for public clients) |
| TWITTER_OAUTH2_REFRESH_TOKEN | OAuth 2.0 Refresh Token |
Tokens are auto-refreshed and persisted to ~/.x-mcp-tokens.json.
Setup: In the X Developer Portal:
tweet.read, tweet.write, users.read, media.write, offline.access, like.read, like.write, bookmark.read, bookmark.writeAdd to %APPDATA%/Claude/claude_desktop_config.json:
{
"mcpServers": {
"x": {
"command": "node",
"args": ["C:/path/t
... [View full README on GitHub](https://github.com/DataWhisker/x-mcp-server#readme)