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

How do I install X (Twitter)?

Pick a client above and copy the generated config. Cursor and VS Code also have a deep link when the server can run locally or remotely.

Is X (Twitter) official?

No. Registry-listed is not the same as vendor-official. Read the methodology for the difference.

How is the trust score calculated?

This listing scores 50 (Fair). The formula is published on the methodology page.

X (Twitter) MCP Server

Loading the directory

Install

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "role1776-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": "",
        "MCP_TRANSPORT": "stdio",
        "MCP_NAME": "mcp-x",
        "MCP_PATH": "/mcp",
        "SERVER_PORT": "8080",
        "SERVER_READ_TIMEOUT": "60s",
        "SERVER_WRITE_TIMEOUT": "60s",
        "LOG_MODE": "local",
        "MAX_IDLE_CONNS_PER_HOST": "100",
        "X_DEBUG": "false",
        "POSTS_MAX_QUERIES": "5",
        "POSTS_MAX_USERNAMES": "5",
        "POSTS_MAX_IDS": "100",
        "POSTS_DEFAULT_RESULTS": "10",
        "POSTS_MAX_RESULTS": "100",
        "POSTS_DEFAULT_DAYS": "7",
        "POSTS_MAX_DAYS": "7",
        "POSTS_DEFAULT_TIMEOUT_MS": "15000",
        "POSTS_MIN_TIMEOUT_MS": "2000",
        "POSTS_MAX_TIMEOUT_MS": "60000",
        "USERS_MAX_USERNAMES": "100",
        "USERS_MAX_IDS": "100",
        "USERS_DEFAULT_RESULTS": "100",
        "USERS_MAX_RESULTS": "1000",
        "USERS_DEFAULT_TIMEOUT_MS": "15000",
        "USERS_MIN_TIMEOUT_MS": "2000",
        "USERS_MAX_TIMEOUT_MS": "60000",
        "LISTS_DEFAULT_RESULTS": "25",
        "LISTS_MAX_RESULTS": "100",
        "LISTS_DEFAULT_TIMEOUT_MS": "15000",
        "LISTS_MIN_TIMEOUT_MS": "2000",
        "LISTS_MAX_TIMEOUT_MS": "60000",
        "MEDIA_CHUNK_BYTES": "4194304",
        "MEDIA_POLL_INTERVAL_MS": "2000",
        "MEDIA_DEFAULT_TIMEOUT_MS": "120000",
        "MEDIA_MIN_TIMEOUT_MS": "5000",
        "MEDIA_MAX_TIMEOUT_MS": "600000"
      }
    }
  }
}

Install guide

Environment

