MCP server

X (Twitter)

io.github.Role1776/mcp-x

Checked 26 Oct 2026, 08:31 UTC · Checked against OSV.dev for malware and vulnerabilities; never run by us

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

Runs on your computer

Website Source

At a glance

Type: MCP server
Publisher: Not verified
Status: Runs on your computer
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code
Last checked: 26 Oct 2026, 08:31 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. It then runs the package on your computer with your permissions. For other apps, copy the setup below.

Claude Code

claude mcp add mcp-x --env X_API_KEY=YOUR_VALUE --env X_API_KEY_SECRET=YOUR_VALUE --env X_ACCESS_TOKEN=YOUR_VALUE --env X_ACCESS_TOKEN_SECRET=YOUR_VALUE --env MEDIA_ROOT=YOUR_VALUE -- docker run -i --rm -e X_API_KEY -e X_API_KEY_SECRET -e X_ACCESS_TOKEN -e X_ACCESS_TOKEN_SECRET -e MEDIA_ROOT ghcr.io/role1776/mcp-x:0.1.1

Claude Desktop

{"mcpServers":{"mcp-x":{"command":"docker","args":["run","-i","--rm","-e","X_API_KEY","-e","X_API_KEY_SECRET","-e","X_ACCESS_TOKEN","-e","X_ACCESS_TOKEN_SECRET","-e","MEDIA_ROOT","ghcr.io/role1776/mcp-x:0.1.1"],"env":{"X_API_KEY":"YOUR_VALUE","X_API_KEY_SECRET":"YOUR_VALUE","X_ACCESS_TOKEN":"YOUR_VALUE","X_ACCESS_TOKEN_SECRET":"YOUR_VALUE","MEDIA_ROOT":"YOUR_VALUE"}}}}

Codex (config.toml)

[mcp_servers.mcp-x]
command = "docker"
args = ["run","-i","--rm","-e","X_API_KEY","-e","X_API_KEY_SECRET","-e","X_ACCESS_TOKEN","-e","X_ACCESS_TOKEN_SECRET","-e","MEDIA_ROOT","ghcr.io/role1776/mcp-x:0.1.1"]
env = { X_API_KEY = "YOUR_VALUE", X_API_KEY_SECRET = "YOUR_VALUE", X_ACCESS_TOKEN = "YOUR_VALUE", X_ACCESS_TOKEN_SECRET = "YOUR_VALUE", MEDIA_ROOT = "YOUR_VALUE" }

Gemini CLI

{"mcpServers":{"mcp-x":{"command":"docker","args":["run","-i","--rm","-e","X_API_KEY","-e","X_API_KEY_SECRET","-e","X_ACCESS_TOKEN","-e","X_ACCESS_TOKEN_SECRET","-e","MEDIA_ROOT","ghcr.io/role1776/mcp-x:0.1.1"],"env":{"X_API_KEY":"YOUR_VALUE","X_API_KEY_SECRET":"YOUR_VALUE","X_ACCESS_TOKEN":"YOUR_VALUE","X_ACCESS_TOKEN_SECRET":"YOUR_VALUE","MEDIA_ROOT":"YOUR_VALUE"}}}}

Cursor

{"mcpServers":{"mcp-x":{"command":"docker","args":["run","-i","--rm","-e","X_API_KEY","-e","X_API_KEY_SECRET","-e","X_ACCESS_TOKEN","-e","X_ACCESS_TOKEN_SECRET","-e","MEDIA_ROOT","ghcr.io/role1776/mcp-x:0.1.1"],"env":{"X_API_KEY":"YOUR_VALUE","X_API_KEY_SECRET":"YOUR_VALUE","X_ACCESS_TOKEN":"YOUR_VALUE","X_ACCESS_TOKEN_SECRET":"YOUR_VALUE","MEDIA_ROOT":"YOUR_VALUE"}}}}

VS Code

{"servers":{"mcp-x":{"type":"stdio","command":"docker","args":["run","-i","--rm","-e","X_API_KEY","-e","X_API_KEY_SECRET","-e","X_ACCESS_TOKEN","-e","X_ACCESS_TOKEN_SECRET","-e","MEDIA_ROOT","ghcr.io/role1776/mcp-x:0.1.1"],"env":{"X_API_KEY":"YOUR_VALUE","X_API_KEY_SECRET":"YOUR_VALUE","X_ACCESS_TOKEN":"YOUR_VALUE","X_ACCESS_TOKEN_SECRET":"YOUR_VALUE","MEDIA_ROOT":"YOUR_VALUE"}}}}

Runs on your computer with your permissions: check the package and its source before installing. Replace YOUR_VALUE with your own X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET, MEDIA_ROOT.

Browse

Related MCP servers

Product Admin by Nova (CIVAI)
I manage your Nova products, create/update/delete, payment & logistics config, icons, webhook secre…
Tweetsmash
Search, label, and manage your X (Twitter) bookmarks from any MCP client via Tweetsmash
Desearch
AI search (Reddit, HN, arXiv, Wikipedia), X and web search, page extraction, X data, People Search.
X Twitter
X (twitter): x, xapi, Twitter, twitter api, twitters ,tweets, tw, twttr, FollowerIds, friendsIds.
Agent Tools API
YouTube transcripts, open jobs from careers pages, app store reviews and X posts for AI agents.
Xtracticle
Read public X (Twitter) posts, threads and X Articles as clean Markdown. Read-only, no auth.
twitr.sh
X/Twitter reads, search, monitors and posting. Pay-per-call in USDC — no signup, no API keys.
Hermoso
AI marketing agent and AI ad generator: 928 tools, usable alone. No markup on models.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.Role1776/mcp-x.svg)](https://aptlynx.net/servers/io.github.Role1776/mcp-x)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents