x-mcp
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-mcppost 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.
x-mcp
An MCP server and CLI for interacting with X/Twitter, built with @xdevplatform/xdk.
Tools
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
Setup
Prerequisites
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
Authenticate
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.
Usage
MCP Server
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"]
}
}
}CLI
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 1234567890Development
git 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.tsThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseCqualityDmaintenanceAn MCP server for accessing the Twitter/X Api45 API, allowing users to retrieve user profiles, timelines, followers, and media. It supports searching communities, jobs, and trends, while also providing tools to monitor live broadcasts and Twitter Spaces.Last updated28MIT
- AlicenseBqualityDmaintenanceAn MCP server that provides access to Twitter data and write actions through TwitterAPI.io, bypassing the need for a standard Twitter developer account. It enables users to search tweets, retrieve profiles, and post content with support for pagination and enterprise proxy configurations.Last updated16MIT
- Alicense-qualityDmaintenanceAn MCP server for interacting with the Twitter/X API v2, enabling AI assistants to retrieve tweets, post content, reply, quote, and more programmatically.Last updated1,86113MIT
- AlicenseAqualityCmaintenanceAn MCP server for interacting with Twitter/X using browser cookies without an API key, enabling tweet management, user actions, and search via natural language.Last updated5910MIT
Related MCP Connectors
FastMCP server for posting formatted content to X (Twitter) — Tollbooth-monetized, DPYC-native
A MCP server built for developers enabling Git based project management with project and personal…
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/khajaphysist/x-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server