Name	Required	Notes
X_API_KEY	Yes	OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.
X_API_KEY_SECRET	Yes	OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.
X_ACCESS_TOKEN	Yes	User 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. Secret.
X_ACCESS_TOKEN_SECRET	Yes	User access token secret, issued together with X_ACCESS_TOKEN. Secret.
MEDIA_ROOT	Yes	Absolute 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_TRANSPORT	No	stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME	No	Server name reported in the MCP initialize handshake.
MCP_PATH	No	HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT	No	TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT	No	HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT	No	HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE	No	local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST	No	Idle connections the outbound HTTP client keeps per host.
X_DEBUG	No	Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.
POSTS_MAX_QUERIES	No	Queries accepted in one x_posts_search or x_posts_count call.
POSTS_MAX_USERNAMES	No	Usernames accepted in one x_posts_by_user call.
POSTS_MAX_IDS	No	Post ids accepted in one x_posts_lookup call. The X API caps this at 100.
POSTS_DEFAULT_RESULTS	No	Posts returned per query when the call does not ask for a count. Every post returned is billed.
POSTS_MAX_RESULTS	No	Upper bound for posts per query. The X API caps this at 100.
POSTS_DEFAULT_DAYS	No	How far back post searches look when the call does not say, in days.
POSTS_MAX_DAYS	No	Furthest back a post search may look, in days. Recent search cannot exceed 7.
POSTS_DEFAULT_TIMEOUT_MS	No	Timeout for a posts call in milliseconds when the call does not request one.
POSTS_MIN_TIMEOUT_MS	No	Lowest timeout a posts call may request, in milliseconds.
POSTS_MAX_TIMEOUT_MS	No	Highest timeout a posts call may request, in milliseconds.
USERS_MAX_USERNAMES	No	Usernames accepted in one x_users_lookup call. The X API caps this at 100.
USERS_MAX_IDS	No	User ids accepted in one x_users_lookup call. The X API caps this at 100.
USERS_DEFAULT_RESULTS	No	Users returned per page when the call does not ask for a count.
USERS_MAX_RESULTS	No	Upper bound for users per page.
USERS_DEFAULT_TIMEOUT_MS	No	Timeout for a users call in milliseconds when the call does not request one.
USERS_MIN_TIMEOUT_MS	No	Lowest timeout a users call may request, in milliseconds.
USERS_MAX_TIMEOUT_MS	No	Highest timeout a users call may request, in milliseconds.
LISTS_DEFAULT_RESULTS	No	Items returned per list page when the call does not ask for a count.
LISTS_MAX_RESULTS	No	Upper bound for items per list page. The X API caps this at 100.
LISTS_DEFAULT_TIMEOUT_MS	No	Timeout for a lists call in milliseconds when the call does not request one.
LISTS_MIN_TIMEOUT_MS	No	Lowest timeout a lists call may request, in milliseconds.
LISTS_MAX_TIMEOUT_MS	No	Highest timeout a lists call may request, in milliseconds.
MEDIA_CHUNK_BYTES	No	Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.
MEDIA_POLL_INTERVAL_MS	No	How often the upload status is polled while X transcodes a video, in milliseconds.
MEDIA_DEFAULT_TIMEOUT_MS	No	Timeout for a whole upload in milliseconds when the call does not request one.
MEDIA_MIN_TIMEOUT_MS	No	Lowest timeout an upload may request, in milliseconds.
MEDIA_MAX_TIMEOUT_MS	No	Highest timeout an upload may request, in milliseconds.
X_API_KEY	Yes	OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.
X_API_KEY_SECRET	Yes	OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.
X_ACCESS_TOKEN	Yes	User 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. Secret.
X_ACCESS_TOKEN_SECRET	Yes	User access token secret, issued together with X_ACCESS_TOKEN. Secret.
MEDIA_ROOT	Yes	Absolute 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_TRANSPORT	No	stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME	No	Server name reported in the MCP initialize handshake.
MCP_PATH	No	HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT	No	TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT	No	HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT	No	HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE	No	local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST	No	Idle connections the outbound HTTP client keeps per host.
X_DEBUG	No	Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.
POSTS_MAX_QUERIES	No	Queries accepted in one x_posts_search or x_posts_count call.
POSTS_MAX_USERNAMES	No	Usernames accepted in one x_posts_by_user call.
POSTS_MAX_IDS	No	Post ids accepted in one x_posts_lookup call. The X API caps this at 100.
POSTS_DEFAULT_RESULTS	No	Posts returned per query when the call does not ask for a count. Every post returned is billed.
POSTS_MAX_RESULTS	No	Upper bound for posts per query. The X API caps this at 100.
POSTS_DEFAULT_DAYS	No	How far back post searches look when the call does not say, in days.
POSTS_MAX_DAYS	No	Furthest back a post search may look, in days. Recent search cannot exceed 7.
POSTS_DEFAULT_TIMEOUT_MS	No	Timeout for a posts call in milliseconds when the call does not request one.
POSTS_MIN_TIMEOUT_MS	No	Lowest timeout a posts call may request, in milliseconds.
POSTS_MAX_TIMEOUT_MS	No	Highest timeout a posts call may request, in milliseconds.
USERS_MAX_USERNAMES	No	Usernames accepted in one x_users_lookup call. The X API caps this at 100.
USERS_MAX_IDS	No	User ids accepted in one x_users_lookup call. The X API caps this at 100.
USERS_DEFAULT_RESULTS	No	Users returned per page when the call does not ask for a count.
USERS_MAX_RESULTS	No	Upper bound for users per page.
USERS_DEFAULT_TIMEOUT_MS	No	Timeout for a users call in milliseconds when the call does not request one.
USERS_MIN_TIMEOUT_MS	No	Lowest timeout a users call may request, in milliseconds.
USERS_MAX_TIMEOUT_MS	No	Highest timeout a users call may request, in milliseconds.
LISTS_DEFAULT_RESULTS	No	Items returned per list page when the call does not ask for a count.
LISTS_MAX_RESULTS	No	Upper bound for items per list page. The X API caps this at 100.
LISTS_DEFAULT_TIMEOUT_MS	No	Timeout for a lists call in milliseconds when the call does not request one.
LISTS_MIN_TIMEOUT_MS	No	Lowest timeout a lists call may request, in milliseconds.
LISTS_MAX_TIMEOUT_MS	No	Highest timeout a lists call may request, in milliseconds.
MEDIA_CHUNK_BYTES	No	Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.
MEDIA_POLL_INTERVAL_MS	No	How often the upload status is polled while X transcodes a video, in milliseconds.
MEDIA_DEFAULT_TIMEOUT_MS	No	Timeout for a whole upload in milliseconds when the call does not request one.
MEDIA_MIN_TIMEOUT_MS	No	Lowest timeout an upload may request, in milliseconds.
MEDIA_MAX_TIMEOUT_MS	No	Highest timeout an upload may request, in milliseconds.
X_API_KEY	Yes	OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.
X_API_KEY_SECRET	Yes	OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.
X_ACCESS_TOKEN	Yes	User 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. Secret.
X_ACCESS_TOKEN_SECRET	Yes	User access token secret, issued together with X_ACCESS_TOKEN. Secret.
MEDIA_ROOT	Yes	Absolute 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_TRANSPORT	No	stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME	No	Server name reported in the MCP initialize handshake.
MCP_PATH	No	HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT	No	TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT	No	HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT	No	HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE	No	local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST	No	Idle connections the outbound HTTP client keeps per host.
X_DEBUG	No	Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.
POSTS_MAX_QUERIES	No	Queries accepted in one x_posts_search or x_posts_count call.
POSTS_MAX_USERNAMES	No	Usernames accepted in one x_posts_by_user call.
POSTS_MAX_IDS	No	Post ids accepted in one x_posts_lookup call. The X API caps this at 100.
POSTS_DEFAULT_RESULTS	No	Posts returned per query when the call does not ask for a count. Every post returned is billed.
POSTS_MAX_RESULTS	No	Upper bound for posts per query. The X API caps this at 100.
POSTS_DEFAULT_DAYS	No	How far back post searches look when the call does not say, in days.
POSTS_MAX_DAYS	No	Furthest back a post search may look, in days. Recent search cannot exceed 7.
POSTS_DEFAULT_TIMEOUT_MS	No	Timeout for a posts call in milliseconds when the call does not request one.
POSTS_MIN_TIMEOUT_MS	No	Lowest timeout a posts call may request, in milliseconds.
POSTS_MAX_TIMEOUT_MS	No	Highest timeout a posts call may request, in milliseconds.
USERS_MAX_USERNAMES	No	Usernames accepted in one x_users_lookup call. The X API caps this at 100.
USERS_MAX_IDS	No	User ids accepted in one x_users_lookup call. The X API caps this at 100.
USERS_DEFAULT_RESULTS	No	Users returned per page when the call does not ask for a count.
USERS_MAX_RESULTS	No	Upper bound for users per page.
USERS_DEFAULT_TIMEOUT_MS	No	Timeout for a users call in milliseconds when the call does not request one.
USERS_MIN_TIMEOUT_MS	No	Lowest timeout a users call may request, in milliseconds.
USERS_MAX_TIMEOUT_MS	No	Highest timeout a users call may request, in milliseconds.
LISTS_DEFAULT_RESULTS	No	Items returned per list page when the call does not ask for a count.
LISTS_MAX_RESULTS	No	Upper bound for items per list page. The X API caps this at 100.
LISTS_DEFAULT_TIMEOUT_MS	No	Timeout for a lists call in milliseconds when the call does not request one.
LISTS_MIN_TIMEOUT_MS	No	Lowest timeout a lists call may request, in milliseconds.
LISTS_MAX_TIMEOUT_MS	No	Highest timeout a lists call may request, in milliseconds.
MEDIA_CHUNK_BYTES	No	Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.
MEDIA_POLL_INTERVAL_MS	No	How often the upload status is polled while X transcodes a video, in milliseconds.
MEDIA_DEFAULT_TIMEOUT_MS	No	Timeout for a whole upload in milliseconds when the call does not request one.
MEDIA_MIN_TIMEOUT_MS	No	Lowest timeout an upload may request, in milliseconds.
MEDIA_MAX_TIMEOUT_MS	No	Highest timeout an upload may request, in milliseconds.
X_API_KEY	Yes	OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.
X_API_KEY_SECRET	Yes	OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.
X_ACCESS_TOKEN	Yes	User 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. Secret.
X_ACCESS_TOKEN_SECRET	Yes	User access token secret, issued together with X_ACCESS_TOKEN. Secret.
MEDIA_ROOT	Yes	Absolute 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_TRANSPORT	No	stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME	No	Server name reported in the MCP initialize handshake.
MCP_PATH	No	HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT	No	TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT	No	HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT	No	HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE	No	local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST	No	Idle connections the outbound HTTP client keeps per host.
X_DEBUG	No	Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.
POSTS_MAX_QUERIES	No	Queries accepted in one x_posts_search or x_posts_count call.
POSTS_MAX_USERNAMES	No	Usernames accepted in one x_posts_by_user call.
POSTS_MAX_IDS	No	Post ids accepted in one x_posts_lookup call. The X API caps this at 100.
POSTS_DEFAULT_RESULTS	No	Posts returned per query when the call does not ask for a count. Every post returned is billed.
POSTS_MAX_RESULTS	No	Upper bound for posts per query. The X API caps this at 100.
POSTS_DEFAULT_DAYS	No	How far back post searches look when the call does not say, in days.
POSTS_MAX_DAYS	No	Furthest back a post search may look, in days. Recent search cannot exceed 7.
POSTS_DEFAULT_TIMEOUT_MS	No	Timeout for a posts call in milliseconds when the call does not request one.
POSTS_MIN_TIMEOUT_MS	No	Lowest timeout a posts call may request, in milliseconds.
POSTS_MAX_TIMEOUT_MS	No	Highest timeout a posts call may request, in milliseconds.
USERS_MAX_USERNAMES	No	Usernames accepted in one x_users_lookup call. The X API caps this at 100.
USERS_MAX_IDS	No	User ids accepted in one x_users_lookup call. The X API caps this at 100.
USERS_DEFAULT_RESULTS	No	Users returned per page when the call does not ask for a count.
USERS_MAX_RESULTS	No	Upper bound for users per page.
USERS_DEFAULT_TIMEOUT_MS	No	Timeout for a users call in milliseconds when the call does not request one.
USERS_MIN_TIMEOUT_MS	No	Lowest timeout a users call may request, in milliseconds.
USERS_MAX_TIMEOUT_MS	No	Highest timeout a users call may request, in milliseconds.
LISTS_DEFAULT_RESULTS	No	Items returned per list page when the call does not ask for a count.
LISTS_MAX_RESULTS	No	Upper bound for items per list page. The X API caps this at 100.
LISTS_DEFAULT_TIMEOUT_MS	No	Timeout for a lists call in milliseconds when the call does not request one.
LISTS_MIN_TIMEOUT_MS	No	Lowest timeout a lists call may request, in milliseconds.
LISTS_MAX_TIMEOUT_MS	No	Highest timeout a lists call may request, in milliseconds.
MEDIA_CHUNK_BYTES	No	Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.
MEDIA_POLL_INTERVAL_MS	No	How often the upload status is polled while X transcodes a video, in milliseconds.
MEDIA_DEFAULT_TIMEOUT_MS	No	Timeout for a whole upload in milliseconds when the call does not request one.
MEDIA_MIN_TIMEOUT_MS	No	Lowest timeout an upload may request, in milliseconds.
MEDIA_MAX_TIMEOUT_MS	No	Highest timeout an upload may request, in milliseconds.
X_API_KEY	Yes	OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.
X_API_KEY_SECRET	Yes	OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.
X_ACCESS_TOKEN	Yes	User 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. Secret.
X_ACCESS_TOKEN_SECRET	Yes	User access token secret, issued together with X_ACCESS_TOKEN. Secret.
MEDIA_ROOT	Yes	Absolute 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_TRANSPORT	No	stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME	No	Server name reported in the MCP initialize handshake.
MCP_PATH	No	HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT	No	TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT	No	HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT	No	HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE	No	local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST	No	Idle connections the outbound HTTP client keeps per host.
X_DEBUG	No	Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.
POSTS_MAX_QUERIES	No	Queries accepted in one x_posts_search or x_posts_count call.
POSTS_MAX_USERNAMES	No	Usernames accepted in one x_posts_by_user call.
POSTS_MAX_IDS	No	Post ids accepted in one x_posts_lookup call. The X API caps this at 100.
POSTS_DEFAULT_RESULTS	No	Posts returned per query when the call does not ask for a count. Every post returned is billed.
POSTS_MAX_RESULTS	No	Upper bound for posts per query. The X API caps this at 100.
POSTS_DEFAULT_DAYS	No	How far back post searches look when the call does not say, in days.
POSTS_MAX_DAYS	No	Furthest back a post search may look, in days. Recent search cannot exceed 7.
POSTS_DEFAULT_TIMEOUT_MS	No	Timeout for a posts call in milliseconds when the call does not request one.
POSTS_MIN_TIMEOUT_MS	No	Lowest timeout a posts call may request, in milliseconds.
POSTS_MAX_TIMEOUT_MS	No	Highest timeout a posts call may request, in milliseconds.
USERS_MAX_USERNAMES	No	Usernames accepted in one x_users_lookup call. The X API caps this at 100.
USERS_MAX_IDS	No	User ids accepted in one x_users_lookup call. The X API caps this at 100.
USERS_DEFAULT_RESULTS	No	Users returned per page when the call does not ask for a count.
USERS_MAX_RESULTS	No	Upper bound for users per page.
USERS_DEFAULT_TIMEOUT_MS	No	Timeout for a users call in milliseconds when the call does not request one.
USERS_MIN_TIMEOUT_MS	No	Lowest timeout a users call may request, in milliseconds.
USERS_MAX_TIMEOUT_MS	No	Highest timeout a users call may request, in milliseconds.
LISTS_DEFAULT_RESULTS	No	Items returned per list page when the call does not ask for a count.
LISTS_MAX_RESULTS	No	Upper bound for items per list page. The X API caps this at 100.
LISTS_DEFAULT_TIMEOUT_MS	No	Timeout for a lists call in milliseconds when the call does not request one.
LISTS_MIN_TIMEOUT_MS	No	Lowest timeout a lists call may request, in milliseconds.
LISTS_MAX_TIMEOUT_MS	No	Highest timeout a lists call may request, in milliseconds.
MEDIA_CHUNK_BYTES	No	Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.
MEDIA_POLL_INTERVAL_MS	No	How often the upload status is polled while X transcodes a video, in milliseconds.
MEDIA_DEFAULT_TIMEOUT_MS	No	Timeout for a whole upload in milliseconds when the call does not request one.
MEDIA_MIN_TIMEOUT_MS	No	Lowest timeout an upload may request, in milliseconds.
MEDIA_MAX_TIMEOUT_MS	No	Highest timeout an upload may request, in milliseconds.
X_API_KEY	Yes	OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.
X_API_KEY_SECRET	Yes	OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.
X_ACCESS_TOKEN	Yes	User 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. Secret.
X_ACCESS_TOKEN_SECRET	Yes	User access token secret, issued together with X_ACCESS_TOKEN. Secret.
MEDIA_ROOT	Yes	Absolute 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_TRANSPORT	No	stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME	No	Server name reported in the MCP initialize handshake.
MCP_PATH	No	HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT	No	TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT	No	HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT	No	HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE	No	local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST	No	Idle connections the outbound HTTP client keeps per host.
X_DEBUG	No	Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.
POSTS_MAX_QUERIES	No	Queries accepted in one x_posts_search or x_posts_count call.
POSTS_MAX_USERNAMES	No	Usernames accepted in one x_posts_by_user call.
POSTS_MAX_IDS	No	Post ids accepted in one x_posts_lookup call. The X API caps this at 100.
POSTS_DEFAULT_RESULTS	No	Posts returned per query when the call does not ask for a count. Every post returned is billed.
POSTS_MAX_RESULTS	No	Upper bound for posts per query. The X API caps this at 100.
POSTS_DEFAULT_DAYS	No	How far back post searches look when the call does not say, in days.
POSTS_MAX_DAYS	No	Furthest back a post search may look, in days. Recent search cannot exceed 7.
POSTS_DEFAULT_TIMEOUT_MS	No	Timeout for a posts call in milliseconds when the call does not request one.
POSTS_MIN_TIMEOUT_MS	No	Lowest timeout a posts call may request, in milliseconds.
POSTS_MAX_TIMEOUT_MS	No	Highest timeout a posts call may request, in milliseconds.
USERS_MAX_USERNAMES	No	Usernames accepted in one x_users_lookup call. The X API caps this at 100.
USERS_MAX_IDS	No	User ids accepted in one x_users_lookup call. The X API caps this at 100.
USERS_DEFAULT_RESULTS	No	Users returned per page when the call does not ask for a count.
USERS_MAX_RESULTS	No	Upper bound for users per page.
USERS_DEFAULT_TIMEOUT_MS	No	Timeout for a users call in milliseconds when the call does not request one.
USERS_MIN_TIMEOUT_MS	No	Lowest timeout a users call may request, in milliseconds.
USERS_MAX_TIMEOUT_MS	No	Highest timeout a users call may request, in milliseconds.
LISTS_DEFAULT_RESULTS	No	Items returned per list page when the call does not ask for a count.
LISTS_MAX_RESULTS	No	Upper bound for items per list page. The X API caps this at 100.
LISTS_DEFAULT_TIMEOUT_MS	No	Timeout for a lists call in milliseconds when the call does not request one.
LISTS_MIN_TIMEOUT_MS	No	Lowest timeout a lists call may request, in milliseconds.
LISTS_MAX_TIMEOUT_MS	No	Highest timeout a lists call may request, in milliseconds.
MEDIA_CHUNK_BYTES	No	Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.
MEDIA_POLL_INTERVAL_MS	No	How often the upload status is polled while X transcodes a video, in milliseconds.
MEDIA_DEFAULT_TIMEOUT_MS	No	Timeout for a whole upload in milliseconds when the call does not request one.
MEDIA_MIN_TIMEOUT_MS	No	Lowest timeout an upload may request, in milliseconds.
MEDIA_MAX_TIMEOUT_MS	No	Highest timeout an upload may request, in milliseconds.
X_API_KEY	Yes	OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.
X_API_KEY_SECRET	Yes	OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.
X_ACCESS_TOKEN	Yes	User 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. Secret.
X_ACCESS_TOKEN_SECRET	Yes	User access token secret, issued together with X_ACCESS_TOKEN. Secret.
MEDIA_ROOT	Yes	Absolute 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_TRANSPORT	No	stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME	No	Server name reported in the MCP initialize handshake.
MCP_PATH	No	HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT	No	TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT	No	HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT	No	HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE	No	local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST	No	Idle connections the outbound HTTP client keeps per host.
X_DEBUG	No	Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.
POSTS_MAX_QUERIES	No	Queries accepted in one x_posts_search or x_posts_count call.
POSTS_MAX_USERNAMES	No	Usernames accepted in one x_posts_by_user call.
POSTS_MAX_IDS	No	Post ids accepted in one x_posts_lookup call. The X API caps this at 100.
POSTS_DEFAULT_RESULTS	No	Posts returned per query when the call does not ask for a count. Every post returned is billed.
POSTS_MAX_RESULTS	No	Upper bound for posts per query. The X API caps this at 100.
POSTS_DEFAULT_DAYS	No	How far back post searches look when the call does not say, in days.
POSTS_MAX_DAYS	No	Furthest back a post search may look, in days. Recent search cannot exceed 7.
POSTS_DEFAULT_TIMEOUT_MS	No	Timeout for a posts call in milliseconds when the call does not request one.
POSTS_MIN_TIMEOUT_MS	No	Lowest timeout a posts call may request, in milliseconds.
POSTS_MAX_TIMEOUT_MS	No	Highest timeout a posts call may request, in milliseconds.
USERS_MAX_USERNAMES	No	Usernames accepted in one x_users_lookup call. The X API caps this at 100.
USERS_MAX_IDS	No	User ids accepted in one x_users_lookup call. The X API caps this at 100.
USERS_DEFAULT_RESULTS	No	Users returned per page when the call does not ask for a count.
USERS_MAX_RESULTS	No	Upper bound for users per page.
USERS_DEFAULT_TIMEOUT_MS	No	Timeout for a users call in milliseconds when the call does not request one.
USERS_MIN_TIMEOUT_MS	No	Lowest timeout a users call may request, in milliseconds.
USERS_MAX_TIMEOUT_MS	No	Highest timeout a users call may request, in milliseconds.
LISTS_DEFAULT_RESULTS	No	Items returned per list page when the call does not ask for a count.
LISTS_MAX_RESULTS	No	Upper bound for items per list page. The X API caps this at 100.
LISTS_DEFAULT_TIMEOUT_MS	No	Timeout for a lists call in milliseconds when the call does not request one.
LISTS_MIN_TIMEOUT_MS	No	Lowest timeout a lists call may request, in milliseconds.
LISTS_MAX_TIMEOUT_MS	No	Highest timeout a lists call may request, in milliseconds.
MEDIA_CHUNK_BYTES	No	Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.
MEDIA_POLL_INTERVAL_MS	No	How often the upload status is polled while X transcodes a video, in milliseconds.
MEDIA_DEFAULT_TIMEOUT_MS	No	Timeout for a whole upload in milliseconds when the call does not request one.
MEDIA_MIN_TIMEOUT_MS	No	Lowest timeout an upload may request, in milliseconds.
MEDIA_MAX_TIMEOUT_MS	No	Highest timeout an upload may request, in milliseconds.

