sakutto
Generative AI

What Is the Official X MCP Server? Let Claude & Grok Use the X API

XMCPModel Context ProtocolAPI Integration
What Is the Official X MCP Server? Let Claude & Grok Use the X API

What the official X MCP server is

The two servers in the official docs

X MCP
api.x.com/mcp. X API calls such as searching posts, looking up users, bookmarks, trends, and news
Docs MCP
docs.x.com/mcp. Searches X's developer documentation

The official X MCP server is a "gateway" that X built to connect AI tools to the X API. MCP (Model Context Protocol) is a common standard for connecting AI tools to external services; through a server that follows it, a compatible AI tool can call a service's features via a defined procedure. For the bigger picture on connecting AI tools to external services, see our guide to the ChatGPT Slack connector.

Two servers (X MCP and Docs MCP)

The official docs describe two servers with different purposes. "X MCP" (api.x.com/mcp) handles X API calls like searching posts and looking up users, while "Docs MCP" (docs.x.com/mcp) searches the developer documentation.

View official source →
"call X API endpoints (search posts, look up users, bookmarks, trends, news, Articles, and more)" / "Docs MCP (https://docs.x.com/mcp) provides documentation search capabilities with tools like search_x and get_page_x." — from the X MCP docs

You fetch real data with X MCP and look up how to use it with Docs MCP — the roles are split.

Connecting to the X API without your own server

Until now, using the X API from an AI tool meant building, hosting, and authenticating your own MCP server. Because X hosts the server this time, that work goes away. The design lets a user run tools with their own account permissions through a local bridge. (The framing that developers no longer need their own integration comes from reporting such as TechCrunch.)

View official source →
"The bridge authenticates as you (PKCE flow), so tools act with your account's scopes." — from the X MCP authentication section

Authentication and write limitations

Two authentication paths

OAuth (PKCE)
Uses a bridge and acts with the user's account scopes; can also perform actions like bookmarks
Bearer token
For read endpoints; connects directly with a static App-only token

The MCP server is powerful, but it can't do everything. Understanding the authentication and the write limits helps you use it safely.

Account-scoped OAuth and a read-only token

There are two authentication paths. The OAuth (PKCE) flow acts as you, so tools operate within your account's scopes. If read-only is enough, you can skip the bridge and connect directly with a static App-only Bearer token.

View official source →
"The bridge authenticates as you (PKCE flow), so tools act with your account's scopes." / "For read endpoints, you can skip the bridge and point a client straight at the URL with a static App-only Bearer token." — from the X MCP authentication section

Depending on the task, you can use OAuth for write-bearing actions and a token for read-only access.

You can't post (read-centric)

One thing to note on permissions is posting. According to TechCrunch, the MCP tool is not compatible with X's Write API, so you can't have an AI post autonomously. In other words, the expectation is "read-centric" use focused on search and data retrieval. In practice, it's safest to assume it's not suited to proactive posting.

Supported clients and where to use it

Clients with setup instructions

Clients
Grok Build, Cursor, Claude Desktop, VS Code (GitHub Copilot), and MCP-compatible tools in general
Good for
Retrieving and analyzing X data — searching posts, gathering trends, analyzing users

Finally, here is which tools can use it and what tasks it suits.

Use it from Grok, Cursor, Claude Desktop, and more

The official docs provide setup instructions for major MCP-compatible clients, including Grok Build, Cursor, Claude Desktop, and VS Code (GitHub Copilot). If your AI tool supports MCP, you can connect it straight to X's gateway. The benefit is being able to work with X's data from the tools you already use, including Claude.

What it suits

It suits "fetch and analyze" work with X data. Searching posts, gathering trends and news, and looking up specific users can all be done within your AI tool's conversation. Proactive posting, on the other hand, is not expected via MCP for now, so you'll need a separate approach for that.

When passing collected web pages or posts to an AI as long text, converting them to Markdown first keeps their structure intact and tends to improve summary and analysis quality.

Free ToolURL to Markdown ConverterConvert any public web page URL to Markdown. Preserves headings, tables, lists, and links — perfect for LLM and RAG preprocessing, research notes, and archiving web articles.Try it now →

FAQ

Q. What is the official X MCP server?
It is a hosted MCP (Model Context Protocol — a common standard for connecting AI tools to external services) server provided by X. AI tools like Grok and Cursor can connect to the X API and X's developer docs through it.
X Official Docs — MCP
call X API endpoints (search posts, look up users, bookmarks, trends, news, Articles, and more) X Official Docs — MCP
Q. Can I use it without hosting my own MCP server?
Yes. Because X hosts the server, you can connect to the X API with your own account permissions without building, hosting, and authenticating your own MCP server (this framing comes from reporting such as TechCrunch).
X Official Docs — MCP
The bridge authenticates as you (PKCE flow), so tools act with your account's scopes. X Official Docs — MCP
Q. Can the MCP server post to X?
No. According to TechCrunch, the MCP tool is not compatible with X's Write API, so it cannot be used to post autonomously. It is designed for read-centric use.
X Official Docs — MCP
For read endpoints, you can skip the bridge and point a client straight at the URL with a static App-only Bearer token. X Official Docs — MCP

Related Tools

Related Tool Categories

Articles