X MCP Server

xtwittersocialsearchnewstrendsoauth

Summary

X's official hosted MCP server: search the full post archive, resolve users, read timelines and trends, manage bookmarks and draft articles from any MCP client.

Features

Hosted by X at https://api.x.com/mcp — nothing to deploy
Full-archive post search, plus user search and news search
Read user timelines, mentions, and post engagement (likers, reposters, quoters)
News stories and location-based trends
Bookmark management including folders
Draft and publish Articles
Two auth modes: app-only Bearer (read-only) or the xurl OAuth 2.0 PKCE bridge
Cannot post to the timeline — the Write API endpoints are not exposed

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "X MCP Server" tools will be available.

{
  "mcpServers": {
    "x-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@xdevplatform/xurl",
        "mcp",
        "https://api.x.com/mcp"
      ],
      "env": {
        "CLIENT_ID": "YOUR_X_APP_CLIENT_ID",
        "CLIENT_SECRET": "YOUR_X_APP_CLIENT_SECRET"
      }
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add x-mcp-server -e CLIENT_ID=YOUR_X_APP_CLIENT_ID -e CLIENT_SECRET=YOUR_X_APP_CLIENT_SECRET -- npx -y @xdevplatform/xurl mcp https://api.x.com/mcp

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "x-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@xdevplatform/xurl",
        "mcp",
        "https://api.x.com/mcp"
      ],
      "env": {
        "CLIENT_ID": "YOUR_X_APP_CLIENT_ID",
        "CLIENT_SECRET": "YOUR_X_APP_CLIENT_SECRET"
      }
    }
  }
}

Cursor

Same xurl bridge configuration as Claude Desktop.

{
  "command": "npx",
  "args": [
    "-y",
    "@xdevplatform/xurl",
    "mcp",
    "https://api.x.com/mcp"
  ],
  "env": {
    "CLIENT_ID": "YOUR_X_APP_CLIENT_ID",
    "CLIENT_SECRET": "YOUR_X_APP_CLIENT_SECRET"
  }
}

App-only Bearer alternative: point the client straight at the remote URL with an Authorization: Bearer YOUR_APP_ONLY_BEARER_TOKEN header. No bridge and no browser login, but read-only with no user context.

{
  "command": "remote",
  "args": [
    "https://api.x.com/mcp"
  ]
}

Description

X launched a hosted MCP server in June 2026, giving AI assistants a first-party route into the platform instead of the assortment of unofficial scrapers that preceded it. It is hosted by X at https://api.x.com/mcp, so there is no server to deploy — you point a client at the endpoint and authenticate.

The tool surface maps closely onto the X API. Posts covers fetching posts and the accounts that liked, reposted or quoted them, plus recent counts. Search is the valuable part: full-archive post search, user search and news search. Users resolves the authenticated account and looks up others by ID or handle, then reads their posts, timeline and mentions. Bookmarks can be listed, added, removed and organised into folders, and there are endpoints for news stories and location-based trends. Articles can be drafted and published.

Authentication comes in two flavours, and the choice determines what you can do. The simple route pastes an app-only Bearer token into an Authorization header on the MCP client — no bridge, no browser login, but read-only and with no user context. The full route runs the @xdevplatform/xurl bridge locally, which handles OAuth 2.0 PKCE login and refreshes tokens automatically; that is what unlocks user-context operations including the bookmark and article writes.

Worth knowing before you plan around it: the MCP tool is not wired to X's Write API endpoints, so it cannot post to the timeline autonomously. Bookmarks and article drafts are the extent of what it writes. Reading, searching and analysis are what it is genuinely for.

Access requires an X developer app, and the underlying X API tiers apply — the MCP layer itself is not separately priced. Best suited to research, social listening, trend monitoring and any agent that needs to ground its answers in what is actually being said on the platform right now.