Name

Required

Notes

X_API_KEY

Yes

OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.

X_API_KEY_SECRET

Yes

OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.

X_ACCESS_TOKEN

Yes

User 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. Secret.

X_ACCESS_TOKEN_SECRET

Yes

User access token secret, issued together with X_ACCESS_TOKEN. Secret.

MEDIA_ROOT

Yes

Absolute 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_TRANSPORT

stdio (client spawns the process) or http (streamable HTTP listener).

MCP_NAME

Server name reported in the MCP initialize handshake.

MCP_PATH

HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.

SERVER_PORT

TCP port to listen on. Used only when MCP_TRANSPORT=http.

SERVER_READ_TIMEOUT

HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.

SERVER_WRITE_TIMEOUT

HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.

LOG_MODE

local (text, debug) or prod (JSON, info). Logs go to stderr.

MAX_IDLE_CONNS_PER_HOST

Idle connections the outbound HTTP client keeps per host.

X_DEBUG

Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.

POSTS_MAX_QUERIES

Queries accepted in one x_posts_search or x_posts_count call.

POSTS_MAX_USERNAMES

Usernames accepted in one x_posts_by_user call.

POSTS_MAX_IDS

Post ids accepted in one x_posts_lookup call. The X API caps this at 100.

POSTS_DEFAULT_RESULTS

