X.com MCP Server

A Model Context Protocol server that provides access to X.com's API capabilities. This server enables LLMs to interact with X.com (formerly Twitter) through OAuth 2.0 authentication, supporting all major Post-related operations including reading, writing, searching, and managing posts, likes, retweets, and bookmarks.

Features

• OAuth 2.0 Authentication - Secure Bearer token authentication
• Complete Post API Coverage - All X.com Post endpoints from the official API
• Type Safety - Full TypeScript implementation with Zod validation
• Comprehensive Tools - 21 tools covering all major X.com operations

Available Tools

Lookup

• getSinglePost - Retrieve a single post by ID with optional field expansions
• getBulkPosts - Retrieve up to 100 posts by their IDs

Manage Posts

• createPost - Create a new post with text, media, polls, replies, etc.
• deletePost - Delete a post by ID
• hideReply - Hide or unhide a reply to a post

Timelines

• getUserTimeline - Get a user's timeline of posts
• getUserMentions - Get posts that mention a specific user

Search

• searchRecent - Search recent posts (last 7 days)
• searchAll - Search all posts (full archive - requires Academic/Enterprise access)

Post Counts

• getPostCountsRecent - Get time-bucketed post counts for recent posts
• getPostCountsAll - Get time-bucketed post counts for all posts (Academic/Enterprise)

Retweets

• getRetweets - Get posts that retweet a specific post
• createRetweet - Retweet a post
• deleteRetweet - Remove a retweet

Likes

• getLikingUsers - Get users who liked a specific post
• getLikedTweets - Get posts that a user has liked
• likePost - Like a post
• unlikePost - Unlike a post

Bookmarks

• getUserBookmarks - Get a user's bookmarked posts
• bookmarkPost - Bookmark a post
• removeBookmark - Remove a bookmark

Installation

Using pnpm (recommended)

pnpm install
pnpm run build

After installation, you can run it using:

node dist/index.js

Using Docker

docker build -t x.com-mcp .
docker run -i --rm -e X_COM_ACCESS_TOKEN=your-access-token x.com-mcp

Configuration

Environment Variables

• X_COM_ACCESS_TOKEN (required): Your X.com OAuth 2.0 access token

Authentication Setup

1. Create an X.com Developer Account at developer.x.com
2. Create a new project and app
3. Generate OAuth 2.0 credentials
4. Implement the OAuth 2.0 Authorization Code with PKCE flow
5. Store the resulting access token as X_COM_ACCESS_TOKEN

Configure for Claude.app

Add to your Claude settings:

"mcpServers": {
  "x-com": {
    "command": "node",
    "args": ["dist/index.js"],
    "env": {
      "X_COM_ACCESS_TOKEN": "your-access-token"
    }
  }
}

"mcpServers": {
  "x-com": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "-e", "X_COM_ACCESS_TOKEN=your-access-token", "x.com-mcp"]
  }
}

Example Interactions

1. Create a post:

{
  "name": "createPost",
  "arguments": {
    "text": "Hello world! This is my first post via the MCP server.",
    "reply_settings": "everyone"
  }
}

2. Search recent posts:

{
  "name": "searchRecent",
  "arguments": {
    "query": "artificial intelligence",
    "max_results": 10,
    "tweet.fields": "created_at,author_id,public_metrics"
  }
}

3. Get user timeline:

{
  "name": "getUserTimeline",
  "arguments": {
    "id": "123456789",
    "max_results": 20,
    "expansions": "author_id"
  }
}

4. Like a post:

{
  "name": "likePost",
  "arguments": {
    "user_id": "123456789",
    "tweet_id": "987654321"
  }
}

5. Get post counts:

{
  "name": "getPostCountsRecent",
  "arguments": {
    "query": "machine learning",
    "granularity": "day"
  }
}

API Endpoint

... View full README on GitHub