Skip to content
X MCP Server

X MCP Server

Released
5 views

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.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it, filling in the environment variables with your own values.
  3. 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"
      }
    }
  }
}

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.

Related MCP Servers

Featured

X's own hosted MCP server: full-archive post search, user and timeline lookup, trends, bookmarks and article drafting, under your account's permissions.

15 views
Featured

Apify's official MCP server — turn thousands of ready-made scrapers into tools your assistant can call.

2 views

MCP: Browserbase

by Browserbase

Featured

Browserbase's official MCP server — cloud browser automation with Stagehand's natural-language actions.

3 views
Browse all MCP servers →