Posts returned per query when the call does not ask for a count. Every post returned is billed.

POSTS_MAX_RESULTS

Upper bound for posts per query. The X API caps this at 100.

POSTS_DEFAULT_DAYS

How far back post searches look when the call does not say, in days.

POSTS_MAX_DAYS

Furthest back a post search may look, in days. Recent search cannot exceed 7.

POSTS_DEFAULT_TIMEOUT_MS

Timeout for a posts call in milliseconds when the call does not request one.

POSTS_MIN_TIMEOUT_MS

Lowest timeout a posts call may request, in milliseconds.

POSTS_MAX_TIMEOUT_MS

Highest timeout a posts call may request, in milliseconds.

USERS_MAX_USERNAMES

Usernames accepted in one x_users_lookup call. The X API caps this at 100.

USERS_MAX_IDS

User ids accepted in one x_users_lookup call. The X API caps this at 100.

USERS_DEFAULT_RESULTS

Users returned per page when the call does not ask for a count.

USERS_MAX_RESULTS

Upper bound for users per page.

USERS_DEFAULT_TIMEOUT_MS

Timeout for a users call in milliseconds when the call does not request one.

USERS_MIN_TIMEOUT_MS

Lowest timeout a users call may request, in milliseconds.

USERS_MAX_TIMEOUT_MS

