X / Twitter MCP

LobeHub 用户请使用 LobeHub setup / 接入说明，包含专属官网入口、认证和来源配置。

This public listing provides connection metadata and client examples for the hosted SocialDataX X / Twitter MCP service. The implementation is privately hosted; this directory contains public connection materials only.

Service

• Hosted MCP endpoint: https://mcp.socialdatax.com/x/mcp

• Hosted transport: streamable-http

• Authentication: Authorization: Bearer <SOCIALDATAX_API_KEY>

• Product: SocialDataX / 社媒数据助手

• Website and API Key access: https://socialdatax.com/ai?from=github

• Registry name: com.52choujiang/x-insights

• Future registry name: com.socialdatax/x-insights

• Local metadata: 0.1.4 with 21 tools, including authored user replies.

• Hosted production: 0.1.4 with 21 tools; initialize/server-card verified after deployment on 2026-10-16. All three user-replies entry points, continuation and HTTP were verified on the same day.

• Official Registry: 0.1.4, verified active and latest on 2026-10-16.

Related MCP server: X Twitter Scraper

Scope

Use this service for public X / Twitter post search, user search, post details, first-level comments, comment replies, public user info, user posts and authored replies, and video speech-to-text. It does not provide account login, posting, editing, liking, commenting, following, or other account actions.

Tools

When a post ID, post URL, username, or profile URL is already available, use the corresponding detail, comment, user, or user-post tool instead of searching again.

Quick Start

Use the hosted endpoint directly when the client supports authenticated streamable-http:

{
  "mcpServers": {
    "socialdatax-x": {
      "type": "streamable_http",
      "url": "https://mcp.socialdatax.com/x/mcp",
      "headers": {"Authorization": "Bearer <SOCIALDATAX_API_KEY>"}
    }
  }
}

For command/stdio-only clients, use npx -y mcp-remote https://mcp.socialdatax.com/x/mcp --header "Authorization: Bearer <SOCIALDATAX_API_KEY>". See the files in examples.

Request or manage API access at https://socialdatax.com/ai?from=github. Never commit a real API Key.

User reply results reuse the post fields, including post_id, text, author and reply_to_post_id. They include self-replies and exclude other authors’ conversation context. Continue with next_page_token even when the current page is empty; stop when the token is empty. Keep the user and lookup method unchanged. Tokens cannot be reused with user posts or other tools.

Gemini CLI extension

Install this service from its public GitHub repository:

gemini extensions install https://github.com/DevinChen2014/x-twitter-mcp

When prompted, enter your own SOCIALDATAX_API_KEY. Get a key from SocialDataX; business tool calls consume SocialDataX credits. The extension connects directly to the existing hosted MCP endpoint and does not include the private service implementation.

Verify the connection with gemini mcp list. To change the saved key, run:

gemini extensions config socialdatax-x