What this kind of tool is for
- Draft, send, or triage messages and email from inside your agent.
- Pipe notifications from a build or alert into your team channel automatically.
- Summarize a busy channel thread into the handful of points that matter.
How to compare servers like this
- Channel coverage:
- Check the specific app (email, chat, notifications) and whether it reads as well as writes.
- Scope of access:
- Messages are sensitive; review what the tool can see before connecting an account.
- Rate behavior:
- Bulk-sending tools should respect provider limits — avoid anything that floods.
- Maintenance signal:
- APIs in this space change often; recent updates are a strong signal.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the X (Twitter) MCP server?
Search, read and publish X posts and manage users, lists and media via the X API v2.
How to install X (Twitter)
Copy-paste configuration for popular MCP clients.
X_API_KEYrequiredsecretOAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens.
X_API_KEY_SECRETrequiredsecretOAuth 1.0a consumer secret, issued together with X_API_KEY.
X_ACCESS_TOKENrequiredsecretUser access token. Set the app permissions to Read and Write BEFORE generating it: a token keeps the permissions it was created with, and a read-only one fails every write until it is regenerated.
X_ACCESS_TOKEN_SECRETrequiredsecretUser access token secret, issued together with X_ACCESS_TOKEN.
MEDIA_ROOTrequiredAbsolute path to an existing directory - the only one x_media_upload may read files from. Anything outside it is refused, symlinks included. Checked at startup.
MCP_TRANSPORTstdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAMEServer name reported in the MCP initialize handshake.
MCP_PATHHTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORTTCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUTHTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUTHTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODElocal (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOSTIdle connections the outbound HTTP client keeps per host.
X_DEBUGLog the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.
POSTS_MAX_QUERIESQueries accepted in one x_posts_search or x_posts_count call.
POSTS_MAX_USERNAMESUsernames accepted in one x_posts_by_user call.
POSTS_MAX_IDSPost ids accepted in one x_posts_lookup call. The X API caps this at 100.
POSTS_DEFAULT_RESULTSPosts returned per query when the call does not ask for a count. Every post returned is billed.
POSTS_MAX_RESULTSUpper bound for posts per query. The X API caps this at 100.
POSTS_DEFAULT_DAYSHow far back post searches look when the call does not say, in days.
POSTS_MAX_DAYSFurthest back a post search may look, in days. Recent search cannot exceed 7.
POSTS_DEFAULT_TIMEOUT_MSTimeout for a posts call in milliseconds when the call does not request one.
POSTS_MIN_TIMEOUT_MSLowest timeout a posts call may request, in milliseconds.
POSTS_MAX_TIMEOUT_MSHighest timeout a posts call may request, in milliseconds.
USERS_MAX_USERNAMESUsernames accepted in one x_users_lookup call. The X API caps this at 100.
USERS_MAX_IDSUser ids accepted in one x_users_lookup call. The X API caps this at 100.
USERS_DEFAULT_RESULTSUsers returned per page when the call does not ask for a count.
USERS_MAX_RESULTSUpper bound for users per page.
USERS_DEFAULT_TIMEOUT_MSTimeout for a users call in milliseconds when the call does not request one.
USERS_MIN_TIMEOUT_MSLowest timeout a users call may request, in milliseconds.
USERS_MAX_TIMEOUT_MSHighest timeout a users call may request, in milliseconds.
LISTS_DEFAULT_RESULTSItems returned per list page when the call does not ask for a count.
LISTS_MAX_RESULTSUpper bound for items per list page. The X API caps this at 100.
LISTS_DEFAULT_TIMEOUT_MSTimeout for a lists call in milliseconds when the call does not request one.
LISTS_MIN_TIMEOUT_MSLowest timeout a lists call may request, in milliseconds.
LISTS_MAX_TIMEOUT_MSHighest timeout a lists call may request, in milliseconds.
MEDIA_CHUNK_BYTESBytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.
MEDIA_POLL_INTERVAL_MSHow often the upload status is polled while X transcodes a video, in milliseconds.
MEDIA_DEFAULT_TIMEOUT_MSTimeout for a whole upload in milliseconds when the call does not request one.
MEDIA_MIN_TIMEOUT_MSLowest timeout an upload may request, in milliseconds.
MEDIA_MAX_TIMEOUT_MSHighest timeout an upload may request, in milliseconds.
{
"mcpServers": {
"mcp-x": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/role1776/mcp-x:0.1.1"
],
"env": {
"X_API_KEY": "<YOUR_X_API_KEY>",
"X_API_KEY_SECRET": "<YOUR_X_API_KEY_SECRET>",
"X_ACCESS_TOKEN": "<YOUR_X_ACCESS_TOKEN>",
"X_ACCESS_TOKEN_SECRET": "<YOUR_X_ACCESS_TOKEN_SECRET>",
"MEDIA_ROOT": "<YOUR_MEDIA_ROOT>",
"MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
"MCP_NAME": "<YOUR_MCP_NAME>",
"MCP_PATH": "<YOUR_MCP_PATH>",
"SERVER_PORT": "<YOUR_SERVER_PORT>",
"SERVER_READ_TIMEOUT": "<YOUR_SERVER_READ_TIMEOUT>",
"SERVER_WRITE_TIMEOUT": "<YOUR_SERVER_WRITE_TIMEOUT>",
"LOG_MODE": "<YOUR_LOG_MODE>",
"MAX_IDLE_CONNS_PER_HOST": "<YOUR_MAX_IDLE_CONNS_PER_HOST>",
"X_DEBUG": "<YOUR_X_DEBUG>",
"POSTS_MAX_QUERIES": "<YOUR_POSTS_MAX_QUERIES>",
"POSTS_MAX_USERNAMES": "<YOUR_POSTS_MAX_USERNAMES>",
"POSTS_MAX_IDS": "<YOUR_POSTS_MAX_IDS>",
"POSTS_DEFAULT_RESULTS": "<YOUR_POSTS_DEFAULT_RESULTS>",
"POSTS_MAX_RESULTS": "<YOUR_POSTS_MAX_RESULTS>",
"POSTS_DEFAULT_DAYS": "<YOUR_POSTS_DEFAULT_DAYS>",
"POSTS_MAX_DAYS": "<YOUR_POSTS_MAX_DAYS>",
"POSTS_DEFAULT_TIMEOUT_MS": "<YOUR_POSTS_DEFAULT_TIMEOUT_MS>",
"POSTS_MIN_TIMEOUT_MS": "<YOUR_POSTS_MIN_TIMEOUT_MS>",
"POSTS_MAX_TIMEOUT_MS": "<YOUR_POSTS_MAX_TIMEOUT_MS>",
"USERS_MAX_USERNAMES": "<YOUR_USERS_MAX_USERNAMES>",
"USERS_MAX_IDS": "<YOUR_USERS_MAX_IDS>",
"USERS_DEFAULT_RESULTS": "<YOUR_USERS_DEFAULT_RESULTS>",
"USERS_MAX_RESULTS": "<YOUR_USERS_MAX_RESULTS>",
"USERS_DEFAULT_TIMEOUT_MS": "<YOUR_USERS_DEFAULT_TIMEOUT_MS>",
"USERS_MIN_TIMEOUT_MS": "<YOUR_USERS_MIN_TIMEOUT_MS>",
"USERS_MAX_TIMEOUT_MS": "<YOUR_USERS_MAX_TIMEOUT_MS>",
"LISTS_DEFAULT_RESULTS": "<YOUR_LISTS_DEFAULT_RESULTS>",
"LISTS_MAX_RESULTS": "<YOUR_LISTS_MAX_RESULTS>",
"LISTS_DEFAULT_TIMEOUT_MS": "<YOUR_LISTS_DEFAULT_TIMEOUT_MS>",
"LISTS_MIN_TIMEOUT_MS": "<YOUR_LISTS_MIN_TIMEOUT_MS>",
"LISTS_MAX_TIMEOUT_MS": "<YOUR_LISTS_MAX_TIMEOUT_MS>",
"MEDIA_CHUNK_BYTES": "<YOUR_MEDIA_CHUNK_BYTES>",
"MEDIA_POLL_INTERVAL_MS": "<YOUR_MEDIA_POLL_INTERVAL_MS>",
"MEDIA_DEFAULT_TIMEOUT_MS": "<YOUR_MEDIA_DEFAULT_TIMEOUT_MS>",
"MEDIA_MIN_TIMEOUT_MS": "<YOUR_MEDIA_MIN_TIMEOUT_MS>",
"MEDIA_MAX_TIMEOUT_MS": "<YOUR_MEDIA_MAX_TIMEOUT_MS>"
}
}
}
}Related MCP servers

MCP Retrieval
Local Go MCP server: DuckDuckGo/Bing web + image search, readability scraping to Markdown.
A real inbox for AI agents: send, receive and thread email, behind a prompt-injection firewall.

RuSender
Manage email campaigns, contacts and deliverability analytics in RuSender from an AI assistant.
Socializioz AI agent for creating, approving, scheduling, and managing social media content.
View repository →
io.github.RoleModel/optics-mcp
MCP Server for Optics Design System documentation and token usage.
AI-powered hotel search, comparison, and booking for agents and MCP clients—free, unlimited calls, 2M+ hotels worldwide.

