x

This MCP server provides an interface to interact with the X platform via MCP clients such as Claude, Cursor AI, Windsurf AI, and others. After building the project, run the server locally and configure your MCP clients to point to the local MCP server endpoint using the provided command and environment variables. The server expects the X API credentials (three tokens: API key, API key secret, access token, and access token secret) to authenticate requests to X services. Once configured, MCP clients can send model-context protocol requests to the X platform through this server, enabling streamlined interactions and context sharing between tools and the X platform.

Prerequisites:

• Node.js >= 18.0.0
• npm >= 8.0.0
• X Developer API keys/tokens

Installation steps:

1. Clone the repository: git clone <repository-url>
2. Navigate into the project directory: cd x-mcp-server
3. Install dependencies: npm install
4. Build the project: npm run build This will compile the TypeScript source (index.ts) and place the output in the build directory.
5. Prepare configuration:
   • Obtain your X API credentials: X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET
   • Set up your MCP client configurations to point to the server as described in the README (Claude, Cursor AI, Windsurf AI, etc.).

Notes and tips:

• Ensure your X API credentials have the necessary permissions for your use case; the README references Twitter/X API access guidelines and keys.
• The server relies on environment variables for credentials; keep these secrets secure and do not commit them to version control.
• If you encounter rate limit issues from the X APIs, review the rate limits at the X developer portal and implement client-side pacing as needed.
• For Claude and Windsurf AI configurations, use the sample config blocks provided in the README and replace placeholders with absolute paths to the built index.js and your credentials.
• If you update dependencies or rebuild, ensure the path in the MCP client configurations still points to build/index.js.