X (Twitter)

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

Connector by Role1776 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 2

Install

Works with Claude Code, Codex, VS Code, Claude Desktop, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/role1776-mcp-x

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools: 10 read · 15 write · 3 delete · 4 not yet classified
Secrets: 4 (API keys, tokens or passwords)
Install scripts: Not scanned yet
Runs as: Docker image

Tools by what they do 32

Read from the source code; the running server may list different tools.

Read 10 · Look things up without changing anything.

x_bookmarks_list
x_list_get
x_list_members
x_list_posts
x_list_update
x_lists_owned
x_lists_pinned
x_user_followers
x_users_blocked
x_users_me

Write 15 · Create, change, send or run things.

x_media_upload
x_post_like
x_post_liked_by
x_post_repost
x_post_reposted_by
x_posts_by_user
x_posts_count
x_posts_home
x_posts_liked
x_posts_mentions
x_posts_quotes
x_posts_search

Show 3 more tools

x_user_following
x_user_mute
x_users_muted

Delete 3 · Delete, drop, revoke or wipe things.

x_post_unlike
x_post_unrepost
x_user_unmute

Not yet classified 4 · We could not tell from the name and description.

x_list_member_add
x_list_member_remove
x_list_pin
x_list_unpin

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

X_ACCESS_TOKEN
X_ACCESS_TOKEN_SECRET
X_API_KEY
X_API_KEY_SECRET

Other settings (environment variables or headers).

LISTS_DEFAULT_RESULTS
LISTS_DEFAULT_TIMEOUT_MS
LISTS_MAX_RESULTS
LISTS_MAX_TIMEOUT_MS
LISTS_MIN_TIMEOUT_MS
LOG_MODE
MAX_IDLE_CONNS_PER_HOST
MCP_NAME
MCP_PATH
MCP_TRANSPORT
MEDIA_CHUNK_BYTES
MEDIA_DEFAULT_TIMEOUT_MS

Show 25 more settings

MEDIA_MAX_TIMEOUT_MS
MEDIA_MIN_TIMEOUT_MS
MEDIA_POLL_INTERVAL_MS
MEDIA_ROOT
POSTS_DEFAULT_DAYS
POSTS_DEFAULT_RESULTS
POSTS_DEFAULT_TIMEOUT_MS
POSTS_MAX_DAYS
POSTS_MAX_IDS
POSTS_MAX_QUERIES
POSTS_MAX_RESULTS
POSTS_MAX_TIMEOUT_MS
POSTS_MAX_USERNAMES
POSTS_MIN_TIMEOUT_MS
SERVER_PORT
SERVER_READ_TIMEOUT
SERVER_WRITE_TIMEOUT
USERS_DEFAULT_RESULTS
USERS_DEFAULT_TIMEOUT_MS
USERS_MAX_IDS
USERS_MAX_RESULTS
USERS_MAX_TIMEOUT_MS
USERS_MAX_USERNAMES
USERS_MIN_TIMEOUT_MS
X_DEBUG

Network hosts it talks to 1

github.com · found in install command

Tools (32)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

x_bookmarks_listX bookmarks
Description is built at runtime.
x_list_getGet an X list
Returns one list by id, including its member and follower counts.
x_list_member_addAdd a member to an X list
Adds the given username to a list you own.
x_list_member_removeRemove a member from an X list
Removes the given username from a list you own.
x_list_membersMembers of an X list
Returns the accounts that belong to a list, one page at a time.
x_list_pinPin an X list
Pins a list to the top of your lists view. Acts as the account whose API keys this server runs on.
x_list_postsPosts in an X list
Returns recent posts from the members of a list. Every post is a billed read, so ask for the smallest max_results that answers the question.
x_list_unpinUnpin an X list
Removes a list from your pinned lists. Acts as the account whose API keys this server runs on.
x_list_updateUpdate an X list
Changes the name, description or privacy of a list you own. Send only the fields you want changed.
x_lists_ownedX lists owned by a user
Returns the lists owned by the given username, or by the key owner when username is omitted.
x_lists_pinnedX lists you pinned
Returns the pinned lists of the account whose API keys this server runs on.
x_media_uploadUpload media to X
Uploads an image, gif or video and returns a media_id to pass to x_post_create. Give either 'path', pointing at a local file inside the directory this server was configured to read, or 'base64' together with 'mime'. Size limits follow the category: 5 MB for tweet_image, 15 MB for tweet_gif, 512 MB for tweet_video. Video is transcoded by X after the upload; when the response comes back with status 'pending' the id is valid but not yet usable, so retry the post shortly. A media_id expires after a while and is meant for a single post.
x_post_likeLike an X post
Likes a post as the account whose API keys this server runs on. The like is public.
x_post_liked_byWho liked an X post
Returns the users who liked the given post.
x_post_repostRepost an X post
Reposts a post to your followers. The repost is public.

Show 17 more tools

x_post_reposted_byWho reposted an X post
Returns the users who reposted the given post.
x_post_unlikeRemove a like from an X post
Removes your like from a post.
x_post_unrepostUndo a repost
Removes your repost of a post.
x_posts_by_userX posts by user
Description is built at runtime.
x_posts_countCount X posts
Counts how many posts match each query, bucketed by minute, hour or day, without returning the posts themselves. This does not consume the post-read budget, so use it first to size a topic before paying for x_posts_search. Same operators and same 7-day window.
x_posts_homeX home timeline
Description is built at runtime.
x_posts_likedX posts I liked
Description is built at runtime.
x_posts_mentionsX mentions
Description is built at runtime.
x_posts_quotesX quotes of a post
Description is built at runtime.
x_posts_searchSearch X posts
Description is built at runtime.
x_user_followersX followers of a user
Returns the followers of the given username, one page at a time. Pass next_token back as pagination_token to walk further.
x_user_followingAccounts an X user follows
Returns the accounts the given username follows, one page at a time. Pass next_token back as pagination_token to walk further.
x_user_muteMute an X user
Mutes the given username: their posts disappear from your timeline, but they are not told and can still see yours. Acts as the account whose API keys this server runs on.
x_user_unmuteUnmute an X user
Removes a mute. Acts as the account whose API keys this server runs on.
x_users_blockedAccounts you block on X
Returns the accounts blocked by the account whose API keys this server runs on.
x_users_meThe X account behind these keys
Returns the profile of the account whose API keys this server runs on.
x_users_mutedAccounts you mute on X
Returns the accounts muted by the account whose API keys this server runs on.

Signals

Stars: 2
Forks: 1
Open issues: 0
Last commit: Sep 10, 2026 (1 month ago)
Last release: Sep 9, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.Role1776/mcp-x
Version: 0.1.1
Auth: API key
Packages: oci ghcr.io/role1776/mcp-x:0.1.1mcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_darwin_amd64.mcpbmcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_darwin_arm64.mcpbmcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_linux_amd64.mcpbmcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_linux_arm64.mcpbmcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_windows_amd64.mcpbmcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_windows_arm64.mcpb
License: MIT
Repository: github.com/Role1776/mcp-x
Website: github.com/Role1776/mcp-x#readme
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql