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.