# X (Twitter)

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

- name: io.github.Role1776/mcp-x
- version: 0.1.1
- connection class: L0 (run_local_package)
- trust: 90/100
- quality: –/100 (not scored)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.Role1776%2Fmcp-x
- tools: https://api.protogrid.dev/v1/servers/io.github.Role1776%2Fmcp-x/tools

**Runs on your machine: something must execute the package.** Only local packages are published (npm, PyPI, OCI, …). The registry never executes them, so tools are unknown until you run it.

## Connection (mcpServers)

```json
{
  "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",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "MCP_NAME",
        "-e",
        "MCP_PATH",
        "-e",
        "SERVER_PORT",
        "-e",
        "SERVER_READ_TIMEOUT",
        "-e",
        "SERVER_WRITE_TIMEOUT",
        "-e",
        "LOG_MODE",
        "-e",
        "MAX_IDLE_CONNS_PER_HOST",
        "-e",
        "X_DEBUG",
        "-e",
        "POSTS_MAX_QUERIES",
        "-e",
        "POSTS_MAX_USERNAMES",
        "-e",
        "POSTS_MAX_IDS",
        "-e",
        "POSTS_DEFAULT_RESULTS",
        "-e",
        "POSTS_MAX_RESULTS",
        "-e",
        "POSTS_DEFAULT_DAYS",
        "-e",
        "POSTS_MAX_DAYS",
        "-e",
        "POSTS_DEFAULT_TIMEOUT_MS",
        "-e",
        "POSTS_MIN_TIMEOUT_MS",
        "-e",
        "POSTS_MAX_TIMEOUT_MS",
        "-e",
        "USERS_MAX_USERNAMES",
        "-e",
        "USERS_MAX_IDS",
        "-e",
        "USERS_DEFAULT_RESULTS",
        "-e",
        "USERS_MAX_RESULTS",
        "-e",
        "USERS_DEFAULT_TIMEOUT_MS",
        "-e",
        "USERS_MIN_TIMEOUT_MS",
        "-e",
        "USERS_MAX_TIMEOUT_MS",
        "-e",
        "LISTS_DEFAULT_RESULTS",
        "-e",
        "LISTS_MAX_RESULTS",
        "-e",
        "LISTS_DEFAULT_TIMEOUT_MS",
        "-e",
        "LISTS_MIN_TIMEOUT_MS",
        "-e",
        "LISTS_MAX_TIMEOUT_MS",
        "-e",
        "MEDIA_CHUNK_BYTES",
        "-e",
        "MEDIA_POLL_INTERVAL_MS",
        "-e",
        "MEDIA_DEFAULT_TIMEOUT_MS",
        "-e",
        "MEDIA_MIN_TIMEOUT_MS",
        "-e",
        "MEDIA_MAX_TIMEOUT_MS",
        "ghcr.io/role1776/mcp-x:0.1.1"
      ],
      "env": {
        "X_API_KEY": "${X_API_KEY}",
        "X_API_KEY_SECRET": "${X_API_KEY_SECRET}",
        "X_ACCESS_TOKEN": "${X_ACCESS_TOKEN}",
        "X_ACCESS_TOKEN_SECRET": "${X_ACCESS_TOKEN_SECRET}",
        "MEDIA_ROOT": "${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"
      }
    }
  }
}
```

Placeholders to fill: `${X_API_KEY}`, `${X_API_KEY_SECRET}`, `${X_ACCESS_TOKEN}`, `${X_ACCESS_TOKEN_SECRET}`.

## Trust

- hygiene: 95
- liveness: n/a
- freshness: 85
- provenance: 90
- drivers: +repository +namespace-matches-repo +website ~liveness-unmeasured ~updated-41d-ago -unpinned-packages(1)
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality –/100 (not scored)

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

### protocol: n/a (weight 25)

- n/a `protocol.modern`, `protocol.stateless`, `protocol.transport`, `protocol.list_ttl`: no remote answered a protocol handshake (not probed yet, unreachable, or local-only)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: n/a (weight 30)

- n/a `tools.descriptions`, `tools.description_length`, `tools.schemas`, `tools.annotations`, `tools.directory_hints`, `tools.token_cost`, `tools.api_dump`: tool list unknown (behind auth, not probed, or empty)

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool list unknown

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: unknown
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.Role1776/mcp-x.svg)](https://protogrid.dev/servers/io.github.Role1776/mcp-x)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

_none_

## Packages

- oci ghcr.io/role1776/mcp-x:0.1.1 secrets: X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET
- mcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_darwin_amd64.mcpb@0.1.1 secrets: X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET
- mcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_darwin_arm64.mcpb@0.1.1 secrets: X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET
- mcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_linux_amd64.mcpb@0.1.1 secrets: X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET
- mcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_linux_arm64.mcpb@0.1.1 secrets: X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET
- mcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_windows_amd64.mcpb@0.1.1 secrets: X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET
- mcpb https://github.com/Role1776/mcp-x/releases/download/v0.1.1/mcp-x_0.1.1_windows_arm64.mcpb@0.1.1 secrets: X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET

## Tools (0)

_none observed_