Highest timeout a users call may request, in milliseconds.

LISTS_DEFAULT_RESULTS

Items returned per list page when the call does not ask for a count.

LISTS_MAX_RESULTS

Upper bound for items per list page. The X API caps this at 100.

LISTS_DEFAULT_TIMEOUT_MS

Timeout for a lists call in milliseconds when the call does not request one.

LISTS_MIN_TIMEOUT_MS

Lowest timeout a lists call may request, in milliseconds.

LISTS_MAX_TIMEOUT_MS

Highest timeout a lists call may request, in milliseconds.

MEDIA_CHUNK_BYTES

Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.

MEDIA_POLL_INTERVAL_MS

How often the upload status is polled while X transcodes a video, in milliseconds.

MEDIA_DEFAULT_TIMEOUT_MS

Timeout for a whole upload in milliseconds when the call does not request one.

MEDIA_MIN_TIMEOUT_MS

Lowest timeout an upload may request, in milliseconds.

MEDIA_MAX_TIMEOUT_MS

Highest timeout an upload may request, in milliseconds.

X_API_KEY

Yes

OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.

X_API_KEY_SECRET

Yes

OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.

X_ACCESS_TOKEN

Yes

X_ACCESS_TOKEN_SECRET

Yes

User access token secret, issued together with X_ACCESS_TOKEN. Secret.

MEDIA_ROOT

Yes

Absolute 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_TRANSPORT

stdio (client spawns the process) or http (streamable HTTP listener).

MCP_NAME

Server name reported in the MCP initialize handshake.

MCP_PATH

HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.

SERVER_PORT

TCP port to listen on. Used only when MCP_TRANSPORT=http.

SERVER_READ_TIMEOUT

HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.

SERVER_WRITE_TIMEOUT

HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.

LOG_MODE

local (text, debug) or prod (JSON, info). Logs go to stderr.

MAX_IDLE_CONNS_PER_HOST

Idle connections the outbound HTTP client keeps per host.

X_DEBUG

Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.

POSTS_MAX_QUERIES

Queries accepted in one x_posts_search or x_posts_count call.

POSTS_MAX_USERNAMES

Usernames accepted in one x_posts_by_user call.

POSTS_MAX_IDS

Post ids accepted in one x_posts_lookup call. The X API caps this at 100.

POSTS_DEFAULT_RESULTS

Posts returned per query when the call does not ask for a count. Every post returned is billed.

POSTS_MAX_RESULTS

Upper bound for posts per query. The X API caps this at 100.

POSTS_DEFAULT_DAYS

How far back post searches look when the call does not say, in days.

POSTS_MAX_DAYS

Furthest back a post search may look, in days. Recent search cannot exceed 7.

POSTS_DEFAULT_TIMEOUT_MS

Timeout for a posts call in milliseconds when the call does not request one.

POSTS_MIN_TIMEOUT_MS

Lowest timeout a posts call may request, in milliseconds.

POSTS_MAX_TIMEOUT_MS

Highest timeout a posts call may request, in milliseconds.

USERS_MAX_USERNAMES

Usernames accepted in one x_users_lookup call. The X API caps this at 100.

USERS_MAX_IDS

User ids accepted in one x_users_lookup call. The X API caps this at 100.

USERS_DEFAULT_RESULTS

Users returned per page when the call does not ask for a count.

USERS_MAX_RESULTS

Upper bound for users per page.

USERS_DEFAULT_TIMEOUT_MS

