x-twitter-posting-mcp

# X Twitter Posting MCP Server An MCP (Model Context Protocol) server that allows language models to post tweets and threads to X (formerly Twitter). ## Features * **Post Single Tweet**: Provides a tool (`post_tweet`) to post a single status update. * **Post Thread**: Provides a tool (`post_thread`) to post a sequence of tweets as a thread. ## Prerequisites * Python 3.10+ * An X Developer account with API v2 access (Essential access or higher). * API Key, API Key Secret, Access Token, and Access Token Secret from your X Developer App dashboard. ## Installation ```bash pip install x-twitter-posting-mcp ``` *(Note: This package is not yet published on PyPI. This is the intended installation command once published.)* Alternatively, install directly from source: ```bash git clone https://github.com/DevRico003/x-twitter-posting-mcp.git cd x-twitter-posting-mcp pip install . ``` ## Configuration This server requires X API credentials to function. Set the following environment variables: * `TWITTER_API_KEY`: Your X App's API Key * `TWITTER_API_KEY_SECRET`: Your X App's API Key Secret * `TWITTER_ACCESS_TOKEN`: Your X App's Access Token * `TWITTER_ACCESS_TOKEN_SECRET`: Your X App's Access Token Secret You can set these directly in your environment or place them in a `.env` file in the directory where you run the server. See `.env.example` for a template. ## Usage ### Running the Server Standalone You can run the server directly using the installed script: ```bash x-twitter-posting-mcp ``` This will start the server using the default `stdio` transport. ### Integrating with MCP Clients (e.g., Claude Desktop) Configure your MCP client to launch the server. Add an entry similar to this in your client's configuration (e.g., `claude_desktop_config.json`). **Method 1: Using the installed script (if in PATH)** This assumes `x-twitter-posting-mcp` is installed in a location accessible by your system's PATH and you have configured credentials …