X (Twitter) MCP Server - install, status & alternatives [2026]

01 · Install X (Twitter)

before you install - you'll need

Set X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET before connecting. MEDIA_ROOT is optional or environment-specific per the README.

Docker

docker run -i --rm ghcr.io/role1776/mcp-x:0.1.1

Claude Desktop - add to config

{
  "mcpServers": {
    "role1776-mcp-x": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/role1776/mcp-x:0.1.1"
      ]
    }
  }
}

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as container (OCI image) - can be sandboxed away from your filesystem · Claude Desktop extension (.mcpb bundle)

repo age created 2026-09-09 - young repo, little track record yet

license MIT - declared in the repository

registry namespace io.github.Role1776 is GitHub-verified and matches the repo owner

03 · What X (Twitter) can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can search recent posts for several queries in parallel. Recent search reaches back 7 days only, count matches per query bucketed by minute/hour/day. Does not spend post reads - use it to size a topic before searching, fetch up to 100 posts by id in one call, and post mentioning the key owner.

Capability map

Tools grouped from the project's README - what X (Twitter) lets an agent do.

Posts

9 tools - e.g. Searches recent posts for several queries in parallel. Recent search reaches back 7 days only.; Counts matches per query bucketed by minute/hour/day. Does not spend post reads - use it to size a topic…

x_posts_search · x_posts_count · x_posts_lookup · x_posts_by_user · x_posts_mentions · x_posts_home…

other

6 tools - e.g. Publishes a post. Public and billed ($0.015, or $0.20 with a link).; Deletes one of your posts. Irreversible.; Name ≤ 25 chars, description ≤ 100. Private lists are owner-only.

x_post_create · x_post_delete · x_list_create · x_list_update · x_list_delete · x_list_get

Users

2 tools - e.g. Up to 100 usernames or 100 ids in one call - one or the other, not both. Unresolved names come back in not_found.; The profile behind the keys.

x_users_lookup · x_users_me

Bookmarks

1 tool - e.g. The key owner's bookmarks.

x_bookmarks_list

Liked

1 tool - e.g. Users who liked a given post.

x_post_liked_by

Reposted

1 tool - e.g. Users who reposted a given post.

x_post_reposted_by

Lists

1 tool - e.g. Lists owned by a username, or by the key owner when omitted.

x_lists_owned

Members

1 tool - e.g. Accounts in the list, paginated.

x_list_members

Latest releases

v0.1.1 · 2026-09-09

make the mcpb bundle configurable, validate MEDIA_ROOT, add -version (@Role1776)

v0.1.0 · 2026-09-09

init (Role1776 <[email protected]>)

04 · Who maintains X (Twitter)

X (Twitter) is maintained by role1776. We track 2 MCP servers from role1776 - 2 actively maintained, 15 combined GitHub stars, oldest repo from Aug 2026. Full record: all servers from role1776.

MCP Retrieval Local Go MCP server: DuckDuckGo/Bing web + image search, readability scraping to Markdown. ★ 13

05 · Facts

repository: github.com/role1776/mcp-x
website: https://github.com/Role1776/mcp-x#readme
category: security - ranked #198 of 216 actively-maintained security servers as of 2026-09-30.
release cadence: 2 releases in the last 90 days (latest 2026-09-09)
registry: io.github.Role1776/mcp-x (active, first published 2026-09-09 · 2 versions)
packages: oci:ghcr.io/role1776/mcp-x:0.1.1 · mcpb:https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_darwin_amd64.mcpb · mcpb:https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_darwin_arm64.mcpb · mcpb:https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_linux_amd64.mcpb · mcpb:https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_linux_arm64.mcpb · mcpb:https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_windows_amd64.mcpb · mcpb:https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_windows_arm64.mcpb

06 · X (Twitter) FAQ

Is X (Twitter) still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-10 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can X (Twitter) do?

With this server connected, an agent can search recent posts for several queries in parallel. Recent search reaches back 7 days only, count matches per query bucketed by minute/hour/day. Does not spend post reads - use it to size a topic before searching, fetch up to 100 posts by id in one call, and post mentioning the key owner.

How do I install X (Twitter)?

Run `docker run -i --rm ghcr.io/role1776/mcp-x:0.1.1`. The README documents 5 environment variables (X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN…) to set first. Set X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET before connecting. MEDIA_ROOT is optional or environment-specific per the README. You can also paste the ready-made client config above.

07 · Alternatives to X (Twitter)

Alternatives to X (Twitter)

Maintained security servers if X (Twitter) isn't the fit.

Pairs well with

Servers that cover what X (Twitter) doesn't - only shown when the pairing reason fits the companion.

More security MCP servers · Royal MCP · Hush · Janee · Agent Wormhole · Audit

More Go MCP servers · Samihalawa Whatsapp Go MCP · Sandbox API · Scaleway MCP server · Helm MCP · see all