X(Twitter) MCP Server

What does “X(Twitter)” MCP Server do?

The X(Twitter) MCP Server is a Model Context Protocol (MCP) server designed to allow AI assistants and agents to create, manage, and publish posts to X (formerly known as Twitter) directly through chat environments such as Claude. By acting as a bridge between AI interfaces and the X/Twitter API, this server streamlines tasks such as posting tweets, managing drafts, and publishing threads. It enables developers and users to automate social media activities, integrate X/Twitter workflows into their development stack, and enhance productivity by eliminating the need for manual posting or separate tools. Its integration with MCP-compatible clients makes it an effective tool for workflow automation, content management, and social media interactions.

List of Prompts

No explicit prompt templates are listed in the repository.

List of Resources

No explicit resources are listed in the repository documentation or code.

List of Tools

No direct list of tools is found in the repository’s documentation or visible code files.

Use Cases of this MCP Server

• Automated Tweet Posting: Schedule or instantly publish tweets via AI assistants, ideal for marketing automation or content campaigns.
• Thread Creation and Publishing: Generate and post threads from chat, streamlining multi-part announcements or storytelling.
• Draft Management: Create, view, and publish draft tweets without leaving your AI chat interface.
• Social Media Integration for Apps: Integrate X/Twitter posting capabilities into custom workflows or internal tools for seamless user engagement.
• Content Moderation and Review: Enable teams to review, edit, and approve tweets via structured AI workflows before publishing.

How to set it up

Windsurf

No specific Windsurf instructions are provided.

Claude

1. Install UV:
   Install UV globally using Homebrew:
   brew install uv
2. Clone the Repository:
   git clone https://github.com/vidhupv/x-mcp.git
3. Create Configuration File:
   • For MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • For Windows: %APPDATA%/Claude/claude_desktop_config.json
4. Add MCP Server Configuration:

   {
     "mcpServers": {
       "x_mcp": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/x-mcp",
           "run",
           "x-mcp"
         ],
         "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"
         }
       }
     }
   }
   

5. Set Up X/Twitter API Credentials:
   • Create a project at X API Developer Portal
   • Set permissions, callback URL, and generate keys
6. Restart Claude:
   Fully quit and reopen Claude to apply changes.

Securing API Keys

API keys are stored in the env object of the configuration JSON.
Example:

"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"
}

Cursor

No specific Cursor instructions are provided.

Cline

No specific Cline instructions are provided.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "x_mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “x_mcp” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Based on the available documentation and code, X(Twitter) MCP Server provides solid setup instructions for Claude and clearly covers API key management. However, it lacks explicit documentation on resources, tools, and prompt templates. Overall, this MCP is functional but lacks depth in documentation and feature transparency.

MCP Score