Skip to content
Verified official

X (Twitter) MCP

v0.1.1

io.github.role1776/mcp-x

Search, read and publish X posts and manage users, lists and media via the X API v2.

transport:stdio runtime:oci

Target client

run in your project directory

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

claude mcp add mcp-x -e X_API_KEY=<X_API_KEY> -e X_API_KEY_SECRET=<X_API_KEY_SECRET> -e X_ACCESS_TOKEN=<X_ACCESS_TOKEN> -e X_ACCESS_TOKEN_SECRET=<X_ACCESS_TOKEN_SECRET> -e MEDIA_ROOT=<MEDIA_ROOT> -e MCP_TRANSPORT=<MCP_TRANSPORT> -e MCP_NAME=<MCP_NAME> -e MCP_PATH=<MCP_PATH> -e SERVER_PORT=<SERVER_PORT> -e SERVER_READ_TIMEOUT=<SERVER_READ_TIMEOUT> -e SERVER_WRITE_TIMEOUT=<SERVER_WRITE_TIMEOUT> -e LOG_MODE=<LOG_MODE> -e MAX_IDLE_CONNS_PER_HOST=<MAX_IDLE_CONNS_PER_HOST> -e X_DEBUG=<X_DEBUG> -e POSTS_MAX_QUERIES=<POSTS_MAX_QUERIES> -e POSTS_MAX_USERNAMES=<POSTS_MAX_USERNAMES> -e POSTS_MAX_IDS=<POSTS_MAX_IDS> -e POSTS_DEFAULT_RESULTS=<POSTS_DEFAULT_RESULTS> -e POSTS_MAX_RESULTS=<POSTS_MAX_RESULTS> -e POSTS_DEFAULT_DAYS=<POSTS_DEFAULT_DAYS> -e POSTS_MAX_DAYS=<POSTS_MAX_DAYS> -e POSTS_DEFAULT_TIMEOUT_MS=<POSTS_DEFAULT_TIMEOUT_MS> -e POSTS_MIN_TIMEOUT_MS=<POSTS_MIN_TIMEOUT_MS> -e POSTS_MAX_TIMEOUT_MS=<POSTS_MAX_TIMEOUT_MS> -e USERS_MAX_USERNAMES=<USERS_MAX_USERNAMES> -e USERS_MAX_IDS=<USERS_MAX_IDS> -e USERS_DEFAULT_RESULTS=<USERS_DEFAULT_RESULTS> -e USERS_MAX_RESULTS=<USERS_MAX_RESULTS> -e USERS_DEFAULT_TIMEOUT_MS=<USERS_DEFAULT_TIMEOUT_MS> -e USERS_MIN_TIMEOUT_MS=<USERS_MIN_TIMEOUT_MS> -e USERS_MAX_TIMEOUT_MS=<USERS_MAX_TIMEOUT_MS> -e LISTS_DEFAULT_RESULTS=<LISTS_DEFAULT_RESULTS> -e LISTS_MAX_RESULTS=<LISTS_MAX_RESULTS> -e LISTS_DEFAULT_TIMEOUT_MS=<LISTS_DEFAULT_TIMEOUT_MS> -e LISTS_MIN_TIMEOUT_MS=<LISTS_MIN_TIMEOUT_MS> -e LISTS_MAX_TIMEOUT_MS=<LISTS_MAX_TIMEOUT_MS> -e MEDIA_CHUNK_BYTES=<MEDIA_CHUNK_BYTES> -e MEDIA_POLL_INTERVAL_MS=<MEDIA_POLL_INTERVAL_MS> -e MEDIA_DEFAULT_TIMEOUT_MS=<MEDIA_DEFAULT_TIMEOUT_MS> -e MEDIA_MIN_TIMEOUT_MS=<MEDIA_MIN_TIMEOUT_MS> -e MEDIA_MAX_TIMEOUT_MS=<MEDIA_MAX_TIMEOUT_MS> -- docker run -i --rm ghcr.io/role1776/mcp-x:0.1.1

Adds it for this project only. Append --scope user to make it available everywhere. Claude Code docs

This listing does not declare its tools. Connect the server and your client will discover them on the handshake.