Timeout for a users call in milliseconds when the call does not request one.

USERS_MIN_TIMEOUT_MS

Lowest timeout a users call may request, in milliseconds.

USERS_MAX_TIMEOUT_MS

Highest timeout a users call may request, in milliseconds.

LISTS_DEFAULT_RESULTS

Items returned per list page when the call does not ask for a count.

LISTS_MAX_RESULTS

Upper bound for items per list page. The X API caps this at 100.

LISTS_DEFAULT_TIMEOUT_MS

Timeout for a lists call in milliseconds when the call does not request one.

LISTS_MIN_TIMEOUT_MS

Lowest timeout a lists call may request, in milliseconds.

LISTS_MAX_TIMEOUT_MS

Highest timeout a lists call may request, in milliseconds.

MEDIA_CHUNK_BYTES

Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.

MEDIA_POLL_INTERVAL_MS

How often the upload status is polled while X transcodes a video, in milliseconds.

MEDIA_DEFAULT_TIMEOUT_MS

Timeout for a whole upload in milliseconds when the call does not request one.

MEDIA_MIN_TIMEOUT_MS

Lowest timeout an upload may request, in milliseconds.

MEDIA_MAX_TIMEOUT_MS

Highest timeout an upload may request, in milliseconds.

X_API_KEY

Yes

OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.

X_API_KEY_SECRET

Yes

OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.

X_ACCESS_TOKEN

Yes

X_ACCESS_TOKEN_SECRET

Yes

User access token secret, issued together with X_ACCESS_TOKEN. Secret.

MEDIA_ROOT

Yes

Absolute 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_TRANSPORT

stdio (client spawns the process) or http (streamable HTTP listener).

MCP_NAME

Server name reported in the MCP initialize handshake.

MCP_PATH

HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.

SERVER_PORT

TCP port to listen on. Used only when MCP_TRANSPORT=http.

SERVER_READ_TIMEOUT

HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.

SERVER_WRITE_TIMEOUT

HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.

LOG_MODE

local (text, debug) or prod (JSON, info). Logs go to stderr.

MAX_IDLE_CONNS_PER_HOST

Idle connections the outbound HTTP client keeps per host.

X_DEBUG

Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.

POSTS_MAX_QUERIES

Queries accepted in one x_posts_search or x_posts_count call.

POSTS_MAX_USERNAMES

Usernames accepted in one x_posts_by_user call.

POSTS_MAX_IDS

Post ids accepted in one x_posts_lookup call. The X API caps this at 100.

POSTS_DEFAULT_RESULTS

Posts returned per query when the call does not ask for a count. Every post returned is billed.

POSTS_MAX_RESULTS

Upper bound for posts per query. The X API caps this at 100.

POSTS_DEFAULT_DAYS

How far back post searches look when the call does not say, in days.

POSTS_MAX_DAYS

Furthest back a post search may look, in days. Recent search cannot exceed 7.

POSTS_DEFAULT_TIMEOUT_MS

Timeout for a posts call in milliseconds when the call does not request one.

POSTS_MIN_TIMEOUT_MS

Lowest timeout a posts call may request, in milliseconds.

POSTS_MAX_TIMEOUT_MS

Highest timeout a posts call may request, in milliseconds.

USERS_MAX_USERNAMES

Usernames accepted in one x_users_lookup call. The X API caps this at 100.

USERS_MAX_IDS

User ids accepted in one x_users_lookup call. The X API caps this at 100.

USERS_DEFAULT_RESULTS

Users returned per page when the call does not ask for a count.

USERS_MAX_RESULTS

Upper bound for users per page.

USERS_DEFAULT_TIMEOUT_MS

Timeout for a users call in milliseconds when the call does not request one.

USERS_MIN_TIMEOUT_MS

Lowest timeout a users call may request, in milliseconds.

USERS_MAX_TIMEOUT_MS

Highest timeout a users call may request, in milliseconds.

LISTS_DEFAULT_RESULTS

Items returned per list page when the call does not ask for a count.

LISTS_MAX_RESULTS

Upper bound for items per list page. The X API caps this at 100.

LISTS_DEFAULT_TIMEOUT_MS

Timeout for a lists call in milliseconds when the call does not request one.

LISTS_MIN_TIMEOUT_MS

Lowest timeout a lists call may request, in milliseconds.

LISTS_MAX_TIMEOUT_MS

Highest timeout a lists call may request, in milliseconds.

MEDIA_CHUNK_BYTES

Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.

MEDIA_POLL_INTERVAL_MS

How often the upload status is polled while X transcodes a video, in milliseconds.

MEDIA_DEFAULT_TIMEOUT_MS

Timeout for a whole upload in milliseconds when the call does not request one.

MEDIA_MIN_TIMEOUT_MS

Lowest timeout an upload may request, in milliseconds.

MEDIA_MAX_TIMEOUT_MS

Highest timeout an upload may request, in milliseconds.

X_API_KEY

Yes

OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.

X_API_KEY_SECRET

Yes

OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.

X_ACCESS_TOKEN

Yes

X_ACCESS_TOKEN_SECRET

Yes

User access token secret, issued together with X_ACCESS_TOKEN. Secret.

MEDIA_ROOT

Yes

Absolute 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_TRANSPORT

stdio (client spawns the process) or http (streamable HTTP listener).

MCP_NAME

Server name reported in the MCP initialize handshake.

MCP_PATH

HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.

SERVER_PORT

TCP port to listen on. Used only when MCP_TRANSPORT=http.

SERVER_READ_TIMEOUT

HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.

SERVER_WRITE_TIMEOUT

HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.

LOG_MODE

local (text, debug) or prod (JSON, info). Logs go to stderr.

MAX_IDLE_CONNS_PER_HOST

Idle connections the outbound HTTP client keeps per host.

X_DEBUG

Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.

POSTS_MAX_QUERIES

Queries accepted in one x_posts_search or x_posts_count call.

POSTS_MAX_USERNAMES

Usernames accepted in one x_posts_by_user call.

POSTS_MAX_IDS

Post ids accepted in one x_posts_lookup call. The X API caps this at 100.

POSTS_DEFAULT_RESULTS

Posts returned per query when the call does not ask for a count. Every post returned is billed.

POSTS_MAX_RESULTS

Upper bound for posts per query. The X API caps this at 100.

POSTS_DEFAULT_DAYS

How far back post searches look when the call does not say, in days.

POSTS_MAX_DAYS

Furthest back a post search may look, in days. Recent search cannot exceed 7.

POSTS_DEFAULT_TIMEOUT_MS

