Click on "Deploy 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-mcp post a tweet saying 'Hello from MCP!'"
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.
An MCP server and CLI for interacting with X/Twitter, built with @xdevplatform/xdk.
Tool | Description |
| Post a tweet |
| Search recent tweets (last 7 days) |
| Get user profile info by username(s) |
| Get your home timeline |
| Like a tweet by ID |
| Retweet a tweet by ID |
| Delete a tweet by ID |
Related MCP server: TwitterAPI MCP Server
You need X/Twitter API credentials (OAuth 1.0a). Get them from the X Developer Portal:
API Key (Consumer Key)
API Secret (Consumer Secret)
Access Token
Access Token Secret
Either log in interactively (credentials are saved to ~/.x-mcp/credentials.json):
npx @kms_dev/x-mcp loginOr set environment variables:
export X_API_KEY=your_api_key
export X_API_SECRET=your_api_secret
export X_ACCESS_TOKEN=your_access_token
export X_ACCESS_TOKEN_SECRET=your_access_token_secretEnvironment variables take precedence over stored credentials.
Add to your MCP client config (e.g. Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"x-mcp": {
"command": "npx",
"args": ["-y", "@kms_dev/x-mcp"],
"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"
}
}
}
}If you've already run npx @kms_dev/x-mcp login, you can omit the env block:
{
"mcpServers": {
"x-mcp": {
"command": "npx",
"args": ["-y", "@kms_dev/x-mcp"]
}
}
}npx @kms_dev/x-mcp login
npx @kms_dev/x-mcp post-tweet "Hello world!"
npx @kms_dev/x-mcp search-tweets "typescript" --max-results 5
npx @kms_dev/x-mcp get-user-info XDevelopers
npx @kms_dev/x-mcp get-timeline --max-results 10
npx @kms_dev/x-mcp like-tweet 1234567890
npx @kms_dev/x-mcp retweet 1234567890
npx @kms_dev/x-mcp delete-tweet 1234567890git clone https://github.com/khajaphysist/x-mcp.git
cd x-mcp
npm install
# Run tests
npm test
# Run CLI
npx tsx src/cli.ts search-tweets "test"
# Run MCP server
npx tsx src/mcp-server.ts
# Test MCP server with inspector
npx @modelcontextprotocol/inspector npx tsx src/mcp-server.tsDelete a tweet by its ID (must be owned by the authenticated user)
Inputs: tweet_id (required).
Get the authenticated user's home timeline (reverse chronological)
Inputs: max_results.
Get profile information for one or more X/Twitter users by username
Inputs: usernames (required).
Like a tweet by its ID
Inputs: tweet_id (required).
Post a tweet to X/Twitter
Inputs: text (required), reply_to.
Retweet (repost) a tweet by its ID
Inputs: tweet_id (required).
Search recent tweets on X/Twitter (last 7 days)
Inputs: query (required), max_results.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
Each tool targets a distinct action (post, search, get user info, timeline, like, retweet, delete) with no overlap. An agent can easily distinguish them.
All tools follow a consistent verb_noun pattern in snake_case (e.g., post_tweet, search_tweets, get_user_info). No deviations or mixed conventions.
Seven tools cover the core Twitter operations without being excessive. The scope is well-balanced for a dedicated social media server.
The set covers posting, timeline, search, user info, likes, retweets, and deletion. However, fetching a specific tweet by ID is missing, which is a minor gap for workflows that need to retrieve a single tweet after a search.
Official MCP server for twitterapis.com. Twitter/X search, users, DMs, Grok, monitoring and writes.
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Official twitterapi.io hosted MCP: Twitter/X tweets, users, followers, trends. OAuth or API key.
Hosted MCP server from TwitterAPI.io that gives AI agents read-only access to Twitter/X data. 12 tools: tweet search with X operators, user profiles, a user's latest tweets, followers and followings, replies, quotes, retweeters, mentions and trends. Connect at https://mcp.twitterapi.io/mcp with a TwitterAPI.io API key or account sign-in; usage is paid per result returned.
