X WebMCP

Use this skill to operate X through the built-in --site x bridge preset in @webmcp-bridge/local-mcp.

For generic bridge setup patterns or non-X sites, switch to $webmcp-bridge.

Prerequisites

• uxc is installed and available in PATH.
• npx is installed and available in PATH.
• Network access to https://x.com.
• On a fresh machine, or under an isolated HOME, install Playwright browsers first with npx playwright install.
• X is auth-sensitive. Expect bootstrapthenattach behavior when the profile is not signed in yet.

Core Workflow

1. Ensure the fixed X link exists:

- command -v x-webmcp-cli - if missing or pointed at the wrong profile, run skills/x-webmcp/scripts/ensure-links.sh

1. Inspect the bridge and tool schema before calling tools:

- x-webmcp-cli -h - x-webmcp-cli timeline.home.list -h - x-webmcp-cli grok.chat -h - x-webmcp-cli article.publishMarkdown -h

1. Check authentication state first when the profile is new or looks stale:

- x-webmcp-cli bridge.session.status - x-webmcp-cli auth.get - if the session is not ready, start bootstrap or switch to headed: - x-webmcp-cli bridge.session.bootstrap - x-webmcp-cli bridge.session.mode.set '{"mode":"headed"}' - x-webmcp-cli bridge.open

1. Use read tools for timelines, conversations, and profiles:

- x-webmcp-cli timeline.home.list limit=10 - x-webmcp-cli search.tweets.list '{"query":"playwright","mode":"latest","limit":10}' - x-webmcp-cli tweet.get '{"url":"https://x.com/.../status/..."}'; - x-webmcp-cli tweet.conversation.get '{"id":"2033895522382319922","limit":10}' - x-webmcp-cli user.get username=jack

1. Use write tools only after reading help and confirming user intent:

- x-webmcp-cli tweet.create '{"text":"hello from webmcp","dryRun":true}' - x-webmcp-cli tweet.reply '{"id":"2033895522382319922","text":"reply text","dryRun":true}' - x-webmcp-cli article.publishMarkdown '{"markdownPath":"/abs/path/post.md","dryRun":true}'

1. Use Grok through the same authenticated X session:

- x-webmcp-cli grok.chat '{"prompt":"Summarize this thread","timeoutMs":180000}' - for uploads, pass absolute local file paths in attachmentPaths

1. Parse JSON output only:

- success path: .ok == true, consume .data - failure path: .ok == false, inspect .error.code and .error.message

Default Target

The built-in preset uses:

--site x

The default profile path is:

~/.uxc/webmcp-profile/x

Refresh the link with:

skills/x-webmcp/scripts/ensure-links.sh

Guardrails

• Keep the X profile isolated from other sites.
• X uses bootstrapthenattach; do not expect page tools to work until the managed profile is authenticated.
• Prefer explicit bridge.session.mode.set over relaunching the command to change runtime mode.
• grok.chat and article publishing can take a long time. Increase timeoutMs instead of retrying aggressively.
• For local uploads such as attachmentPaths, markdownPath, or coverImagePath, always use absolute filesystem paths.
• Use dryRun for destructive or public write tools first when available.
• If the user closes the visible X window manually, the headed owner session ends. Run x-webmcp-cli bridge.open again if you still need a visible session on the same profile.

References

• Common command patterns:

- references/usage-patterns.md

• Link creation helper:

- scripts/ensure-links.sh