Timeout for a posts call in milliseconds when the call does not request one.

POSTS_MIN_TIMEOUT_MS

Lowest timeout a posts call may request, in milliseconds.

POSTS_MAX_TIMEOUT_MS

Highest timeout a posts call may request, in milliseconds.

USERS_MAX_USERNAMES

Usernames accepted in one x_users_lookup call. The X API caps this at 100.

USERS_MAX_IDS

User ids accepted in one x_users_lookup call. The X API caps this at 100.

USERS_DEFAULT_RESULTS

Users returned per page when the call does not ask for a count.

USERS_MAX_RESULTS

Upper bound for users per page.

USERS_DEFAULT_TIMEOUT_MS

Timeout for a users call in milliseconds when the call does not request one.

USERS_MIN_TIMEOUT_MS

Lowest timeout a users call may request, in milliseconds.

USERS_MAX_TIMEOUT_MS

Highest timeout a users call may request, in milliseconds.

LISTS_DEFAULT_RESULTS

Items returned per list page when the call does not ask for a count.

LISTS_MAX_RESULTS

Upper bound for items per list page. The X API caps this at 100.

LISTS_DEFAULT_TIMEOUT_MS

Timeout for a lists call in milliseconds when the call does not request one.

LISTS_MIN_TIMEOUT_MS

Lowest timeout a lists call may request, in milliseconds.

LISTS_MAX_TIMEOUT_MS

Highest timeout a lists call may request, in milliseconds.

MEDIA_CHUNK_BYTES

Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.

MEDIA_POLL_INTERVAL_MS

How often the upload status is polled while X transcodes a video, in milliseconds.

MEDIA_DEFAULT_TIMEOUT_MS

Timeout for a whole upload in milliseconds when the call does not request one.

MEDIA_MIN_TIMEOUT_MS

Lowest timeout an upload may request, in milliseconds.

MEDIA_MAX_TIMEOUT_MS

Highest timeout an upload may request, in milliseconds.

X_API_KEY

Yes

OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.

X_API_KEY_SECRET

Yes

OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.

X_ACCESS_TOKEN

Yes

X_ACCESS_TOKEN_SECRET

Yes

User access token secret, issued together with X_ACCESS_TOKEN. Secret.

MEDIA_ROOT

Yes

Absolute 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_TRANSPORT

stdio (client spawns the process) or http (streamable HTTP listener).

MCP_NAME

Server name reported in the MCP initialize handshake.

MCP_PATH

HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.

SERVER_PORT

TCP port to listen on. Used only when MCP_TRANSPORT=http.

SERVER_READ_TIMEOUT

HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.

SERVER_WRITE_TIMEOUT

HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.

LOG_MODE

local (text, debug) or prod (JSON, info). Logs go to stderr.

MAX_IDLE_CONNS_PER_HOST

Idle connections the outbound HTTP client keeps per host.

X_DEBUG

Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.

POSTS_MAX_QUERIES

Queries accepted in one x_posts_search or x_posts_count call.

POSTS_MAX_USERNAMES

Usernames accepted in one x_posts_by_user call.

POSTS_MAX_IDS

Post ids accepted in one x_posts_lookup call. The X API caps this at 100.

POSTS_DEFAULT_RESULTS

Posts returned per query when the call does not ask for a count. Every post returned is billed.

POSTS_MAX_RESULTS

Upper bound for posts per query. The X API caps this at 100.

POSTS_DEFAULT_DAYS

How far back post searches look when the call does not say, in days.

POSTS_MAX_DAYS

Furthest back a post search may look, in days. Recent search cannot exceed 7.

POSTS_DEFAULT_TIMEOUT_MS

Timeout for a posts call in milliseconds when the call does not request one.

POSTS_MIN_TIMEOUT_MS

Lowest timeout a posts call may request, in milliseconds.

POSTS_MAX_TIMEOUT_MS

Highest timeout a posts call may request, in milliseconds.

USERS_MAX_USERNAMES

Usernames accepted in one x_users_lookup call. The X API caps this at 100.

USERS_MAX_IDS

User ids accepted in one x_users_lookup call. The X API caps this at 100.

USERS_DEFAULT_RESULTS

Users returned per page when the call does not ask for a count.

USERS_MAX_RESULTS

Upper bound for users per page.

USERS_DEFAULT_TIMEOUT_MS

Timeout for a users call in milliseconds when the call does not request one.

USERS_MIN_TIMEOUT_MS

Lowest timeout a users call may request, in milliseconds.

USERS_MAX_TIMEOUT_MS

Highest timeout a users call may request, in milliseconds.

LISTS_DEFAULT_RESULTS

Items returned per list page when the call does not ask for a count.

LISTS_MAX_RESULTS

Upper bound for items per list page. The X API caps this at 100.

LISTS_DEFAULT_TIMEOUT_MS

Timeout for a lists call in milliseconds when the call does not request one.

LISTS_MIN_TIMEOUT_MS

Lowest timeout a lists call may request, in milliseconds.

LISTS_MAX_TIMEOUT_MS

Highest timeout a lists call may request, in milliseconds.

MEDIA_CHUNK_BYTES

Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.

MEDIA_POLL_INTERVAL_MS

How often the upload status is polled while X transcodes a video, in milliseconds.

MEDIA_DEFAULT_TIMEOUT_MS

Timeout for a whole upload in milliseconds when the call does not request one.

MEDIA_MIN_TIMEOUT_MS

Lowest timeout an upload may request, in milliseconds.

MEDIA_MAX_TIMEOUT_MS

Highest timeout an upload may request, in milliseconds.

X_API_KEY

Yes

OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.

X_API_KEY_SECRET

Yes

OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.

X_ACCESS_TOKEN

Yes

X_ACCESS_TOKEN_SECRET

Yes

User access token secret, issued together with X_ACCESS_TOKEN. Secret.

MEDIA_ROOT

Yes

Absolute 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_TRANSPORT

stdio (client spawns the process) or http (streamable HTTP listener).

MCP_NAME

Server name reported in the MCP initialize handshake.

MCP_PATH

HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.

SERVER_PORT

TCP port to listen on. Used only when MCP_TRANSPORT=http.

SERVER_READ_TIMEOUT

HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.

SERVER_WRITE_TIMEOUT

HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.

LOG_MODE

local (text, debug) or prod (JSON, info). Logs go to stderr.

MAX_IDLE_CONNS_PER_HOST

Idle connections the outbound HTTP client keeps per host.

X_DEBUG

Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.

POSTS_MAX_QUERIES

