XMCP
XMCP is the official MCP server from X (formerly Twitter) that exposes over 200 X API endpoints as discoverable tools. It enables AI agents and assistants (Claude, Cursor, Gemini, etc.) to read tweets, search content, post updates, manage profiles, and more using the Model Context Protocol.
Overview
XMCP (repository: xdevplatform/xmcp) is the official Model Context Protocol (MCP) server released by the X Developer Platform. It turns the extensive X API into a set of clean, callable MCP tools, allowing AI agents to interact directly with X (formerly Twitter) in a standardized, secure way.
Built on FastMCP, XMCP automatically converts the X API OpenAPI specification into MCP tools. It supports reading timelines, searching posts, posting tweets, user lookups, engagement actions, and many more operations while excluding streaming and webhook endpoints for simplicity and security.
Key Features
- 200+ X API Endpoints: Comprehensive coverage including tweet creation, search, user profiles, timelines, likes, retweets, bookmarks, and more.
- FastMCP-Powered: Leverages the popular FastMCP framework for excellent developer experience and automatic schema generation.
- Official & Reliable: Maintained by X's own developer team with proper authentication handling.
- Local Deployment: Runs as a local MCP server for privacy and low latency.
- AI-Native Integration: Works seamlessly with Claude Desktop, Cursor, Gemini CLI, and other MCP clients.
- Pay-as-you-go API Compatibility: Aligns with X's updated developer pricing model.
How It Works
- Create an X Developer Platform app to obtain API credentials (Bearer token or OAuth).
- Install and run the XMCP server locally (Python 3.9+ required).
- Configure your MCP client (Claude, Cursor, etc.) to connect to the local server.
- AI agents can now call natural language tools such as "post a new tweet with this content" or "search for recent posts about MCP protocol".
The server handles authentication, rate limits, and response formatting transparently.
Use Cases
- AI Social Media Management: Let agents draft, schedule, and post content on X.
- Real-time Research: Search and analyze trends, user conversations, or competitor activity.
- Automated Engagement: Monitor mentions, reply to tweets, or manage community interactions.
- Content Curation: Build timelines, fetch user posts, or extract media from X.
- Multi-Agent Workflows: Combine with other MCP servers (research, image generation, etc.) for full social automation.
Getting Started
Prerequisites
- Python 3.9+
- X Developer Platform app with API keys
Installation & Run
git clone https://github.com/xdevplatform/xmcp.git
cd xmcp
pip install -r requirements.txt
# Set your X API credentials
python -m xmcp
Add the server to your MCP client configuration (typically http://127.0.0.1:port/mcp).
Full setup instructions, including credential configuration, are in the official repository README.
Additional resources: X Agent Resources
Benefits
As the official X MCP server, XMCP offers the most reliable and complete integration with the X platform. It eliminates the need for custom API wrappers and provides AI agents with native, production-grade access to X's capabilities through the standardized Model Context Protocol.
It represents X's commitment to the MCP ecosystem, making AI-powered social media automation accessible, secure, and developer-friendly.
Tags
Related Entries
Keep exploring similar tools and resources in this category.
Related Reads
Background, tutorials, and protocol context connected to this entry.
