v0.2.2 — first PyPI release as mcp-server-x

First release published to PyPI as mcp-server-x.

Install

uvx mcp-server-x --login   # one-time interactive sign-in
uvx mcp-server-x           # run the server

Changes

• Published to PyPI under the name mcp-server-x (the x-mcp-server name was already taken).
• Renamed the console script from x-mcp-server to mcp-server-x so uvx mcp-server-x runs directly.
• --install now writes the clean uvx mcp-server-x invocation into MCP client configs (no more git URL).

The GitHub repo and Python import module remain x-mcp-server / x_mcp_server.

v0.2.1

A stealth-browser MCP server for X (formerly Twitter), driven by Patchright and exposed over FastMCP. Runs straight from this repo with uvx — no PyPI install needed.

✅ Working (verified against live X)

• Login — interactive sign-in via --login, with a persistent session stored at ~/.x-mcp/profile.
• Post a tweet — post_tweet.

🚧 Scaffolded, not yet validated

reply_to_tweet, like_tweet, follow_user, and the read tools (get_profile, get_user_tweets, get_tweet, search_tweets) are implemented and import cleanly, but have not been validated end-to-end against live X. Selector drift is expected. These will be hardened as the need arises — contributions welcome (see CONTRIBUTING.md).

Highlights

• Run from GitHub via uvx — no PyPI install required.
• Zero-setup browser — Chromium auto-provisions on first launch.
• One-command client install — --install {claude-desktop,claude-code,codex,opencode} merges into the client's config (never clobbers other servers).
• Resilient navigation — retries transient network errors with backoff.

Quick start

# sign in once
uvx --from git+https://github.com/afikrim/x-mcp-server.git x-mcp-server --login

# register with your MCP client (example: Claude Desktop)
uvx --from git+https://github.com/afikrim/x-mcp-server.git x-mcp-server --install claude-desktop

Inspired by stickerdaniel/linkedin-mcp-server.