Queries accepted in one x_posts_search or x_posts_count call.

POSTS_MAX_USERNAMES

Usernames accepted in one x_posts_by_user call.

POSTS_MAX_IDS

Post ids accepted in one x_posts_lookup call. The X API caps this at 100.

POSTS_DEFAULT_RESULTS

Posts returned per query when the call does not ask for a count. Every post returned is billed.

POSTS_MAX_RESULTS

Upper bound for posts per query. The X API caps this at 100.

POSTS_DEFAULT_DAYS

How far back post searches look when the call does not say, in days.

POSTS_MAX_DAYS

Furthest back a post search may look, in days. Recent search cannot exceed 7.

POSTS_DEFAULT_TIMEOUT_MS

Timeout for a posts call in milliseconds when the call does not request one.

POSTS_MIN_TIMEOUT_MS

Lowest timeout a posts call may request, in milliseconds.

POSTS_MAX_TIMEOUT_MS

Highest timeout a posts call may request, in milliseconds.

USERS_MAX_USERNAMES

Usernames accepted in one x_users_lookup call. The X API caps this at 100.

USERS_MAX_IDS

User ids accepted in one x_users_lookup call. The X API caps this at 100.

USERS_DEFAULT_RESULTS

Users returned per page when the call does not ask for a count.

USERS_MAX_RESULTS

Upper bound for users per page.

USERS_DEFAULT_TIMEOUT_MS

Timeout for a users call in milliseconds when the call does not request one.

USERS_MIN_TIMEOUT_MS

Lowest timeout a users call may request, in milliseconds.

USERS_MAX_TIMEOUT_MS

Highest timeout a users call may request, in milliseconds.

LISTS_DEFAULT_RESULTS

Items returned per list page when the call does not ask for a count.

LISTS_MAX_RESULTS

Upper bound for items per list page. The X API caps this at 100.

LISTS_DEFAULT_TIMEOUT_MS

Timeout for a lists call in milliseconds when the call does not request one.

LISTS_MIN_TIMEOUT_MS

Lowest timeout a lists call may request, in milliseconds.

LISTS_MAX_TIMEOUT_MS

Highest timeout a lists call may request, in milliseconds.

MEDIA_CHUNK_BYTES

Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.

MEDIA_POLL_INTERVAL_MS

How often the upload status is polled while X transcodes a video, in milliseconds.

MEDIA_DEFAULT_TIMEOUT_MS

Timeout for a whole upload in milliseconds when the call does not request one.

MEDIA_MIN_TIMEOUT_MS

Lowest timeout an upload may request, in milliseconds.

MEDIA_MAX_TIMEOUT_MS

Highest timeout an upload may request, in milliseconds.

X_API_KEY

Yes

OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens. Secret.

X_API_KEY_SECRET

Yes

OAuth 1.0a consumer secret, issued together with X_API_KEY. Secret.

X_ACCESS_TOKEN

Yes

X_ACCESS_TOKEN_SECRET

Yes

User access token secret, issued together with X_ACCESS_TOKEN. Secret.

MEDIA_ROOT

Yes

Absolute 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_TRANSPORT

stdio (client spawns the process) or http (streamable HTTP listener).

MCP_NAME

Server name reported in the MCP initialize handshake.

MCP_PATH

HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.

SERVER_PORT

TCP port to listen on. Used only when MCP_TRANSPORT=http.

SERVER_READ_TIMEOUT

HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.

SERVER_WRITE_TIMEOUT

HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.

LOG_MODE

local (text, debug) or prod (JSON, info). Logs go to stderr.

MAX_IDLE_CONNS_PER_HOST

Idle connections the outbound HTTP client keeps per host.

X_DEBUG

Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.

POSTS_MAX_QUERIES

Queries accepted in one x_posts_search or x_posts_count call.

POSTS_MAX_USERNAMES

Usernames accepted in one x_posts_by_user call.

POSTS_MAX_IDS

Post ids accepted in one x_posts_lookup call. The X API caps this at 100.

POSTS_DEFAULT_RESULTS

Posts returned per query when the call does not ask for a count. Every post returned is billed.

POSTS_MAX_RESULTS

Upper bound for posts per query. The X API caps this at 100.

POSTS_DEFAULT_DAYS

How far back post searches look when the call does not say, in days.

POSTS_MAX_DAYS

Furthest back a post search may look, in days. Recent search cannot exceed 7.

POSTS_DEFAULT_TIMEOUT_MS

Timeout for a posts call in milliseconds when the call does not request one.

POSTS_MIN_TIMEOUT_MS

Lowest timeout a posts call may request, in milliseconds.

POSTS_MAX_TIMEOUT_MS

Highest timeout a posts call may request, in milliseconds.

USERS_MAX_USERNAMES

Usernames accepted in one x_users_lookup call. The X API caps this at 100.

USERS_MAX_IDS

User ids accepted in one x_users_lookup call. The X API caps this at 100.

USERS_DEFAULT_RESULTS

Users returned per page when the call does not ask for a count.

USERS_MAX_RESULTS

Upper bound for users per page.

USERS_DEFAULT_TIMEOUT_MS

Timeout for a users call in milliseconds when the call does not request one.

USERS_MIN_TIMEOUT_MS

Lowest timeout a users call may request, in milliseconds.

USERS_MAX_TIMEOUT_MS

Highest timeout a users call may request, in milliseconds.

LISTS_DEFAULT_RESULTS

Items returned per list page when the call does not ask for a count.

LISTS_MAX_RESULTS

Upper bound for items per list page. The X API caps this at 100.

LISTS_DEFAULT_TIMEOUT_MS

Timeout for a lists call in milliseconds when the call does not request one.

LISTS_MIN_TIMEOUT_MS

Lowest timeout a lists call may request, in milliseconds.

LISTS_MAX_TIMEOUT_MS

Highest timeout a lists call may request, in milliseconds.

MEDIA_CHUNK_BYTES

Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.

MEDIA_POLL_INTERVAL_MS

How often the upload status is polled while X transcodes a video, in milliseconds.

MEDIA_DEFAULT_TIMEOUT_MS

Timeout for a whole upload in milliseconds when the call does not request one.

MEDIA_MIN_TIMEOUT_MS

Lowest timeout an upload may request, in milliseconds.

MEDIA_MAX_TIMEOUT_MS

Highest timeout an upload may request, in milliseconds.

X (Twitter) MCP Server

Install

Related servers

Firecrawl MCP Server

Zotero MCP

Environment

Tools

About

FAQ

Reviews

haiku.rag

M3 Memory

doc-scraper

Onyx MCP