X (Twitter) MCP Server

Overview

The X (Twitter) MCP Server bridges AI models and the X platform by letting language models (LLMs) perform comprehensive X operations directly. It's part of the Model Context Protocol (MCP) system, providing a safe and standard way to connect AI with X platform functionalities.

Key Features

Available Tools

Quick Reference

Detailed Usage

use_mcp_tool({
  server_name: "x-twitter",
  tool_name: "post_tweet",
  arguments: {
    text: "Hello from AI-powered MCP server!"
  }
});

use_mcp_tool({
  server_name: "x-twitter",
  tool_name: "search_tweets",
  arguments: {
    query: "AI MCP server",
    count: 10
  }
});

use_mcp_tool({
  server_name: "x-twitter",
  tool_name: "get_profile",
  arguments: {
    screen_name: "Dishant27"
  }
});

use_mcp_tool({
  server_name: "x-twitter",
  tool_name: "create_list",
  arguments: {
    name: "AI Tools",
    description: "Curated list of AI tool developers",
    is_private: false
  }
});

Installation

The README documents install from source; no npm package or Docker image is published for it.

git clone https://github.com/Dishant27/twitter-mcp.git
cd twitter-mcp
npm install && npm run build

Then point your client at the built entry point:

{
  "mcpServers": {
    "x-twitter": {
      "command": "node",
      "args": ["/absolute/path/to/twitter-mcp/dist/index.js"],
      "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"
      }
    }
  }
}

All four environment variables are required; the server exits at startup if any is missing. Node.js 18 or higher is required. To use npm start instead, run it from inside the cloned repository, where it loads the same variables from the environment or a .env file.

Sources

• https://github.com/Dishant27/twitter-mcp