XMCP
A comprehensive MCP server for X/Twitter featuring over 70 tools for research, engagement, and publishing with granular permission-based access control. It includes specialized Playwright-powered tools for fetching X articles and supports extensive a
What is XMCP?
XMCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to comprehensive mcp server for x/twitter featuring over 70 tools for research, engagement, and publishing with granular permission-based access control. it includes specialized playwright-powered tools ...
A comprehensive MCP server for X/Twitter featuring over 70 tools for research, engagement, and publishing with granular permission-based access control. It includes specialized Playwright-powered tools for fetching X articles and supports extensive a
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A comprehensive MCP server for X/Twitter featuring over 70 t
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx xmcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use XMCP
XMCP is a comprehensive MCP server for X (formerly Twitter) that exposes over 70 tools covering research, engagement, publishing, list management, and direct messaging. It uses the official Twitter API v2 and includes Playwright-powered tools for fetching full X article content that is normally behind a soft paywall. A built-in permission profile system (researcher, creator, manager, automation, custom) lets you grant only the tool subset appropriate for a given workflow — for example, a read-only research profile versus a full automation profile that can post, DM, and manage lists.
Prerequisites
- Python 3.8 or later and pip
- Playwright installed for article-fetching tools: `python -m playwright install chromium`
- A Twitter Developer account with an app that has OAuth 1.0a and Bearer token credentials
- The five Twitter API credentials: TWITTER_API_KEY, TWITTER_API_SECRET, TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_TOKEN_SECRET, TWITTER_BEARER_TOKEN
- An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
Install XMCP with article support
Install directly from the GitHub repository with the optional articles extra to include Playwright-powered article fetching.
pip install "xmcp[articles] @ git+https://github.com/vibeforge1111/xmcp.git"Install Playwright browser
The article-fetching tools require a Chromium browser managed by Playwright.
python -m playwright install chromiumGather your Twitter API credentials
Log in to developer.twitter.com, create or select an app, and copy all five credential values. Your app needs Read and Write permissions (and Direct Messages if you want DM tools).
Add XMCP to your MCP client config
Add the server to your claude_desktop_config.json with all five credential environment variables and your chosen permission profile.
{
"mcpServers": {
"xmcp": {
"command": "python",
"args": ["-m", "xmcp"],
"env": {
"TWITTER_API_KEY": "your_api_key",
"TWITTER_API_SECRET": "your_api_secret",
"TWITTER_ACCESS_TOKEN": "your_access_token",
"TWITTER_ACCESS_TOKEN_SECRET": "your_access_token_secret",
"TWITTER_BEARER_TOKEN": "your_bearer_token",
"X_MCP_PROFILE": "researcher"
}
}
}
}Restart your MCP client and verify the tools
Restart Claude Desktop or your MCP host. With the researcher profile, 23 read-only tools will be available. Switching to 'automation' exposes all 70+ tools.
XMCP Examples
Client configuration
Full claude_desktop_config.json for XMCP using the creator profile (41 tools including posting and engagement).
{
"mcpServers": {
"xmcp": {
"command": "python",
"args": ["-m", "xmcp"],
"env": {
"TWITTER_API_KEY": "your_api_key",
"TWITTER_API_SECRET": "your_api_secret",
"TWITTER_ACCESS_TOKEN": "your_access_token",
"TWITTER_ACCESS_TOKEN_SECRET": "your_access_token_secret",
"TWITTER_BEARER_TOKEN": "your_bearer_token",
"X_MCP_PROFILE": "creator"
}
}
}
}Prompts to try
Sample prompts covering research, publishing, and engagement use cases.
- "Search for tweets about Model Context Protocol and summarise the top 10 results"
- "Get the current trending topics in the United States"
- "Post a tweet: 'Just shipped a new MCP server for X/Twitter — check it out!'"
- "Create a thread of 5 tweets explaining the basics of the Rust programming language"
- "Fetch and summarise the full article from this X link: https://x.com/user/status/123"
- "Get my last 20 bookmarks and list the ones related to AI"Troubleshooting XMCP
401 Unauthorized errors when calling Twitter API tools
Double-check all five credential environment variables. Ensure TWITTER_ACCESS_TOKEN and TWITTER_ACCESS_TOKEN_SECRET belong to the account you want to act as (not just the developer app). Regenerate tokens in the Twitter Developer Portal if needed.
Article fetching tools fail or return empty content
Ensure Playwright Chromium is installed: run `python -m playwright install chromium`. If Playwright is installed but still failing, the headless browser may be blocked — try running the server on a different network or disable any VPN.
Tools are missing — expected tools don't appear in the MCP client
Check the X_MCP_PROFILE value. The 'researcher' profile only exposes 23 read-only tools. Switch to 'creator' (41 tools), 'manager' (55), or 'automation' (70+) to unlock additional capabilities. You can also use X_MCP_ENABLED_TOOLS to enable individual tools by name.
Frequently Asked Questions about XMCP
What is XMCP?
XMCP is a Model Context Protocol (MCP) server that comprehensive mcp server for x/twitter featuring over 70 tools for research, engagement, and publishing with granular permission-based access control. it includes specialized playwright-powered tools for fetching x articles and supports extensive a It connects AI assistants to external tools and data sources through a standardized interface.
How do I install XMCP?
Follow the installation instructions on the XMCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with XMCP?
XMCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is XMCP free to use?
Yes, XMCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
XMCP Alternatives — Similar Communication Servers
Looking for alternatives to XMCP? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up XMCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use XMCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.