Skip to main content
Glama
hinha

xeng-mcp

by hinha
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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

Variable

Required

Description

XENG_API_KEY

yes (stdio)

Consumer API key (Authorization: Bearer …)

XENG_BASE_URL

no

Upstream x-engine base (host default if unset)

XENG_TIMEOUT

no

Upstream timeout (60s, 5m, or ms)

XENG_HOST / XENG_PORT

no

HTTP serve bind

XENG_LOG_LEVEL

no

debug | info | warn | error

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

Tools

Tool

Role

xeng_search

Tweet search + filters

xeng_health

Liveness

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • X (Twitter) MCP Server

    Dishant27
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with X (formerly Twitter), allowing for posting tweets, searching content, managing accounts, and organizing lists.
    14 npm
    3
    MIT

  • X MCP Server

    krishna-paulraj
    F
    license
    B
    quality
    D
    maintenance
    Enables users to interact with X (Twitter) through the X API. Supports posting tweets, retrieving user timelines, searching tweets, and replying to tweets with comprehensive error handling.
    3
    6 npm
    -

  • x-mcp

    windsornguyen
    A
    license
    Not graded
    quality
    D
    maintenance
    A read-only X/Twitter MCP server that enables data retrieval for user profiles, tweets, and social graphs using OAuth 2.0 Bearer Token authentication. It supports searching recent tweets, viewing timelines, and tracking engagement metrics like followers, likes, and retweets.
    3
    MIT

  • x-search-mcp

    toocheap
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables real-time search of X (Twitter) posts, user timelines, and trends using either xAI's Responses API or the official X API v2.
    4
    -