xeng-mcp

MCP gateway for searching X/Twitter tweets stored in x-engine.

Install

npx -y xeng-mcp@latest --version

Host config (credentials and upstream are host-owned — do not bake them into skills):

{
  "mcpServers": {
    "x-engine": {
      "command": "npx",
      "args": ["-y", "xeng-mcp@latest"],
      "env": {
        "XENG_API_KEY": "<consumer-api-key>",
        "XENG_BASE_URL": "<x-engine-base-url>",
        "XENG_TIMEOUT": "60s"
      }
    }
  }
}

See mcp.json.example.

Related MCP server: X MCP Server

Environment

Flags: --api-key, --xeng-base-url, --timeout, --stdio, serve / --http.

Tools

Authenticated calls include X-Client-Type: mcp for x-engine rate-limit profiling.

Skill

skills/x-social/SKILL.md — /x-social procedures for clustering, trends, campaigns, and market/sales reading. Install into the agent skills path with this MCP enabled.

CLI

xeng-mcp version
xeng-mcp help
xeng-mcp update
xeng-mcp --stdio
xeng-mcp serve

Development

make install && make check && make build
cp .env.example .env
make stdio

Node ≥ 20.

License

MIT